Vous êtes sur la page 1sur 318

Tutorial do E3 para Desenvolvedores

2011 Elipse Software Ltda. Todos os direitos reservados. 16/08/2011 - Verso 3.5

Sumrio
1 Apresentao 1.1 A Elipse 1.2 Mdulos do E3 1.3 O Treinamento 1.4 Anotaes 2 Elipse Knowledgebase 2.1 Elipse Knowledgebase 2.2 Busca no Knowledgebase 2.3 Categorias 2.4 Anotaes 3 Iniciando a Aplicao 3.1 Criando a Aplicao 3.2 Execuo de um Domnio 3.3 Exerccios 3.4 Exerccios Complementares 3.5 Anotaes 4 Servidor de Dados 4.1 Regras para Nomes de Tags 4.2 Exerccios 4.3 Anotaes 5 Telas e Quadros 5.1 Tela 5.2 Quadros 5.3 Viewer 5.4 Exerccios 5.5 Anotaes 6 Objetos de Tela 6.1 Controles Microsoft Forms 6.2 Galeria 6.3 Exerccios 6.4 Exerccios Complementares 6.5 Anotaes 7 Associaes 7.1 Tipos de Associao 7.2 Valores Booleanos 7.3 Exerccios 7.4 Anotaes 8 Comunicao 8.1 Driver de Comunicao 8.2 Driver de Comunicao OPC 8.3 Exerccios Complementares 8.4 Anotaes 7 7 8 9 14 15 16 16 17 19 20 21 25 26 27 28 29 30 30 35 36 36 37 39 41 46 47 47 48 49 55 56 57 58 64 65 71 72 72 77 81 83

9 Importao e Exportao 9.1 Arquivo CSV 9.2 Gerenciador de Modelos 9.3 Exerccios 9.4 Anotaes 10 Bibliotecas ElipseX 10.1 Criao de Bibliotecas do Usurio 10.2 Quando Criar um ElipseX 10.3 Exerccios 10.4 Exerccios Complementares 10.5 Anotaes 11 Scripts 11.1 Definindo Scripts 11.2 Eventos 11.3 Mtodos 11.4 Propriedades 11.5 Exerccios 11.6 Exerccios Complementares 11.7 Anotaes 12 Segurana 12.1 Usurios 12.2 Grupos 12.3 Permisses 12.4 Proteo 12.5 Exerccios 12.6 Exerccios Complementares 12.7 Anotaes 13 Banco de Dados 13.1 Exerccios 13.2 Exerccios Complementares 13.3 Anotaes 14 Alarmes 14.1 Servidor de Alarmes 14.2 Configurao de Alarmes 14.3 E3Alarm 14.4 Exerccios 14.5 Exerccios Complementares 14.6 Anotaes 15 Consultas 15.1 Criando uma Consulta 15.2 E3Browser 15.3 Exerccios 15.4 Exerccios Complementares 15.5 Anotaes 16 Histricos

84 84 85 88 90 91 92 96 96 104 107 108 108 117 119 120 120 123 124 125 126 127 128 130 132 134 139 140 140 146 147 148 148 148 154 155 163 165 166 167 170 171 177 178 179

16.1 Chave Primria 16.2 ndices 16.3 Exerccios 16.4 Exerccios Complementares 16.5 Anotaes 17 E3Chart 17.1 Configuraes das Penas 17.2 Exerccios 17.3 Exerccios Complementares 17.4 Anotaes 18 Relatrios 18.1 Objetos do Relatrio 18.2 Exerccios 18.3 Exerccios Complementares 18.4 Anotaes 19 Storage 19.1 Funcionamento 19.2 Configurao 19.3 Consultas Internas 19.4 Exerccios 19.5 Exerccios Complementares 19.6 Anotaes 20 Biblioteca Pen Group 20.1 Funcionamento 20.2 Banco de Dados PenGroup 20.3 Configurando a Biblioteca para o E3 20.4 Relatrios 20.5 Exerccios 20.6 Exerccios Complementares 20.7 Anotaes 21 E3Playback 21.1 Interface de Usurio do E3Playback 21.2 Restries e Comentrios 21.3 Licenciamento 21.4 Exerccios 21.5 Exerccios Complementares 21.6 Anotaes 22 Event Log Viewer 22.1 Configurao do Armazenamento de Arquivos 22.2 Abertura de Arquivos 22.3 Merge de Eventos 22.4 Filtros 22.5 Exerccios 22.6 Anotaes 23 E3 Tweak

179 180 181 183 184 185 186 188 194 196 197 199 200 208 211 212 212 213 214 216 219 220 221 221 223 227 228 231 233 234 235 235 238 240 240 242 243 244 244 245 246 247 250 251 252

23.1 Configuraes do E3 Server 23.2 Configuraes do E3 Run 23.3 Configuraes do REC 23.4 Configuraes dos Logs 23.5 Configuraes do COM Filter 23.6 Exerccios 23.7 Anotaes 24 E3 WebViewer 24.1 Aplicaes E3 na Web 24.2 Arquivos E3Web.asp e DocWrite.asp 24.3 Configurando o Internet Information Services 24.4 Questes de Licenciamento 24.5 Exerccios 24.6 Exerccios Complementares 24.7 Anotaes 25 Hot-Standby 25.1 Configuraes do Hot-Standby 25.2 Exerccios 25.3 Exerccios Complementares 25.4 Anotaes 26 Domnios Remotos 26.1 Configurao no E3 Studio 26.2 Compartilhamento da Pasta do Domnio Servidor 26.3 Licenas 26.4 Sintaxe dos Links 26.5 Alias Local 26.6 Permisses de Acesso 26.7 Exerccios 26.8 Exerccios Complementares 26.9 Anotaes 27 Exerccios de Reviso 27.1 Exerccio 27.2 Resoluo 27.3 Anotaes

252 253 253 254 254 254 255 256 256 261 262 277 277 278 279 280 280 284 287 288 289 289 290 296 296 296 298 298 303 304 305 305 308 317

CAPTULO

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

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

Apresenta o

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 processamento entre as mquinas. Foi desenvolvido para ser executado sobre os sistemas operacionais Windows XP, 2003, Vista e Windows 7.

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.

Apresenta o

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 Tutorial uma aplicao hipottica, que apresenta os recursos mais importantes do software E3. Essa aplicao hipottica no cobre todas as possibilidades de desenvolvimento oferecidas pela ferramenta. No entanto, a quantidade e a qualidade das informaes apresentadas neste primeiro contato com o software so suficientes para que voc aprenda a utiliz-lo com autonomia para criar suas prprias aplicaes. A sequencia do treinamento a seguinte: Apresentao da ferramenta. Telas e Objetos de Tela: como criar interfaces grficas para suas aplicaes. Uso de Associaes: um modo fcil e efetivo de mostrar informaes ou criar animaes em Telas. Comunicao de dados: uso de Drivers e uso de OPC. Uso de Bibliotecas ElipseX: poderosa ferramenta de bibliotecas funcionais disponvel apenas no E3. Integrao com Bancos de Dados: uso de funes e ferramentas para acesso e consulta a Bancos de Dados, com foco em processos. Alarmes: uso e controle de Alarmes no E3. Relatrios: poderosa ferramenta incorporada ao E3. Traz facilidade e grande quantidade de recursos para a criao de relatrios. Recursos Avanados: redundncia, acesso ao aplicativo atravs de browser, configuraes de segurana de usurios, entre outros.

Apresenta o

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 mostrar condies de alarme no caso de algum parmetro ultrapassar os limites estabelecidos (como por exemplo, um aumento excessivo de temperatura).

Alarmes

10

Apresenta o

Existir um procedimento de consulta dos alarmes, que permite visualizao e impresso dos dados de histricos.

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 Utilizaremos uma ferramenta de consulta de dados e exibio de grficos que permite uma interface mais poderosa de anlise para o usurio final, o PenGroup.

Apresenta o

11

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

Domnio Remoto 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. 12 Apresenta o

A Elipse Software deseja a voc um timo treinamento, e uma boa experincia de trabalho com o E3!

Apresenta o

13

1.4 Anotaes

14

Apresenta o

CAPTULO

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

Pgina inicial do KB

Elipse Know ledgebase

15

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 da Elipse.

2.2 Busca no Knowledgebase


Este campo busca em toda a base de dados pela palavra ou palavras que o usurio digitar, retornando todos os artigos que possuem a palavra alvo da busca. Basta digitar a palavra que se deseja buscar e ento apertar o boto Busca.

Busca no KB Ainda existe a possibilidade de utilizar a Busca Avanada, que permite refinar a consulta. Basta acessar a opo Busca Avanada.

Busca Avanada

16

Elipse Know ledgebase

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 Todos os artigos desta categoria sero retornados como resultado da busca. importante ressaltar que toda a base de conhecimento est dividida em duas categorias principais, Ingls e Portugus. Dentro delas existem as categorias Elipse E3, Elipse SCADA, Elipse 21 DOS, Elipse Drivers OPC, Altus TCP/IP e Drivers. Dentro destas cinco categorias existem diversas outras, cada uma delas tratando de um tema especfico. Acessando os artigos pela categoria Portugus - Elipse E3 tem-se:

Elipse Know ledgebase

17

Categorias em portugus Note que dentro de cada uma destas subcategorias aparece um nmero. Este nmero indica a quantidade de artigos existentes dentro da categoria. As demais sees existentes na pgina principal do Knowledgebase so: Artigos Em Destaque: Mostra todos os artigos que esto classificados para aparecerem em destaque. Normalmente esta seo utilizada para ressaltar algum artigo que merece uma ateno especial por parte dos usurios dos softwares da Elipse. Artigos Mais Lidos: Mostra a lista dos 10 artigos mais lidos no Knowledgebase. ltimos Artigos Adicionados: Mostra a lista dos ltimos 10 artigos que foram adicionados na base de dados do Knowledgebase. Buscas Mais Utilizadas: Mostra as 10 palavras que mais foram utilizadas como busca pela ferramenta de busca do Knowledgebase.

18

Elipse Know ledgebase

2.4 Anotaes

Elipse Know ledgebase

19

CAPTULO

Iniciando a Aplicao
Aps instalar o software, voc ter em sua mquina um grupo de programas chamado Elipse E3, com um cone para acessar o E3 Studio. Quando o E3 iniciado, o sistema abre uma caixa de dilogo com algumas opes do projeto.

Caixa de dilogo inicial do E3 Studio As opes disponveis so: Opes disponveis na caixa de dilogo inicial do E3 OPO Iniciar o E3 Studio DESCRIO Inicia o E3 Studio, mas no abre nenhum Domnio.

20

Inic iando a Aplic a o

Criar um Domnio novo Abrir um Domnio existente

Cria um novo Domnio atravs do Assistente de aplicaes do E3. Sero requisitados o nome e caminho do novo Domnio. Abre um Domnio existente dentre os ltimos editados. Clicando em Outros arquivos, pode-se localizar um Domnio em um diretrio especfico.

3.1 Criando a Aplicao


Para criar uma nova aplicao, utilize o Assistente de Aplicaes. Para acess-lo, clique no boto Novo na barra de ferramentas Padro.

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

Inic iando a Aplic a o

21

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.3 Configurao do Domnio


Armazena quatro tipos de informaes: opes de configurao do Domnio, lista de arquivos .prj e .lib, configuraes dos servidores que iro rodar o Domnio e configuraes de segurana (usurios e permisses). Sem esse arquivo, um projeto no pode ser executado no E3. Esse item ser visto mais adiante.

22

Inic iando a Aplic a o

3.1.4 Organizer
O Organizer permite uma viso simples e organizada de toda a sua aplicao, ajudando na edio e configurao de todos os objetos envolvidos no sistema atravs de uma rvore hierrquica de opes. Possui dois modos de visualizao, Domnio e Explorer.

Inic iando a Aplic a o

23

Janela do Organizer em modo Domnio O modo Domnio mostra apenas as informaes dos objetos abertos pertencentes ao Domnio, organizadas em quatro grupos, Configurao, Bibliotecas de Objetos, Visualizao e Objetos de Servidor. O modo Explorer mostra projetos e bibliotecas abertos no E3 Studio, pertencentes ou no ao Domnio. Os objetos so mostrados no projeto ou biblioteca ao qual 24 Inic iando a Aplic a o

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 a sua configurao de forma simples e rpida. Sempre que uma propriedade for configurada na Lista de Propriedades, seu valor no ser mudado automaticamente, a menos que se construa uma associao (que ser vista mais adiante). A Lista de Propriedades pode ser acessada pelo menu Visualizar - Lista de Propriedades ou pelo boto na Barra de Ferramentas.

Lista de Propriedades

3.2 Execuo de um Domnio


Para executar ou visualizar um projeto no E3, necessrio que o Domnio seja colocado em execuo. Para isso, existem os seguintes botes no E3 Studio: Executar aplicativo: Salva todas as configuraes dos projetos e bibliotecas, e executa o Viewer. 25

Inic iando a Aplic a o

Rodar/Parar Domnio: Inicia ou para a execuo do Domnio. Executar/Parar o E3 Viewer: Executa o Viewer ou para a sua execuo.

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

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

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

26

Inic iando a Aplic a o

mesmo nome do projeto. 5. Escolha a resoluo da tela.

Resoluo do Viewer 6. Responda No s perguntas sobre comunicao, banco de dados e alarmes. 7. Ao fim destes procedimentos, voc ter acesso rea de trabalho do Studio.

3.4 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

3.4.1 KB
KB-28984: Qual o tempo de execuo do Domnio e comunicao do E3 com uma licena somente Studio?

Inic iando a Aplic a o

27

3.5 Anotaes

28

Inic iando a Aplic a o

CAPTULO

Servidor de Dados
O Servidor de Dados o mdulo responsvel pela execuo e gerenciamento de tags e objetos que no estejam envolvidos diretamente com a comunicao. Atravs do Servidor de Dados pode-se configurar tags internos e tags de simulao, alm de inserir XObjects, que so os objetos de dados das bibliotecas ElipseX (vistas mais adiante). Alguns dos objetos que podem ser inseridos no Servidor de Dados so os seguintes: Objetos que podem ser inseridos no Servidor de Dados OBJETO Tag Contador DESCRIO Objeto que faz a contagem de tempo (em segundos) at atingir um valor pr-determinado, ou que faz uma certa contagem indefinidamente. Objeto que gera valores de acordo com a forma de onda. utilizado para simulao de valores. Permite gerar curvas definidas ou valores aleatrios. Objeto de propsito genrico, utilizado para guardar valores de qualquer tipo, incluindo nmeros, textos e outros objetos. Objeto para contagem de tempo e programao de atividades. Estabelece horrios, com repeties, para executar aes.

Tag Demo Tag Interno Tag Timer

Pasta de Define grupos e subdiretrios para a organizao das informaes. Novas pastas podem ser inseridas dentro de outras, conforme a Dados necessidade.

NOTA: Os objetos inseridos no Servidor de Dados sero executados pelo E3 Server, portanto estaro presentes no Servidor. Esta informao retrata o modo como o E3 trabalha.

Servidor de Dados

29

4.1 Regras para Nomes de Tags


Ao especificar o nome dos tags, alguns detalhes devem ser levados em conta: O nome do tag no pode ser estritamente numrico. O nome do tag no pode conter operadores lgicos ou aritmticos: (/ * + -) O nome da varivel no pode conter caracteres reservados: / ? . , { } [ ] - etc. Esses caracteres so trocados pelo caractere sublinhado. Assim, o sistema aplica a Regra dos Colchetes, explicada a seguir.

4.1.1 Regra dos Colchetes


Ao fazer referncia a um objeto por script ou ao us-lo em alguma associao, deve-se levar em conta as seguintes regras: Se o primeiro caractere no for uma letra ou um caractere sublinhado, o nome deve estar entre colchetes. Se algum dos demais caracteres (do segundo em diante) no for uma letra, um nmero ou um caractere sublinhado, o nome tambm deve estar entre colchetes. Caso existam caracteres especiais (por exemplo, acentos), o nome deve estar entre colchetes.

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

4.2.1 Horrio do Sistema


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

30

Servidor de Dados

Inserir Tag Demo

4.2.2 Simulao de Valores


Muitas vezes precisamos de valores que simulem os movimentos. Normalmente esses valores so reais e vem de Tags de Comunicao, mas nos exerccios do Tutorial usaremos tags do tipo Demo. 1. Na pasta Dados insira os Tags Demo com as seguintes propriedades configuradas: NAME Nivel1 DOCSTRING Nivel do Tanque1 Nivel do MINIMUM 0 MAXIMUM 100 PERIOD SCAN 2000 200 TYPE 0 - Random

Nivel2

100

2000

200

0 - Random

Servidor de Dados

31

Tanque2 Temp1 Temperatura do 20 Tanque1 Temperatura do 20 Tanque2 80 20000 500 1 - Sine

Temp2

80

10000

500

0 - Random

4.2.3 Tanques
A aplicao representa uma fbrica que utiliza como matria-prima as tintas vermelha, verde e azul, produzindo as demais tintas como combinao dessas trs. 1. Na pasta Dados crie uma Pasta de Dados chamada Tanque1 e insira trs tags Internos, Vermelho, Verde e Azul. 2. Configure valor inicial dos trs tags para Integer.

32

Servidor de Dados

Selecionar tipo de dado 3. Crie uma cpia da pasta Tanque1 para criar o Tanque2.

Servidor de Dados

33

Pastas de Dados

34

Servidor de Dados

4.3 Anotaes

Servidor de Dados

35

CAPTULO

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

5.1 Tela
A Tela o objeto bsico de interface com o usurio. Nela podem-se inserir os seguintes objetos: Primitivas do editor grfico (retas, crculos, retngulos, polgonos, etc.) Controles ActiveX fornecidos pela Elipse (E3Alarm, E3Chart, E3Browser) Controles ActiveX fornecidos por terceiros Imagens no vetoriais (Arquivos BMP, JPG, GIF, etc.) Imagens vetoriais (Arquivos WMF, EMF, etc.) Controles padro do Windows (Lista, Editor de Texto, Lista de Seleo, etc.) Bibliotecas grficas do E3 (XControl) compostas de quaisquer objetos acima As Telas utilizam como padro para o tamanho e coordenadas as unidades Himetric, dadas em 1/100 mm, no em pixels. Neste sistema, ao se adicionar um valor positivo em x, a coordenada x move-se para a direita. Quando se adiciona um valor positivo em y, a coordenada y move-se para baixo, sendo a origem dada pelo canto superior esquerdo da Tela. As Telas podem ser abertas em modo Full-Screen, ocupando toda a rea do Viewer, ou ainda como telas modais, ocupando somente o tamanho de suas coordenadas de altura e de largura. 36 Telas e Quadros

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). Telas e Quadros 37

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

38

Telas e Quadros

5.3 Viewer
O objeto Viewer configura o modo como o E3 Viewer ser visualizado. O E3 Viewer pode ser rodado a partir de qualquer ponto da rede que tenha acesso ao E3 Server. No necessrio copiar o aplicativo para as mquinas onde os E3 Viewers sero executados, pois as Telas e bitmaps so trazidos do servidor conforme a necessidade, em tempo de execuo.

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

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

Aba Visualizador

Telas e Quadros

39

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.

40

Telas e Quadros

Aba Erros de Comunicao NOTA: Tambm possvel inserir tags no Viewer.

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

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

Telas e Quadros

41

Dividir Horizontalmente 3. Posicione a barra que aparece a cerca de 10% da Tela, a partir de seu limite superior, e pressione o boto esquerdo do mouse para fixar a posio da barra. 4. Configure o tamanho do Divisor para 100 px na propriedade SplitValue. 5. Chame a Diviso criada de Header. Para trocar o nome de um objeto, existem trs opes: Selecione o objeto no Organizer e pressione a tecla F2. Ser habilitada a edio do nome. Selecione o objeto no Organizer e, na Lista de Propriedades do objeto, altere a propriedade Name. Clique com o boto direito sobre o objeto no Organizer e selecione a opo Renomear. 6. Divida horizontalmente o Quadro inferior a cerca de 10% da Tela a partir do limite inferior. Chame as Divises de Central e Footer.

Divises do Quadro 7. Configure o Divisor Footer como Principal. Isso faz com que o E3 obedea ao tamanho do Divisor e o restante da Tela ser o tamanho do Divisor Central. Clique com o boto direito no Footer e escolha a opo Configurar como Divisor Principal.

42

Telas e Quadros

Configurar Divisor Principal 8. Configure o tamanho do Divisor Footer como 100px (propriedade SplitValue).

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

Inserir Tela 2. Escolha na lista de seleo o Divisor Header. 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

43

Tamanho da Tela 3. Crie a TelaAlarmes para ser aberta no Divisor Footer. Marque a opo Configurar como Tela inicial do Divisor. 4. Para ser aberto no Divisor Central, crie as Telas TelaSinotico, TelaEventos, TelaGrafico, Comunicacao, TelaPenGroup e TelaRemota. A TelaSinotico deve ser marcada como Tela Inicial do Divisor. 5. Uma tela janelada ser utilizada para comandar as bombas. Crie uma tela chamada TelaComando com o tamanho de 200 x 200 pixels. 6. Crie uma tela para ser aberta no Viewer.[_top] chamada TelaPlayBack. Essa ser uma tela cheia.

44

Telas e Quadros

5.4.3 Tela Inicial da Aplicao


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

Propriedades do Viewer 2. Execute a aplicao pressionando o boto na Barra de Ferramentas.

Telas e Quadros

45

5.5 Anotaes

46

Telas e Quadros

CAPTULO

Objetos de Tela
Os Objetos de Tela so elementos grficos que podem ser inseridos nas Telas para criar a interface visual com o processo. Podem ser criados a partir da barra de ferramentas Objetos ou atravs do menu Objetos. Uma vez selecionado o objeto que se deseja criar, mantenha o boto esquerdo do mouse pressionado na rea da Tela, enquanto movimenta o mouse (um retngulo pontilhado mostra o tamanho e a forma do objeto). Ao soltar o boto, o objeto ser posicionado dentro da rea especificada.

6.1 Controles Microsoft Forms


Os objetos Microsoft Forms so componentes de software baseados na tecnologia COM (Component Object Model) da Microsoft. O E3 instala e utiliza os controles Microsoft Forms, que so objetos ActiveX criados pela Microsoft. Eles podem ser inseridos nas telas da aplicao para realizar diversas tarefas. A seguir temos a descrio dos objetos Microsoft Forms. Controles Microsoft Forms CONE OBJETO Caixa de Seleo (Check Box) DESCRIO Utilizado para dar ao usurio uma escolha entre dois valores, tais como Sim e No, True e False ou On e Off. Utilizado para mostrar se um item individual de um grupo est selecionado. Utilizado para executar uma ao especfica ao pression-lo. Utilizado para exibir um texto descritivo, como ttulos, legendas, etc. Exibe uma lista de valores.

Boto de Opes (Option Button) Boto de Comando (Command Button) Texto (Label)

Lista (List Box)

Objetos de Tela

47

CONE

OBJETO Barra de Rolagem (Scroll Bar)

DESCRIO Retorna ou define o valor da propriedade de outro objeto de acordo com a posio da caixa de rolagem.

Boto Incremento-Decremento Utilizado para incrementar e (Spin Button) decrementar um valor. Editor de Texto (Text Box) Utilizado para exibir informaes digitadas pelo usurio na Tela. Semelhante ao Boto de Comando, porm necessita um segundo comando do usurio para voltar ao estado normal. Combina os recursos de uma Lista e de um Editor de Texto. O usurio pode digitar um novo valor ou selecionar um valor existente.

Boto Liga-Desliga (Toggle Button)

Lista de Seleo (Combo Box)

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

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

48

Objetos de Tela

Galeria

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

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

Objetos de Tela

49

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.

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

50

Objetos de Tela

6.3.2 Tela Inicial


A Tela Inicial ter o seguinte aspecto:

Tela Inicial 1. Configure a propriedade FillStyle para 12 - bkPicture, para habilitar uma figura de fundo. 2. Para colocar a figura FundoTelaInicial como fundo, arraste o bitmap de Recursos at a propriedade PictureFile da Tela. Isto faz com que o E3 utilize o recurso inserido e no o arquivo da imagem (que externo aplicao). Para escolher a melhor posio da figura, pode-se alterar a propriedade PicturePosition. 3. Crie um objeto Texto com a palavra "Entrar", e outro com a palavra "Sair".

DICA: Para editar um texto j existente na tela, clique com o boto direito do mouse em cima do objeto e selecione Editar Texto.

4. No centro da tela, posicione o texto "Treinamento E3 Studio".

Objetos de Tela

51

DICA: Utilize os botes Verticalmente.

Centralizar Horizontalmente e

Centralizar

5. Logo abaixo do texto "Treinamento E3 Studio", insira um segundo texto com a mensagem "Elipse Software Ltda".

6.3.3 TelaMenu

TelaMenu 1. Na TelaMenu, coloque como figura de fundo FundoTelaMenu. 2. Insira um objeto Command Button e na propriedade Caption digite "Inicial". 3. Repita o procedimento para criar um boto para cada tela da aplicao, Eventos, Grafico, Sinotico, Comunicao, PenGroup, Remoto e Playback. 4. No canto direito da tela, insira um Display logado. para exibir o nome do usurio

5. Ao lado do Display insira um boto com o texto "Login". 6. Insira um Display no canto da tela para exibir o horrio atual. 7. Acesse as propriedades do objeto e selecione a aba Formatao. Defina o formato como Hora, e no item Tipo, escolha "13:06:03". Essa formatao mostrar as horas, os minutos e os segundos. 8. Para visualizar a configurao feita no exerccio anterior, acesse a propriedade Value do Display e escolha a opo Date.

Formato de Hora

52

Objetos de Tela

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.

6.3.5 TelaComando
Essa tela executar comandos nas bombas. 1. Configure a Tela da cor de sua preferncia.

6.3.6 TelaComunicacao
Essa tela exibir os valores do equipamento de comunicao. 1. Configure a Tela da cor de sua preferncia.

6.3.7 TelaEventos
Essa tela mostrar os alarmes gravados no banco de dados. 1. Configure a Tela com fundo branco. 2. Arraste da Galeria, grupo Recursos, o logotipo do E3.

6.3.8 TelaGrafico
Essa tela ter um grfico das variveis de nvel dos tanques. 1. Configure a tela com fundo branco.

6.3.9 TelaPenGroup
Essa tela ser utilizada para exibir um grfico. 1. Configure a Tela da cor de sua preferncia.

Objetos de Tela

53

6.3.10 TelaPlayBack
Com essa tela poderemos reproduzir outra tela no tempo. 1. Configure a Tela da cor de sua preferncia.

6.3.11 TelaRemoto
Essa tela exibir valores de outra aplicao do E3. 1. Configure a Tela da cor de sua preferncia.

6.3.12 TelaSinotico

TelaSinotico 1. Na TelaSinotico, coloque como figura de fundo a imagem FundoTelaSinotico.

6.3.13 Setpoint
1. Sobre os tanques de cores, insira Setpoints cada componente de cor. onde ser digitada a quantidade de

Habilite os limites do Setpoint, alterando a propriedade EnableLimits para True. Configure a propriedade MaxLimit para 255 e MinLimit para 0.

54

Objetos de Tela

Configurando limites

6.3.14 Galeria
Sobre a esteira insira, a partir da biblioteca de objetos grficos (Galeria), a figura 5GallonBucket, que est na pasta Tanks.

6.3.15 Retngulo
1. Sobre os tanques direita, desenhe um objeto Retngulo e configure as seguintes propriedades: BackgroundStyle: 1 - opaque BackgroundColor: Preto (RGB(0, 0, 0)) VerticalPercentFill: 20

6.3.16 Display
1. Ao lado de cada tanque insira um Display .

2. Configure o valor inicial para exibir um Double. 3. Formate o Display como porcentagem e com uma casa decimal.

6.4 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

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

Objetos de Tela

55

6.5 Anotaes

56

Objetos de Tela

CAPTULO

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

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

Assoc ia es

57

7.1 Tipos de Associao


Esta seo contm informaes sobre os tipos de Associaes.

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

58

Assoc ia es

7.1.2 Conexo Bidirecional


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

Conexo Bidirecional

Assoc ia es

59

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

60

Assoc ia es

7.1.4 Conexo Analgica


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

Conexo Analgica

Assoc ia es

61

7.1.5 Conexo por Tabela


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

Conexo por Tabela

62

Assoc ia es

7.1.6 Conexo Reversa


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

Conexo Reversa

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.

Assoc ia es

63

Edio de Associaes

7.2 Valores Booleanos


Em VBScript, 0 considerado como Falso e qualquer valor diferente de 0 considerado Verdadeiro. Considere, por exemplo, um tag que representa uma entrada ou sada digital, portanto seus valores so 0 ou 1. Ao usar o valor do tag para associaes com propriedades do tipo Boolean, o E3 considerar:

TAG 0 1 Falso Verdadeiro

VBSCRIPT

Ao utilizar o comando NOT, ficar:

TAG 0 1 -1 -2

NOT TAG

VBSCRIPT Verdadeiro Verdadeiro

64

Assoc ia es

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

TAG 0 1 Falso

CBOOL(TAG)

NOT CBOOL(TAG) Verdadeiro Falso

Verdadeiro

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
Esta seo contm exerccios sobre o contedo deste captulo.

7.3.1 Conexo Simples


Esta seo contm exerccios sobre o tpico Conexo Simples.

7.3.1.1 Horrio do Sistema


1. Na TelaMenu, acesse as propriedades do Display que vai exibir o horrio do sistema, aba Associaes. 2. Na propriedade Value, busque na coluna Fonte, com o auxlio do AppBrowser, o tag Demo HoraAtual (Servidor - Dados). direita, selecione a propriedade Value e clique no boto Colar. A informao vai do tag para o Display, logo a Associao Assoc ia es 65

Simples (Propriedade < -- Fonte).

Associao Simples

7.3.1.2 Usurio Logado


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

Conexo com a propriedade User do Viewer

7.3.1.3 Nvel do Tanque


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

Associao com a propriedade VerticalPercentFill 2. Repita o procedimento do item 1 para o tag Nivel2.

7.3.1.4 Cor de Preenchimento


1. Para pode modificar a cor do lquido, crie a Associao da figura a seguir.

Associao na propriedade ForegroundColor 2. Busque no AppBrowser o mtodo RGB do VBScript. 3. Substitua as palavras "Red", "Green" e "Blue" pelos tags Vermelho, Verde e Azul, respectivamente.

DICA: Trabalhe com Copiar (CTRL + C) e Colar (CTRL + V). Para editar uma Associao criada anteriormente, tecle F2.

66

Assoc ia es

4. Repita os procedimentos de 1 a 3 para o segundo tanque.

7.3.2 Conexo Bidirecional


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

Associao Bidirecional

7.3.3 Conexo Analgica


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

Conexo Analgica

7.3.4 Conexo por Tabela


O Display que exibe o nvel deve alterar a cor de fundo conforme a tabela a seguir.

MNIMO 0 10 30 10 30 70

MXIMO Verde Azul Branco

COR

Assoc ia es

67

MNIMO 70 90 90 100

MXIMO Amarelo Vermelho

COR

1. Na propriedade ForegroundColor do Display, insira uma Associao por Tabela com o tag Nivel1.

Associao por Tabela

7.3.5 Copiar Associao


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

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

68

Assoc ia es

Ignorar ou sobrescrever Associao 4. Altere a referncia do tag Nivel1 para o Nivel2.

7.3.6 Animao
1. Selecione o objeto Galo e aperte o boto para inserir uma Animao com Translao. Uma sombra do objeto aparecer. Mova-a at onde desejar.

Animao com Translao O inicio 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.

Assoc ia es

69

Inserir Tag Demo 3. Configure o tag Anima com os seguintes valores: Mnimo: 0 Mximo: 100 Period: 5000 Scan: 100 4. Clique com o boto direito do mouse na Animao e acesse suas propriedades. Crie uma Associao na propriedade Value com o tag Anima.

Associao na propriedade Value 5. Altere as propriedades Enabled e EnabledSlider da Animao para False.

70

Assoc ia es

7.4 Anotaes

Assoc ia es

71

CAPTULO

Comunicao
O E3 permite a comunicao com equipamentos de aquisio de dados, controladores, CLPs (Controladores Lgicos Programveis), UTRs (Unidades Terminais Remotas), ou qualquer outro tipo de equipamento, atravs de Drivers de Comunicao ou Servidores OPC, de acordo com o tipo do equipamento ou tipo de comunicao necessria. Os Drivers de Comunicao e Servidores OPC funcionam nesse caso como servidores de variveis, ou seja, eles fornecem as informaes do mundo externo para o E3 para que a superviso do processo se realize. As variveis envolvidas no processo so conhecidas como Tags e podem ser de vrios tipos, de acordo com a utilizao desejada. No E3 podem ser inseridos dois tipos de Drivers, o Driver de Comunicao (arquivos .dll) e o Driver de Comunicao OPC.

8.1 Driver de Comunicao


O Driver de Comunicao o mdulo do E3 que possibilita a comunicao com um determinado equipamento, usando os Drivers .dll fornecidos pela Elipse Software. Um manual fornecido juntamente com cada Driver, contendo informaes importantes a respeito da configurao dos seus parmetros [P] e outras propriedades. Os tipos de objetos de Driver disponveis para comunicao so os seguintes: Objetos disponveis no Driver de Comunicao OBJETO Pasta Tag de Comunicao Bloco de Comunicao Elemento de Bloco DESCRIO Define grupos e subdiretrios para a organizao de variveis. No tem relao direta com o equipamento de campo. Utilizado para definir a comunicao com uma varivel (um endereo de memria) do equipamento de aquisio. Utilizado para definir a comunicao com diversas variveis (vrios endereos de memria em sequncia) do equipamento de aquisio. Representam cada um dos endereos de um bloco e so utilizados como se fossem Tags de Comunicao. Os Elementos de Bloco podem apontar para cada ndice dentro de um Bloco

72

Comunic a o

(correspondendo a cada varivel de interesse).

8.1.1 Exerccios
Esta seo contm exerccios sobre os Drivers de Comunicao.

8.1.1.1 Driver
1. Clique com o boto direito do mouse sobre a pasta Drivers e OPC e escolha a opo Inserir Driver de Comunicao em - TreinamentoE3.prj. 2. Selecione o arquivo do Driver (.dll) na caixa de dilogo que se abre para a seleo de arquivos. 3. Caso a caixa de dilogo no seja aberta automaticamente, escolha o arquivo de Driver na propriedade DriverLocation. 4. Verifique se a propriedade DriverName foi preenchida. 5. Nos Drivers mais recentes, todas as configuraes de comunicao devem ser realizadas nas janelas de configuraes extras do IOKit, que um componente compartilhado utilizado pelos Drivers de Comunicao do E3. 6. Para os Drivers que utilizam o IOKit, a interface de configurao aberta atravs do boto Configurar o Driver na barra de ferramentas do Driver.

Configurar Driver 7. A seguinte janela ser aberta.

Comunic a o

73

Janela de configurao do Driver 8. Na aba Setup, escolha na lista de opo da propriedade Physical Layer a interface fsica que ser utilizada. As opes so Serial, Ethernet, Modem e RAS. 9. Configure o tempo que o Driver aguardar uma resposta do equipamento no campo Timeout. 10.Aps a escolha da opo Physical Layer, todas as outras abas sero desabilitadas, sendo necessrio apenas configurar a interface escolhida. A partir deste ponto, o Driver estar configurado para acessar o meio fsico.

74

Comunic a o

8.1.1.2 Tag Browser


1. Caso a caixa de dilogo do Tag Browser no abra automaticamente, acesse-a pelo boto .

2. Na janela Tag Browser, arraste para a esquerda o bloco de comunicao IO. IOKitEvent da pasta General.

Tag Browser 3. Feche a janela quando terminar de selecionar as variveis que desejar.

Comunic a o

75

8.1.1.3 Tags de Comunicao


1. Clique com o boto direito do mouse no Driver e acesse a opo Inserir - Tag de Comunicao ou clique no boto Adicionar na barra de ferramentas do Driver.

Inserir Tag de Comunicao 2. Escolha a quantidade de tags a serem inseridos e seu nome.

Quantidade de Tags 3. Configure as propriedades de N1/B1 a N4/B4 conforme o manual do Driver. 4. Clique novamente com o boto direito do mouse no Driver e escolha o item Ativar Comunicao para testar as configuraes ou aperte o boto Ativar/Desativar comunicao . Caso as configuraes estejam corretas, a linha do tag dever ficar na cor azul.

Ativar Comunicao 5. Crie os outros tags e blocos e configure suas propriedades de N1/B1 a N4/B4. 6. Ajuste o tempo de varredura para cada tag conforme a necessidade. 76 Comunic a o

7. Na TelaComunicacao, crie um Setpoint para cada tag criado e associe-o ao seu respectivo tag.

TelaComunicacao

8.2 Driver de Comunicao OPC


O Driver de Comunicao OPC o mdulo responsvel por coletar dados de equipamentos externos atravs de um Servidor OPC, que pode ser desenvolvido por qualquer empresa com conhecimentos da rede e do protocolo usados por um determinado equipamento. Os tags OPC podem ser importados para o Driver OPC no E3 (o Driver OPC no E3 atua como um cliente OPC), ou ainda podem ser criados no E3. Nesse caso necessrio conhecer o ItemId de cada tag. Objetos disponveis no Servidor OPC OBJETO Pasta OPC DESCRIO Definem grupos ou subdiretrios para a organizao das variveis. Agrupa uma srie de tags OPC que compartilham os mesmos parmetros de atualizao (tempo de varredura e banda morta). obrigatrio existir um grupo OPC para se poder criar tags OPC. Objeto para leitura ou escrita de valores em um equipamento. A leitura do tag feita automaticamente pelo Servidor OPC, com tempo de varredura definido no grupo OPC onde ele est inserido.

Grupo OPC

Tag OPC

Comunic a o

77

Bloco OPC

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

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

8.2.1 Exerccios
O E3 funcionar como servidor OPC e tambm como cliente OPC. Assim como no exerccio anterior, esse exerccio serve para mostrar como funciona a configurao do Driver OPC, j que o procedimento semelhante para qualquer servidor OPC que esteja sendo utilizado. O roteiro descrito nos passos a seguir. 1. Clique com o boto direito do mouse sobre a pasta Drivers e OPC e escolha a opo Inserir Driver de Comunicao OPC em - TreinamentoE3.prj. 2. Clique com o boto direito do mouse sobre o Driver OPC inserido, selecione a opo Propriedades e v at a aba OPC Driver. Clique sobre o boto Selecionar.

Selecionar servidor 3. Ser aberta uma janela com as opes de OPC Server na sua mquina local ou na rede. Selecione o Elipse OPC Server da mquina do instrutor na opo Servidores na rede e pressione o boto OK.

78

Comunic a o

Servidores OPC na rede 4. Ao voltar janela de propriedades do Driver OPC, pressione o boto Ativar Comunicao.

Ativar Comunicao 5. A partir deste ponto, possvel verificar a comunicao com o servidor clicando sobre a opo Informaes.

Informaes sobre o servidor 6. O prximo passo para a configurao a importao de tags. Selecione a opo Importar Tags.

Importar tags 7. O assistente de importao de tags do E3 ser aberto. Clique no boto Buscar.

Comunic a o

79

Buscar tags 8. A figura anterior mostra a aparncia da janela de importao. Do lado direito a lista de tags do servidor e do lado esquerdo, a rea de importao para o E3. Para importar, selecione o item e arraste-o at o grupo OPC de destino.

80

Comunic a o

Grupos OPC 9. Depois de importar alguns tags ou propriedades, verifique o funcionamento dos tags importados.

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 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

Comunic a o

81

8.3.1 KB
KB-14918: Como saber quantos tags existem dentro de um Driver de Comunicao?

82

Comunic a o

8.4 Anotaes

Comunic a o

83

CAPTULO

Importao e Exportao
A ferramenta de importao de objetos do E3 tem como objetivo ler as informaes sobre os objetos de um arquivo CSV e recriar os mesmos no ambiente de configurao (E3 Studio). Para cada objeto possvel obter informaes sobre propriedades, associaes e itens de colees. A ferramenta de exportao de objetos do E3 tem como objetivo gravar informaes sobre os objetos escolhidos a partir do ambiente de configurao (E3 Studio) em um arquivo CSV. Para cada objeto podem ser gravadas suas propriedades, suas associaes e seus itens de colees. Qualquer objeto do E3 poder ser importado ou exportado. O objeto selecionado para a operao chamado de objeto raiz. Alm dos objetos, as associaes e as colees tambm podem ser importadas e exportadas.

NOTA: Os scripts NO so exportados. Apenas os objetos e as associaes. Para trabalhar com importao ou exportao necessrio ter a licena de Studio da Elipse.

9.1 Arquivo CSV


Um arquivo CSV (Comma Separated Values) um arquivo texto baseado em colunas separadas por um caractere separador previamente definido. Cada coluna do arquivo CSV representa uma ou mais propriedades de objetos do E3. Cada linha do arquivo representa um objeto, associao ou item de coleo. Para que esses arquivos sejam utilizados corretamente, preciso observar alguns detalhes. A primeira linha do arquivo CSV deve conter um cabealho que identifique as colunas corretamente. O cabealho deve ter obrigatoriamente uma coluna que identifica o tipo do objeto que est sendo importado ou exportado. Esta coluna chama-se ObjectType. O cabealho das demais colunas deve ser o prprio nome da propriedade.

84

Importa o e Exporta o

As colunas podem ser colocadas em qualquer ordem no arquivo. Pode haver colunas a mais ou a menos, sem prejuzo da operao de importao ou exportao. A nica coluna obrigatria ObjectType, porque sem ela no possvel identificar o tipo de objeto que deve ser criado.

9.2 Gerenciador de Modelos


Os Modelos so arquivos INI utilizados para configurar a ferramenta de importao e exportao, informando, por exemplo, qual o separador que deve ser utilizado no arquivo CSV, se as associaes dos objetos devem ou no ser exportadas, etc. O Gerenciador de Modelos uma ferramenta para auxiliar o usurio na criao de um arquivo INI para ser utilizado na importao ou exportao de objetos do E3. Na aba Configuraes possvel salvar um arquivo modelo. Quando a opo Salvar as alteraes deste modelo em um arquivo INI for marcada, definido o arquivo INI onde as alteraes do modelo sero salvas, e esse arquivo poder ser reutilizado.

Importa o e Exporta o

85

Aba Configuraes Atravs da aba Propriedades, o usurio escolhe quais as propriedades dos objetos que deseja utilizar na importao ou na exportao. O valor inicial da lista 86 Importa o e Exporta o

ObjectType. As demais propriedades devem ser adicionadas manualmente pelo usurio.

Aba Propriedades Importa o e Exporta o 87

Ao pressionar o boto

, a seguinte janela aberta para a seleo de propriedades.

Adicionar propriedades As propriedades em negrito nesta lista j foram inseridas na lista que define as colunas do arquivo CSV. Um duplo-clique sobre uma propriedade faz com que ela seja adicionada ou removida, dependendo se ela j estava ou no na lista. As propriedades tambm podem ser agrupadas. Selecione as que deseja agrupar e clique no boto . Os nomes das propriedades so agrupados em uma mesma linha, utilizando o nome da coluna definido para a propriedade que est no topo da lista.

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

88

Importa o e Exporta o

9.3.1 Exportao
1. Clique com o boto direito do mouse em um objeto Driver e escolha a opo Exportar.

Menu Exportar

9.3.2 Importao
1. Clique com o boto direito do mouse no Driver e escolha a opo Importar. 2. Selecione o arquivo CSV criado na exportao. 3. Caso j exista o tag que foi importado, aparecer uma mensagem perguntando se deve ser sobrescrito ou ignorado.

Aviso de importao 4. Verifique se todos os tags foram criados com sucesso.

Importa o e Exporta o

89

9.4 Anotaes

90

Importa o e Exporta o

10

CAPTULO

Bibliotecas ElipseX

O E3 possui ferramentas que permitem transformar qualquer objeto ou conjunto de objetos de sua aplicao em uma biblioteca do usurio. A ideia das bibliotecas de usurios (chamadas de ElipseX) vem das linguagens de programao orientadas a objetos, onde diversos componentes podem ser compartilhados entre projetos sem que seja necessrio desenvolver novamente cada um dos objetos. O uso de bibliotecas no E3 altamente recomendvel devido ao ganho de produtividade que elas trazem. Algumas das vantagens dos ElipseX: Reutilizao de cdigos Minimizao de testes durante o desenvolvimento Criao de 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.

Bibliotec as ElipseX

91

Bibliotecas de Objetos

10.1 Criao de Bibliotecas do Usurio


Os objetos ElipseX podem conter, alm de um desenho, variveis internas que podem ser exportadas para a aplicao, alm de lgicas de programao (scripts) que vo estar presentes em todas as cpias do objeto que est sendo criado, diminuindo a necessidade de repetio de cdigo em diversas partes do aplicativo. Para criar uma nova biblioteca no E3, siga estes procedimentos: 1. Acesse o menu Arquivo, selecione o item Novo Projeto e clique em Prximo. 2. Na opo Tipo de Aplicao, selecione a opo Biblioteca de componentes do E3.

92

Bibliotec as ElipseX

Assistente de Aplicaes 3. Determine o nome da biblioteca e a pasta onde ela ser salva, e clique em Avanar. 4. Determine as especificaes referentes ao Domnio. 5. Clique em Concluir. Dentro de uma biblioteca ElipseX podem ser inseridos dois tipos de objetos, os objetos grficos XControls e os objetos de dados XObjects. Podem ser inseridos nos XControls todos os itens disponveis para as Telas. Entre esses itens esto as primitivas de desenho, objetos grficos vetoriais, incluindo objetos da biblioteca de smbolos (WMF, EMF, etc.), objetos grficos no vetoriais (BMP, JPEG, GIF, etc.), controles ActiveX do E3 (E3Chart, E3Browser, E3Alarm), controles ActiveX de terceiros e outros XControls. J as bibliotecas de dados podem conter quaisquer tipos de objetos no grficos, que so executados no E3 Server. Pode-se inserir em um XObject os seguintes objetos: Driver de Comunicao, Servidor de Dados, Banco de Dados, Frmulas, Configurao de Alarmes, Servidor de Alarmes, Objetos COM, outros XObjects, dentre outros. Dentro de um mesmo arquivo .lib pode existir qualquer nmero de componentes ElipseX, sejam eles XControls ou XObjects. Pode-se ter tambm vrias bibliotecas Bibliotec as ElipseX 93

diferentes (vrios arquivos .lib) dentro do mesmo Domnio.

10.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 opes disponveis so: e excludas atravs do boto . As

Opes disponveis em XControls OPO Nome Tipo Public DESCRIO Determina o nome da propriedade do XControl. Determina o tipo de dado suportado pela propriedade. Habilita ou desabilita a visibilidade da propriedade fora da biblioteca, isto, determina se a propriedade ser ou no pblica. Determina o valor inicial da propriedade.

Valor Inicial

94

Bibliotec as ElipseX

Texto de ajuda

Texto de declarao e documentao da propriedade.

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

10.1.2 XObject
Alm dos objetos grficos, pode-se criar uma biblioteca de dados, chamada XObject. Com ela, pode-se definir uma estrutura de dados a ser executada no servidor. Tal estrutura poder realizar clculos, associaes, comunicaes, verificao de alarmes, registro histrico, etc., que independam de alguma interface grfica (Viewer) aberta ou em execuo naquele momento. Para criar um XObject, clique com o boto direito do mouse sobre o arquivo .lib no Organizer e escolha a opo Inserir - XObject. As opes disponveis para as propriedades do XObject so as mesmas dos XControl, citadas anteriormente. Alm das XProperties, podem ser inseridos em um XObject quaisquer mdulos do E3 que sejam executados no servidor. Para saber a lista completa, basta pressionar o boto que define o tipo do objeto e verificar a lista de opes disponveis. Isso permite que se possa definir como uma biblioteca um sistema complexo de gerenciamento, que poder ser facilmente replicado quantas vezes forem necessrias no aplicativo. Pode-se inserir os XObjects em qualquer Servidor de Dados clicando com o boto direito do mouse sobre o Servidor de Dados e escolhendo a opo Inserir. Mesmo que o(s) arquivo(s) de biblioteca possua(m) vrios XControls e XObjects, ao tentar inserir uma biblioteca o E3 Studio exibir para as Telas somente os XControls, e para os Servidores de Dados somente os XObjects.

Bibliotec as ElipseX

95

10.2 Quando Criar um ElipseX


Existem alguns critrios para indicar a necessidade da construo de objetos no Elipse E3: Repetio no uso: se um mesmo equipamento ou processo ser usado mais de uma vez no mesmo projeto. Procedimentos de conhecimento do usurio: frequentemente, um processo criado por determinada empresa deve ser protegido de cpia ou alterao. Isso comum no caso de integradores de servios ou fabricantes de mquinas. Uso de controladores: um controlador de processo, cujo mapeamento de memria fixo, pode ser implementado com todas as funcionalidades disponveis. A flexibilidade disponvel para a construo e uso dos objetos no E3 permite que sejam utilizadas posteriormente apenas as variveis de interesse, desprezando-se as demais.

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

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

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

96

Bibliotec as ElipseX

10.3.2 XControl
1. Insira um XControl e chame-o de DisplayTemp.

DisplayTemp 2. Na aba Design desenhe um Display. 3. Formate o Display com a expresso 0.0 "C".

Formato Display 4. Para poder receber externamente qualquer valor precisamos criar propriedades. Altere da aba Design para a aba Propriedades no canto inferior na tela.

Aba Propriedades 5. Crie uma propriedade chamada Temperatura do tipo Double.

Propriedade Temperatura 6. Retorne aba Design. No Display, crie uma Associao Simples com a propriedade Temperatura criada na 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.

Bibliotec as ElipseX

97

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

Registrar bibliotecas carregadas 9. Insira na Tela dois XControl DisplayTemp, ao lado de cada um dos tanques.

98

Bibliotec as ElipseX

DisplayTemp 10.Para cada DisplayTemp na tela, faa uma Associao Simples na propriedade Temperatura com um tag Temp.

10.3.3 DadosBomba
1. Na biblioteca LibTreinamento, insira um novo XObject e nomeie-o DadosBomba. 2. Crie trs propriedades do tipo Boolean, OnOff, Automatico e Defeito.

Propriedades de DadosBomba 3. Salve a biblioteca e registre-a.

10.3.4 Bomba

Bomba Bibliotec as ElipseX 99

1. Insira um novo XControl e nomeie-o Bomba. 2. Insira o objeto 3DISABlower da categoria Blowers da Biblioteca de Smbolos. Modifique as seguintes propriedades: OverrideFillMode para 3 - ByBrightness OverrideFillColor para verde (0, 255, 0)

3. Insira a figura Defeito 4. Insira um Display

e Automatico

que est no projeto como Recurso.

embaixo da vlvula para exibir o nome "Bomba".

5. Crie uma propriedade chamada Fonte do tipo DadosBomba (XObject criado anteriormente).

Tipo DadosBomba 6. Para facilitar posteriormente, escreva no campo Texto de ajuda a mensagem "Objeto DadosBomba associado. Propriedades: OnOff, Automatico, Defeito".

7. Para que a figura s aparea quando a vlvula estiver com defeito, crie uma Associao Simples na propriedade Visible do objeto com a propriedade Defeito. Com o auxlio do AppBrowser, localize a propriedade Fonte.

100

Bibliotec as ElipseX

No campo inferior, insira aps a propriedade Fonte a propriedade do objeto DadosBomba desejada, nesse caso, Defeito.

AppBrowser

8. Repita o procedimento anterior para o objeto Automatico propriedade Automatico.

com a

9. No Display abaixo da vlvula deve aparecer o nome do XObject DadosBomba associado. Crie uma Associao na propriedade Value do Display com Bomba. Fonte.Name. 10.Quando a propriedade OnOff estiver em True a cor da bomba dever ser verde, e quando a propriedade estiver em False a cor dever ser vermelha. Na aba Associaes, crie uma Associao Digital na propriedade OverrideFillColor com a propriedade OnOff.

Bibliotec as ElipseX

101

Associao Digital 11.Salve a biblioteca e registre-a.

10.3.5 TelaSinotico
1. Na TelaSinotico insira um objeto Bomba sobre cada bomba do desenho de fundo. 2. Crie dentro de Dados uma Pasta de Dados com o nome Bombas. 3. Na pasta Bombas, crie seis XObjects DadosBombas, de B01 a B06.

Objetos Bomba 4. Associe a propriedade Fonte dos objetos Bomba da TelaSinotico aos XObject Bomba criados no exerccio anterior.

Propriedade Fonte

DICA: Pode-se arrastar o objeto que se deseja associar at a propriedade desejada.

102

Bibliotec as ElipseX

Arrastando um objeto para a propriedade desejada

10.3.6 ComandoBomba

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

4. Crie uma Associao Bidirecional entre as propriedades Value da Caixa de Seleo e Defeito da Fonte. Bibliotec as ElipseX 103

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. 6. Insira um texto sobre os objetos onde aparea o nome do XObject DadosValvula associado.

Criando um link para a propriedade Valor 7. Salve a biblioteca e registre-a.

10.3.7 TelaComando
1. Na TelaComando, insira um objeto ComandoBomba.

10.4 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

10.4.1 Conexo Mltipla


Muitas vezes desejamos alterar a fonte de informao de uma Associao dependendo de uma ou mais variveis. Como exemplo, podemos relacionar a cor final do tanque levando em conta se a bomba est ligada ou no. Existem oito combinaes possveis para trs bombas. Para transformarmos os valores booleanos em um decimal, usamos a expresso:
4 * Bomba1 + 2 * Bomba2 + Bomba3

Como no VBScript o valor Verdadeiro equivale numericamente a -1, nossa expresso deve ser:
-4 * Bomba1 - 2 * Bomba2 - Bomba3

A cor final deveria ser:

104

Bibliotec as ElipseX

VERMELHO 0 0 0 0 0 1

VERDE 0 1 0

AZUL 0 1 2

STATUS

DESCRIO RGB(0, 0, 0) RGB(0, 0, Azul) RGB(0, Verde, 0) RGB(0, Verde, Azul) RGB(Vermelho, 0, 0) RGB(Vermelho, 0, Azul) RGB(Vermelho, Verde, 0) RGB(vermelho, Verde, Azul)

Para aplicarmos essa lgica, podemos utilizar a Conexo Mltipla. 1. No retngulo do tanque, altera a Associao da propriedade ForegroundColor conforme a tabela anterior.

Propriedade ForegroundColor

Bibliotec as ElipseX

105

10.4.2 KB
KB-28547: Como utilizar em um novo Domnio uma biblioteca desenvolvida em outro Domnio?

106

Bibliotec as ElipseX

10.5 Anotaes

Bibliotec as ElipseX

107

11
Scripts
Os Scripts so trechos de cdigo (programao) com os quais se pode criar procedimentos associados a eventos especficos, permitindo grande flexibilidade no desenvolvimento e no uso de aplicaes. Todos os scripts esto associados a eventos, e cada objeto do E3 possui uma lista de eventos previamente definidos, sendo possvel tambm definir novos eventos de usurio. De acordo com conceitos da programao orientada a objetos, as Propriedades definem atributos de um objeto, como a aparncia de um controle de Tela ou o valor inicial de um objeto quando se inicia o aplicativo. NOTA: Estamos trabalhando at agora apenas com propriedades no E3. J conhecemos algumas propriedades dos objetos do E3 e vimos que temos duas maneiras de alter-las, na Janela de Propriedades ou por Associaes.

CAPTULO

Os Mtodos so funes previamente definidas, que executam determinadas aes sobre as propriedades do objeto que chama estas aes. Exemplos disso so funes para realizar a escrita em tags (Write ou WriteEx), entre outras. Em linguagens de programao orientadas a objeto, para agir sobre uma propriedade necessria a criao de mtodos. No E3, para cada mtodo desejado, necessrio definir a qual evento ele estar associado, pois os scripts do E3 so orientados a eventos. Os Eventos so ocorrncias relacionadas a um objeto, que podem ser tratadas de modo a se realizar uma ao (um mtodo).

11.1 Definindo Scripts


A linguagem que o E3 Studio usa em seus scripts o VBScript, um subconjunto da linguagem Visual Basic desenvolvida pela Microsoft. O VBScript possui um interpretador rpido, leve e portvel, desenvolvido para o uso em navegadores para a Internet e outras aplicaes que usam ActiveX Controls, Automation Servers e Java Applets. Os scripts so sempre associados a eventos de um determinado objeto. Entretanto, para facilitar e aumentar a velocidade de desenvolvimento, o E3 j incorpora algumas aes mais comuns que poderiam ser realizadas com scripts atravs de assistentes (wizards) chamados Picks. Pode-se definir que um determinado 108 Sc ripts

evento executar um script, um Pick ou uma combinao deles, em uma sequncia definida durante a criao do script (no E3 Studio).

11.1.1 Obtendo Referncias a Objetos


Uma das caractersticas mais importantes ao se trabalhar com scripts dentro do E3 considerar a separao existente entre os processos que so executados no servidor e aqueles executados na interface do cliente (Viewer). Para se trabalhar com scripts, pode-se manipular: Objetos do servidor atravs do servidor Objetos do servidor atravs do(s) Viewer(s) Objetos do Viewer atravs do mesmo Viewer No entanto, no se pode manipular diretamente: Objetos do Viewer atravs do servidor diretamente (s possvel atravs da criao de eventos no Viewer, ligados a variveis que esto no servidor) Objetos de um Viewer a partir de outro Viewer (s possvel atravs da criao de eventos ligados a variveis que esto no servidor) Tais limitaes so decorrentes do fato de que, por definio, existe uma independncia entre o que cada uma das estaes Viewer est fazendo ou visualizando com relao ao servidor e vice-versa. Por isso todas as atividades, tanto no servidor quanto no Viewer, necessitam ser coordenadas de forma assncrona ou atravs de eventos para operarem de forma harmoniosa. Devido a essa independncia, ao se criar um script, primeiro deve-se obter uma referncia correta dos objetos que se deseja manipular, ou seja, necessrio que o objeto seja primeiramente encontrado nos vrios mdulos do E3. Vale repetir que, ao se editar um script, o usurio dever utilizar o AppBrowser, que permite copiar para o script o caminho de um mtodo ou propriedade de forma completa, auxiliando-o na criao de scripts. Por exemplo, para se manipular o valor de um tag de comunicao, o caminho Servidor - Driver - Pasta (se houver) - Tag. J se o objetivo for manipular um boto na Tela o caminho Viewer - Frame (se houver) - Tela - Boto. Existem basicamente trs localizaes de origem de scripts, do ponto de vista da metodologia para acesso aos objetos:

Sc ripts

109

Servidor (E3 Server) Telas e quadros (E3 Viewer) ElipseX (bibliotecas): podem ser XObjects (rodam no servidor) e XControls (rodam no Viewer) Cada uma delas trata de forma diferente o acesso aos dados que um script deve lidar. A nica ferramenta til para todos esses acessos o AppBrowser.

11.1.2 Picks
Os Picks implementam uma forma amigvel de realizar procedimentos comuns em scripts, poupando tempo de escrita de cdigo. Entre eles esto aes como troca de Tela ou atribuio de valores, que so bastante comuns na criao de um projeto.

110

Sc ripts

11.1.2.1 Executar Scripts


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

Pick Executar Script

Sc ripts

111

11.1.2.2 Abrir Tela


Abre uma Tela ou um Quadro determinado.

Pick Abrir Tela

112

Sc ripts

11.1.2.3 Abrir Tela Modal


Abre uma Tela em estilo modal.

Pick Abrir Tela Modal

Sc ripts

113

11.1.2.4 Executar Aplicao


Executa um programa especfico.

Pick Executar Aplicao

114

Sc ripts

11.1.2.5 Carregar Valor


Carrega um valor em um tag.

Pick Carregar Valor

Sc ripts

115

11.1.2.6 Inverter Valor


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

Pick Inverter Valor

116

Sc ripts

11.1.2.7 Imprimir Relatrio


Permite imprimir um Relatrio na Tela ou na impressora.

Pick Imprimir Relatrio

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

Sc ripts

117

Lista de eventos

11.2.1 Eventos Definidos pelo Usurio


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

118

Sc ripts

Criar evento do usurio

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

Sc ripts

119

AppBrowser

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

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

120

Sc ripts

11.5.1 Pick Abrir Tela


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

Pick Abrir Tela 3. No campo Abrir a Tela, selecione o Quadro1. 4. Deixe a opo No Quadro em branco. 5. Na TelaMenu, para cada boto relacionado a uma Tela, crie um script para abrir sua respectiva Tela. As Telas TelaInicial e TelaPlayBack devem abrir no Quadro _top e as demais no Quadro Central.

11.5.2 Pick Script


Na TelaInicial podemos fechar a aplicao ao clicar no texto Sair. 1. Na TelaInicial, crie um novo Pick do tipo Script no texto Sair.

Pick Script 2. Com o auxlio do AppBrowser Colar.


Application.Exit

procure o mtodo Exit do Viewer e aperte o boto

3. Execute a aplicao e teste as novas funcionalidades.

Sc ripts

121

11.5.3 Tela Indexada


Ao clicar sobre uma bomba dever ser aberta a sua Tela de comando. Como temos uma nica Tela de comando e vrias bombas, ao abrir a Tela devemos informar o nome da bomba que gostaramos de dar os comandos. 1. No XControl Bomba, crie um script no evento Click da figura que simboliza a bomba.
'Nome completo da bomba NomeBomba = Bomba.Fonte.PathName 'Abrir TelaComando Application.DoModal "TelaComando", "Comando", 0, 0, +2048 , , NomeBomba, 1+2+64

2. Digite "NomeBomba = " para criar uma varivel auxiliar de script que guardar o nome da bomba que foi clicada. 3. Busque, com o auxlio do AppBrowser , o XControl Bomba e direita a propriedade Fonte. Aperte o boto Colar. 4. Termine a linha digitando ".PathName". Essa propriedade retorna o nome completo do XObject DadosBomba que estiver associado.
NomeBomba = Bomba.Fonte.PathName

5. Busque, com o auxlio do AppBrowser boto Colar.

, o mtodo DoModal do Viewer e aperte o

Application.DoModal(Screen, Title, Left, Top, Width, Height, Arg, Flags)

6. Altere o parmetro Screen para o nome da tela que deseja abrir, "TelaComando". 7. Altere o parmetro 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.Substitua o parmetro Arg pela varivel NomeBomba. Essa informao ser passada para a Tela que se abrir. 11.Altere o parmetro Flags para 1+2+64+2048 que significa barra de titulo (1) + boto de fechar (2) + mvel (64) + centralizada (2048).

122

Sc ripts

12.No evento OnPreShow da TelaComando insira o seguinte script:


Item("ComandoBomba1").Fonte = Arg

13.Busque, com o auxlio do AppBrowser , o XControl ComandoBomba1 que est dentro da TelaComando e direita selecione a propriedade Fonte. 14.Digite " = Arg".

11.6 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

11.6.1 Tecla ESC


Ao apertar a tecla ESC no teclado quanto estiver na TelaInicial, sair do Viewer. 1. Na TelaInicial, criar o seguinte script no evento KeyDown.
'ESC: Sair do Viewer If KeyCode = 27 Then Application.Exit() End If

11.6.2 KB
KB-14026: Como utilizar as teclas Fx (F1, F2, F3, etc.) do teclado para executar um script.

Sc ripts

123

11.7 Anotaes

124

Sc ripts

12

CAPTULO

Segurana

O E3 possui um controle de acesso a Telas, Alarmes e Domnios em uma lista de usurios, onde para cada nome atribudo uma senha e um login. Conforme a opo configurada, o sistema permitir acesso aos usurios cadastrados ou acesso ilimitado s Telas do projeto.

Seguran a

125

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

126

Seguran a

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

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

Seguran a

127

Aba Grupos

12.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 128 Seguran a

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

129

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

130

Seguran a

Proteo de arquivo Esta opo possui dois tipos de proteo, de Edio e de Execuo. Proteo de Edio: Protege o arquivo contra alteraes e visualizaes no autorizadas. Esse recurso utilizado para evitar que determinada biblioteca ou Seguran a 131

projeto seja alterado acidentalmente, ou que sejam copiados procedimentos de conhecimento especfico do desenvolvedor. O E3 fornece um controle sobre a edio desses arquivos, sejam eles projetos ou bibliotecas. Proteo de Execuo: Esta opo utilizada para proteger um arquivo contra execuo no autorizada. Para tanto, necessrio solicitar a gravao de uma senha de proteo na hardkey, que feita pela Elipse Software. Isso 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 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.

IMPORTANTE: As protees implementadas no podem ser desfeitas caso as senhas sejam perdidas. Portanto, ao proteger determinado arquivo, mantenha as senhas armazenadas de modo seguro. Isso garante que se conseguir usar o arquivo sempre que necessrio.

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

132

Seguran a

12.5.1 Usurios
1. No menu Arquivo, selecione a opo Usurios.

Menu Arquivo - Usurios 2. Acesse a aba Grupos e crie dois grupos de usurios, chamados Administradores e Operadores. 3. Atravs da aba Usurio, crie trs usurios. Cuidado que maisculas e minsculas fazem diferena.

Seguran a

133

Dados do usurio 4. Configure um usurio para pertencer ao grupo Administradores e dois para pertencerem ao grupo Operadores.

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

12.5.3 Login
1. Na TelaMenu, boto Login, crie um novo Pick do tipo Script no evento Click. 2. Busque no AppBrowser o mtodo Login do Viewer e aperte o boto Colar.
Application.Login(true)

12.6 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

12.6.1 Administrao de Usurios


Desejamos criar, apagar e editar usurios em tempo de execuo. Somente usurios configurados como administradores ("Este usurio um administrador") tm acesso a esse recurso. 1. Insira um boto na TelaMenu com o texto "Usurios".

134

Seguran a

2. No boto crie o seguinte script no evento Click.


'Administrao de usurios Application.UserAdministration()

3. Com o auxilio do AppBrowser, busque o mtodo UserAdministration do Viewer.

12.6.2 Permisso por Grupo de Usurios para Objetos de Tela


Algumas vezes desejamos que o operador acesse a Tela mas no visualize ou habilite alguns objetos. Para programarmos essa funcionalidade, primeiro precisamos saber se o usurio pertence ou no ao grupo com restrio. Essa informao varia conforme o usurio logado, lembrando que podemos ter mais de uma estao de visualizao e consequentemente mais de um usurio logado. 1. Clique com o boto direito do mouse no Viewer e insira um tag Interno com o nome de TagAdmin.

TagAdmin 2. No evento OnLogin do Viewer, insira o seguinte script.


'Verificar se o usurio pertence ao grupo Administrador Item("TagAdmin").Value = IsUserMemberOfGroup("Administrador")

3. Na TelaInicial, crie uma Associao na propriedade Visible do texto Entrar com o tag TagAdmin. Somente usurios do grupo Administrador podero visualizar esse objeto.

Seguran a

135

12.6.3 Registro de Eventos


1. Clique com o boto direito do mouse no cone do E3 na rea de Notificao do Windows e acesse a opo Domnio - Opes.

Domnio - Opes 2. Na aba Segurana, configure as opes conforme a figura a seguir.

136

Seguran a

Aba Segurana

NOTA: Configuraes de segurana no sero aplicadas aos usurios j existentes, apenas na alterao ou na criao de um usurio.

3. Acesse a aba Registro de Eventos e configure para registrar os eventos na tabela Eventos em um banco de dados selecionado automaticamente.

Seguran a

137

Aba Registro de Eventos

NOTA: necessrio ter um banco de dados configurado na aplicao.

12.6.4 KB
KB-29426: Como abrir a tela de configurao de usurios em tempo de execuo?

138

Seguran a

12.7 Anotaes

Seguran a

139

13

CAPTULO

Banco de Dados

O Banco de Dados do E3 utilizado para armazenar as informaes do projeto referentes aos Histricos, Frmulas e Alarmes. Possui suporte a MDB (Microsoft Access), Oracle e Microsoft SQL Server. Para utilizar esse recurso, siga estes procedimentos: 1. Clique com o boto direito do mouse sobre o nome do projeto e depois em Inserir Banco de Dados. 2. No caso do banco de dados Access, insira o nome do arquivo desejado (existente ou no) no campo Arquivo MDB. 3. Deixe em branco os campos Usurio e Senha. Estes campos so utilizados somente se o banco de dados especificado para a conexo j possuir usurio e senha. 4. Deixe o campo Senha do DB em branco. Conforme especificado acima, este campo s utilizado caso o banco de dados especificado possua senha do DB. 5. Clique no boto OK para finalizar as configuraes.

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

140

Banc o de Dados

13.1.1 SQL Server Management Studio


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

SQL Server Management Studio 2. Para conectar-se ao banco de dados, necessrio informar o nome do servidor, usurio e senha.

Conectar ao Banco de Dados 3. No campo Server name, clique na Caixa de Seleo e selecione o servidor na lista.

Banc o de Dados

141

Lista de servidores disponveis 4. No campo Authentication, selecione a opo SQL Server Authentication. No campo Login digite "sa" e em Password informe a senha criada para o usurio sa durante a instalao. 5. Clique em Connect. Se todas as informaes estiverem corretas, o Studio se conectar ao servidor de banco de dados.

Conectado ao Servidor de Banco de Dados

142

Banc o de Dados

13.1.1.1 Criao de Banco de Dados


1. Clique com o boto direito do mouse no item Databases e escolha a opo New Database.

Adicionar Novo Banco de Dados 2. No campo Database name digite "TreinamentoE3". Clique no boto OK.

Campo Database Name 3. Verifique se o banco de dados criado aparece na lista de Databases.

Banc o de Dados

143

Banco de Dados TreinamentoE3

144

Banc o de Dados

13.1.2 Banco de Dados


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

Inserir Banco de Dados 2. Escolha o tipo 2 - stSqlServer. 3. Configure os parmetros de conexo.

Banc o de Dados

145

Configurao do Banco de Dados 4. Teste a conexo com o banco de dados.

13.2 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

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

146

Banc o de Dados

13.3 Anotaes

Banc o de Dados

147

14

CAPTULO

Alarmes

O mdulo de Alarmes do E3 consiste basicamente em duas unidades cujo funcionamento interligado logicamente: Servidor de Alarmes: Organiza o modo como os eventos e alarmes sero tratados. Configurao de Alarmes: neste objeto que os alarmes a serem tratados so criados e suas fontes configuradas.

14.1 Servidor de Alarmes


O objeto Servidor de Alarmes centraliza todos os alarmes do projeto. Nele podem ser encontrados os totais de alarmes ativos da aplicao (reconhecidos ou no). Ele tambm o responsvel por reportar os eventos de alarmes para todos os Viewers conectados, bem como, se desejado, enviar esses eventos para um Banco de Dados.

IMPORTANTE: Um Domnio pode ter somente um objeto desse tipo, e a sua presena obrigatria para que haja verificao de alarmes.

Atravs da aba Configurao possvel especificar se os alarmes sero armazenados no Banco de Dados. Os alarmes podem ser visualizados em um E3Alarm ou em um E3Browser, objetos de Tela que sero vistos mais adiante.

14.2 Configurao de Alarmes


O objeto Configurao de Alarmes onde as Fontes de Alarme so criadas. Para inserir esse objeto no projeto, clique com o boto direito do mouse sobre o Organizer, escolha a opo Inserir Configurao de Alarmes em, e em seguida o nome do projeto desejado.

148

Alarmes

14.2.1 rea
O objeto rea permite agrupar um conjunto de Fontes de Alarmes, bem como outras reas de Alarme. Isso facilita o gerenciamento, a operao e o monitoramento de um conjunto de Fontes de Alarmes relacionados, permitindo, por exemplo: Filtrar o conjunto de alarmes visveis no sumrio Habilitar ou desabilitar um conjunto de Fontes de Alarmes 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.

14.2.2 Fontes de Alarme


As Fontes de Alarme definem todas as informaes relativas s condies de alarme. Em cada Fonte de Alarme so configurados seus limites, a mensagem relativa ao evento, sua severidade, bem como a necessidade ou no de reconhecimento desse evento. Todas as Fontes de Alarme possuem as seguintes propriedades gerais:

PROPRIEDADE Texto da Mensagem

DESCRIO 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. Indica a gravidade do alarme ocorrido, podendo ser Baixa, Mdia ou Alta. A severidade utilizada para filtragem e ordenao de mensagens. Indica que o alarme deve ser reconhecido pelo operador para ser retirado da lista de alarmes no E3Alarm, ou ainda se reconhecido automaticamente quando a varivel deixa uma condio de alarme. Sempre que uma Fonte de Alarme sai da condio de alarme, essa mensagem ser exibida nos objetos de visualizao.

Severidade

Pede Ack

Mensagem de Retorno

Alarmes

149

H vrios tipos de Fontes de Alarme que podem ser inseridas na rea de Alarme.

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

Fonte de Alarme Analgico

150

Alarmes

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

Fonte de Alarme Digital

Alarmes

151

14.2.2.3 Banda Morta


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

Fonte de Alarme Banda Morta

152

Alarmes

14.2.2.4 Taxa de Variao


Permite monitorar variaes muito rpidas em uma varivel do processo. A Fonte de Alarme Taxa de Variao usa seus valores especificados em unidades da varivel por segundo.

Fonte de Alarme Taxa de Variao

Alarmes

153

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

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

154

Alarmes

Aba Geral

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

14.4.1 Servidor de Alarmes


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

Alarmes

155

Inserir Servidor de Alarmes 2. Acesse as propriedades do Servidor de Alarmes, e na aba Configurao habilite a opo Guarde alarmes no banco de dados. 3. Na opo Utilize o servidor de banco de dados, escolha BancoDados. 4. Habilite a opo Descarta dados da tabela principal. Mantenha os dados dos ltimos 3 meses A verificao deve ocorrer a cada 1 ms

5. Clique no boto Campos e selecione os campos que desejar. Para o correto funcionamento com o E3PlayBack, insira os campos: EventTimeDbl FullAlarmSourceName

156

Alarmes

ConditionActive Acked AckRequired

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

Gerar estrutura da tabela

Alarmes

157

14.4.2 Configurao de Alarmes


1. Insira no projeto um objeto Configurao de Alarmes.

Inserir Configurao de Alarmes

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

158

Alarmes

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

6. Copie o Alarme Tanque1 para criar o Alarme Tanque2. 7. Associe o Alarme Tanque2 ao tag Nivel2 e altere as mensagens do Alarme.

Associao dos Alarmes com os Tags

Alarmes

159

14.4.4 Alarme Banda Morta


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

Alarme Banda Morta 6. Copie o Alarme Tanque1 para criar o Alarme Tanque2. 7. Associe o Alarme Tanque2 ao tag Temp2 e altere as mensagens do Alarme.

160

Alarmes

Associao dos Alarmes com os Tags

14.4.5 Alarme Digital


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

Alarme Digital Defeito 4. Associe ao Alarme Defeito a propriedade Defeito do objeto. 5. Acesse as propriedades do Alarme Defeito, aba Digital: Marque a opo Alarme Digital. Escolha a opo True em Valor de Alarme.

6. Para que nas mensagens de Alarme e retorno aparea o nome da bomba, crie as Associaes vistas na prxima figura.

Alarmes Digitais

Alarmes

161

14.4.6 E3Alarm
A visualizao dos Alarmes em tempo real pode ser feita atravs do objeto E3Alarm. 1. Posicione um objeto E3Alarm na TelaAlarmes.

2. Nas propriedades do E3Alarm, aba Geral, informe o nome do Servidor de Alarmes.

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

162

Alarmes

Propriedade AlarmServer 4. Acesse as propriedades do E3Alarm. Na aba Colunas, selecione os campos DataHora , Operador, Mensagem, Reconhecido e Valor. 5. Na aba Cores faa a configurao que desejar. 6. Execute a aplicao e confira as funcionalidades.

14.5 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

14.5.1 Reconhecer Todos os Alarmes


Vamos criar um boto onde possvel reconhecer todos os alarmes ativos. 1. Na TelaAlarmes, crie um boto com o texto "Reconhecer". 2. No boto, crie o seguinte script no evento Click.
'Reconhecer todos os alarmes Screen.Item("E3Alarm1").AckAll(Application.User)

3. Busque, com o auxlio do AppBrowser, na TelaAlarmes o objeto E3Alarms1 e direita o mtodo AckAll.
Screen.Item("E3Alarm1").AckAll([Operator])

Alarmes

163

4. Substitua o parmetro Operator pelo nome do usurio logado no Viewer. Com o auxlio do AppBrowser busque a propriedade User do Viewer.

14.5.2 KB
KB-29110: possivel gerar um beep no speaker do PC quando entrar um alarme? KB-29053: Tocar um som quando entrar um alarme.

164

Alarmes

14.6 Anotaes

Alarmes

165

15

CAPTULO

Consultas

O objeto Consulta (ou Query) auxilia no processo de definio de consultas no Banco de Dados da aplicao. Toda vez que o E3 necessita buscar dados do Banco de Dados necessrio enviar um comando, de forma que se saiba quais os dados desejados para aquele objeto. Para essa busca, toda vez que uma aplicao precisar gravar ou buscar dados armazenados em um Banco de Dados, so enviados comandos no formato SQL ( Structured Query Language). A Consulta apresenta uma interface amigvel que permite a construo de consultas SQL usando uma interface grfica e o acompanhamento imediato do cdigo SQL gerado. A Consulta permite mostrar os dados dos ltimos n dias, horas ou meses, data inicial e final e consultas, dependendo do filtro a ser implementado. O assistente de configurao da Consulta responsvel por criar o texto que faz o filtro ou a consulta, no sendo necessrio para o usurio saber detalhes como data, etc. Para utilizar esse recurso, clique com o boto direito do mouse sobre a Tela do projeto e selecione a opo Inserir - Consulta.

NOTA: Quando se cria um objeto Relatrio ou um E3Browser, o objeto Consulta adicionado a este automaticamente. No entanto, tambm se pode inserir uma Consulta em uma Pasta de Dados ou em uma Tela e utilizar seus dados atravs de scripts.

166

Consultas

15.1 Criando uma Consulta


1. A definio da Consulta comea quando o usurio informa o Servidor de Banco de Dados onde a Consulta ir buscar os dados.

Definir o Servidor de Banco de Dados 2. Aps ser definido o Banco de Dados, uma nova janela aparecer com as tabelas que foram encontradas, permitindo a sua seleo.

Consultas

167

Seleo de tabelas 3. Selecione as tabelas que faro parte da Consulta e clique no boto Adicionar. 4. Na aba Campos, sero adicionados os campos a serem retornados pela Consulta, bem como definidos filtros e ordenaes. 5. Na aba Variveis, so mostradas as variveis criadas para os filtros. 6. Na aba Visualizar, pode-se realizar uma prvia da Consulta. 7. Na aba SQL, pode-se visualizar e editar o cdigo SQL.

168

Consultas

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

15.1.1 Criando e Acessando Variveis


Na janela de configurao da Consulta, pode-se adicionar filtros diretamente nos campos. Estes filtros podem ser constitudos de variveis que sero definidas por script utilizando o mtodo SetVariableValue da Consulta. A forma de declarar as variveis depende do tipo de dado que elas representam, como vemos a seguir: Nmero: <%Nome_da_Variavel%> String: '<%Nome_da_Variavel%>' Data e hora: #<%Nome_da_Variavel%>#

Consultas

169

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

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

170

Consultas

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

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

15.3.1 E3Browser
1. Insira um E3Browser na TelaEventos.

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

Consultas

171

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

Tabela Alarms 7. Acesse a aba Visualizar e clique no boto Executar Consulta resultado da Consulta. para verificar o

172

Consultas

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.

Configurao da Consulta

15.3.2 Filtro na Consulta


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

Consultas

173

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

3. Busque, com o auxlio do AppBrowser aperte o boto Colar.

, o mtodo ShowDatePicker do Viewer e

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 ou a coordenada que desejar abrir o calendrio. 6. O parmetro DateValue deve ser substitudo por uma varivel interna de script. Chamaremos essa varivel de DataHora. 7. O mtodo ShowDatePicker retorna verdadeiro se o usurio apertar o boto OK e falso se apertar o boto Cancelar. Somente se apertar o boto OK que devemos passar o valor do calendrio para o Setpoint. Digite "If" no comeo da linha do comando ShowDatePicker e "Then" no final.
If Application.ShowDatePicker(DataHora, 0, 0) Then

8. Para passar a data do calendrio para o Setpoint, digite na prxima linha o texto a seguir.
Value = DataHora

9. Como estamos escrevendo o script no Setpoint e desejamos referenciar a sua 174 Consultas

propriedade Value, podemos digitar diretamente o nome da propriedade sem ser obrigatrio o caminho completo. 10.Finalize o script digitando "End If". 11.Acesse o objeto Consulta do E3Browser. Isso pode ser feito executando um duploclique no objeto pelo Organizer ou pela aba Consulta do E3Browser.

Consulta do E3Browser 12.Na coluna Filtro do campo E3TimeStamp, clique no boto .

13.Para o usurio poder escolher a data inicial e a data final, precisamos criar variveis de consulta. Configure o filtro conforme a figura a seguir.

Configurando o Filtro 14.Digite um valor inicial para as variveis criadas na aba Variveis.

Consultas

175

Variveis da Consulta 15.Acesse a aba Visualizar e clique no boto Executar Consulta para verificar o resultado da Consulta. Certifique-se que o filtro foi aplicado e clique no boto OK. 16.Na TelaEventos, embaixo dos Setpoints, crie um boto Consultar, e insira um novo script no evento Click com as seguintes linhas.
'Referencia os Setpoints DataIni = Screen.Item("spDataInicial").Value DataFim = Screen.Item("spDataFinal").Value Set consulta = Screen.Item("E3Browser1").Item("Consulta1") 'Configura as variveis da Consulta consulta.SetVariableValue "DataInicial", DataIni consulta.SetVariableValue "DataFinal", DataFim

17.Digite a varivel interna de script "DataIni = ". 18.Busque, com o auxlio do AppBrowser, o Setpoint spDataInicial e direita sua propriedade Value.
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

176

Consultas

20.Busque, com o auxlio do AppBrowser, a Consulta1 que est dentro do E3Browser1. direita selecione o mtodo SetVariableValue.
Screen.Item("E3Browser1").Item("Consulta1").SetVariableValue(VarName, Value)

21.Quebre a linha aps ("Consulta1").


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

22.Digite no comeo da linha o texto "set consulta = ". Desse modo criamos uma varivel interna de script que referencia o objeto Consulta.
Set consulta = Screen.Item("E3Browser1").Item("Consulta1")

23.No incio da linha que contm o mtodo SetVariableValue digite "consulta.".


consulta.SetVariableValue(VarName, Value)

24.O parmetro VarName referencia o nome da varivel criada na Consulta. Digite "DataInicial". 25.No parmetro Value informe o valor que deseja passar para a varivel. No caso, desejamos passar o valor do Setpoint que referenciamos atravs da varivel interna DataIni.
consulta.SetVariableValue "DataInicial", DataIni

26.Remova os parnteses do mtodo SetVariableValue. 27.Copie a linha para implementar a mesma lgica para a varivel DataFinal.
consulta.SetVariableValue "DataFinal", DataFim

28.Compile o script e teste.

15.4 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

15.4.1 KB
KB-20214: Funo SQL para calcular o mximo, o mnimo e a mdia.

Consultas

177

15.5 Anotaes

178

Consultas

16

CAPTULO

Histricos

Os Histricos so os mdulos responsveis pelo armazenamento de dados da aplicao em Banco de Dados. Permitem armazenar dados de processos para anlises futuras, no E3 ou em qualquer outra ferramenta. Podem-se criar tantos arquivos de Histrico quantos se desejar, cada um contendo diversos tags ou expresses. Cada Histrico pode criar ou utilizar uma tabela independente dentro do Banco de Dados, cujo armazenamento pode ser definido por Tempo ou por Evento. possvel ainda determinar qual Banco de Dados inserido no projeto ser utilizado para o armazenamento dos dados. Para utilizar esse recurso, clique com o boto direito do mouse no nome do projeto no Explorer e selecione a opo Inserir - Histrico. Para criar a tabela no Histrico, importante criar seus campos. Tais campos podem ser criados atravs do boto (Adicionar um campo). Para remover algum campo indesejado, clique no boto (Remover os campos).

Histrico

16.1 Chave Primria


A Chave Primria um campo ou um conjunto de campos que identifica de maneira nica cada registro de uma tabela. Assim como o ndice principal para a tabela, ela utilizada para associar dados entre tabelas. Aps ter definido um campo como sendo a chave primria da tabela, o prprio Banco de Dados garante que no sejam inseridos dados duplicados no(s) campo(s) que seja(m) chave(s) primria(s). H dois tipos de chave primria, a Simples e a Composta. Uma Chave Primria Simples um campo que identifica de modo nico cada registro de uma tabela. Uma Chave

Histric os

179

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 primria da tabela. Ao escolher campos de Chave Primria, considere os seguintes detalhes: No permitida duplicidade de valores ou valores nulos. Caso no exista um identificador nico para uma determinada tabela, pode-se usar um campo que numere os registros sequencialmente. A chave primria pode ser configurada de duas formas. Verificando na Tela do Histrico o campo da tabela que se deseja tornar Chave Primria e habilitando-a atravs do boto , ou clicando no cone , que abrir a tela de configurao.

16.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 configurao, ilustrada a seguir. , que abre a tela de

180

Histric os

Editor de ndices

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

Histric os

181

16.3.1 Histrico
1. Clique com o boto direito do mouse no item Banco de Dados e insira um novo Histrico no projeto TreinamentoE3, nomeando-o como HistNivel.

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

Configurao dos campos 3. Clique sobre a opo Propriedades do Histrico seguintes propriedades: , e na aba Histrico configure as

182

Histric os

Banco de dados: BancoDados Tabela: Nivel Tempo de gravao: 2000 ms

4. Clique sobre o boto Gerar Tabela. Deve aparecer a mensagem "A estrutura de tabelas foi criada com sucesso".

Mensagem de sucesso ao gerar tabela

16.4 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

16.4.1 KB
KB-24714: Limite de campos de um Histrico.

Histric os

183

16.5 Anotaes

184

Histric os

17

CAPTULO

E3Chart

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

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

E3Chart

185

17.1 Configuraes das Penas


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

186

E3Chart

Propriedades da Pena

E3Chart

187

17.1.1 Pena de Tempo Real


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

17.1.2 Pena Histrica


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

17.1.3 Pena de Tempo Real e Histrica


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.

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

17.2.1 E3Chart
1. Posicione um E3Chart na TelaGrafico.

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

188

E3Chart

Propriedades da Pena 4. Na aba Dados, deixe a opo Tipo de pena em Tempo Real. 5. Na opo Link do eixo vertical, selecione a propriedade Value do tag Nivel1 da pasta Dados.

Dados da Pena 6. Repita os dois ltimos tens para criar a Pena Nivel2 associada ao tag Nivel2 e clique no boto OK.

E3Chart

189

17.2.3 Escala
Os maiores valores so do tag Nivel, que varia de 0 a 100, ento vamos alterar a escala vertical para exibir os valores nessa faixa. 1. Na aba Eixos selecione o EixoVertical e aperte o boto Configurar. 2. Na aba Escala, configure os limites da escala numrica entre 0 e 100.

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

17.2.5 Visibilidade das Penas


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

190

E3Chart

Propriedade Visible da Pena 3. Complete a linha do script com o cdigo a seguir.


Screen.Item("E3Chart1").Pens.Item("Nivel1").Visible = Value

4. Busque, com o auxlio do AppBrowser, o E3Chart que est dentro da TelaGrafico, coleo Pens, Pena Nivel1, e direita selecione a propriedade Visible. Aperte o boto Colar. 5. Digite " = Value". Como estamos escrevendo o script na Caixa de Seleo, ao digitar "Value" fazemos referncia ao valor do prprio objeto. 6. Configure o valor inicial (Value) da Caixa de Seleo para True. 7. Repita o procedimento para a Pena Nivel2.

E3Chart

191

17.2.6 E3Chart Histrico


1. Acesse as propriedades do E3Chart, aba Consultas. 2. Clique no boto Adicionar. Selecione o BancoDados no campo Nome do Servidor e a seguir escolha a tabela Nivel. 3. Selecione os campos E3TimeStamp, Nivel1 e Nivel2. 4. Visualize o resultado da Consulta na aba Visualizar e clique em OK. 5. Na aba Penas, selecione a pena Nivel1 e acesse suas propriedades. 6. Modifique a opo Tipo de pena para Tempo Real & Histrica. A parte histrica ser habilitada. 7. Na seo Parte Histrica, preencha os dados a seguir. Consulta local: Consulta1 Campo do eixo vertical: Nivel1 Campo do eixo horizontal: E3TimeStamp

192

E3Chart

Dados da Pena 8. Repita o procedimento para a pena Nivel2.

17.2.7 Eixo Horizontal Histrico


Para navegarmos pelo grfico consultando dados antigos, o eixo horizontal deve estar configurado como do tipo Histrico. 1. Acesse as propriedades do E3Chart, aba Eixos. 2. Selecione o EixoHorizontal e clique no boto Configurar. 3. Na aba Escala, escolha a opo Intervalo de tempo (histrico).

E3Chart

193

Intervalo de tempo 4. Escolha um intervalo inicial pequeno (cinco minutos), assim a Tela ser carregada rapidamente.

17.2.8 Intervalo do Grfico


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

Data inicial e final 2. No Setpoint com a data inicial, crie uma Associao Bidirecional com a propriedade HorScaleBegin do E3Chart.

Associao Bidirecional 3. No Setpoint com a data final, crie uma Associao Bidirecional com a propriedade HorScaleEnd do E3Chart.

17.3 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

194

E3Chart

17.3.1 Minutos Recentes


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

2. Busque, com o auxlio do AppBrowser, o E3Chart dentro da TelaGrafico e direita a propriedade HorScaleBegin. 3. Digite " = Now - 10 / 1440". 4. Busque, com o auxlio do AppBrowser, o E3Chart dentro da TelaGrafico e direita a propriedade HorScaleEnd. 5. Digite " = Now".

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

E3Chart

195

17.4 Anotaes

196

E3Chart

18

CAPTULO

Relatrios

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

Sees do Relatrio Um Relatrio estruturado da seguinte forma: Estrutrura do Relatrio SEO DESCRIO

Relatrios

197

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. 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. Esta seo impressa no topo de cada pgina do Relatrio. a primeira seo impressa na pgina, exceto quando essa pgina contm a seo ReportHeader. Utilizada para imprimir cabealhos de colunas, nmeros de pginas, ttulos de pginas ou qualquer outra informao que necessite ser impressa no incio de cada pgina. Esta seo impressa uma vez na base de cada pgina no Relatrio. Usada para imprimir totais de pginas, nmeros de pginas ou qualquer outra informao que necessite ser impressa uma vez na base de cada pgina. Esta seo o corpo do Relatrio que imprime uma vez para cada registro da fonte de dados. Um Relatrio pode ter mltiplos grupos aninhados. Cada grupo possui uma seo Header e uma seo Footer. A seo Header impressa antes de qualquer seo Detail no grupo. A seo Footer impressa depois da seo Detail do grupo.

Report Footer

Page Header

Page Footer

Detail

Group Header, Group Footer

A barra de ferramentas Relatrio contm trs itens de configurao que permitem editar, visualizar o Relatrio e criar scripts. Estes itens so os seguintes: Prvia de Impresso (Preview): Atravs desta opo, possvel visualizar uma prvia da impresso do Relatrio. Assim possvel verificar configuraes de margem, figuras, etc. Configuraes do Relatrio (Report Settings): Nestas configuraes, pode-se determinar Configuraes de Pgina, Configuraes de Impresso, Configuraes da Grade e Estilo do Relatrio. Editor de Scripts: Atravs desta opo, possvel editar scripts para o Relatrio.

198

Relatrios

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.

18.1 Objetos do Relatrio


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

Barra de Ferramentas Relatrio Atravs da barra de ferramentas Relatrio, possvel acessar os recursos disponveis desta opo: Linha: Objeto bsico de reta que liga dois pontos quaisquer. Permite o desenho de retas, atravs de dois pontos especificados na sua criao ou em polgonos. Retngulo: Este objeto permite o desenho de retngulos, utilizando toda a largura ou altura do objeto. Criado a partir de dois vrtices. Retngulo Arredondado: Retngulo criado atravs de dois vrtices com a opo dos cantos serem arredondados a partir de um fator de arredondamento. Ao ser inserido ou editado, exibe um pequeno ponto prximo ao canto superior esquerdo do objeto, que permite modificar o fator de arredondamento. Elipse: Este objeto permite o desenho de crculos e elipses, utilizando toda a largura ou altura e definindo o centro do crculo no centro do retngulo. Figura: Este objeto permite mostrar imagens que estejam armazenadas em arquivos, estejam elas dentro ou fora do arquivo do aplicativo. Texto: Possibilita a criao de um texto. Ao definir a rea na Tela, pode-se digitar diretamente o texto desejado, que aceita tambm mltiplas linhas. Setpoint: Atravs do objeto Setpoint, possvel associar um campo da tabela no Banco de Dados. Este campo especificado na propriedade DataField. Cdigo de Barras: Permite gerar uma figura que converte uma sequncia de nmeros e caracteres em um cdigo de barras. Este cdigo uma representao numrica ou alfanumrica, utilizada para facilitar diferentes processos. Esse cdigo decifrado atravs de scanners, canetas e equipamentos de leitura ptica.

Relatrios

199

Quebra de Pgina: um ponto em que uma pgina termina e outra comea no Relatrio. Por exemplo, pode-se forar uma quebra de pgina para assegurar que o ttulo de um captulo comece sempre em uma nova pgina. Tabela: um objeto composto por linhas e colunas ondes so inseridos textos ou grficos. As tabelas nos Relatrios so usadas para organizar e apresentar a informao. Pode-se tambm usar tabelas para criar layouts de pgina. E3Chart: Este objeto utilizado para visualizar os dados do Relatrio em formato grfico. Maiores informaes esto descritas no captulo sobre o E3Chart. / Enviar para frente / Enviar para trs: Atravs destes botes, possvel enviar um objeto para frente ou para trs de outro. Ao escolher as opes Enviar para frente ou Enviar para trs, o objeto selecionado ser colocado na primeira ou na ltima posio na ordem de sobreposies. Carregar Arquivo RPX: Importa a configurao do Relatrio de um arquivo externo. Salvar Arquivo RPX: Exporta a configurao do Relatrio para um arquivo externo.

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

18.2 Exerccios
Ser feito um Relatrio onde ser impresso o grfico da Tela e em seguida todos os dados exibidos no grfico. 1. Clique com o boto direito do mouse no projeto e insira um objeto Relatrio. Renomeie para RelatorioGrafico. 2. No objeto Consulta1 do Relatrio, clique com o boto direito do mouse e escolha a opo Configurar.

200

Relatrios

Configurar Consulta 3. Consulte todos os campos que no terminem com "_Quality" da tabela Nivel. 4. Crie um filtro para o campo E3TimeStamp conforme a figura a seguir.

Configurar Filtro 5. Teste a Consulta informando valores para as variveis criadas.

Relatrios

201

18.2.1 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 no PageHeader e configure-os com o nome dos campos. Estes sero os ttulos das colunas.

Seo Page Header

18.2.2 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 nvel. 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.

Seo Detail 2. Para visualizar o Relatrio, pressione o boto Gerar Relatrio .

18.2.3 Page Footer


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

18.2.4 Report Header e Footer


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

Relatrios

203

Inserir Report Header e Footer 2. Na seo ReportHeader insira um E3Chart. O E3Chart no precisa ser configurado, pois copiar as configuraes de outro E3Chart. 3. Acesse o Editor de Scripts pelo boto .

4. No campo Object, escolha ReportHeader e no campo Events escolha OnBeforePrint. 5. Entre os textos "Sub OnBeforePrint" e "End Sub" digite o seguinte script.
Set Chart = Report.Sections("ReportHeader").Controls("E3Chart1") Set ChartTela = Application.GetFrame("Central").Screen.Item("E3Chart1") Chart.CopyConfig(ChartTela) Chart.LoadData()

6. Na seo ReportFooter, insira um objeto Campo de Dados e configure a propriedade DataField com o caminho de HoraAtual da pasta Dados, Dados. HoraAtual. 7. Insira um segundo Campo de Dados e configure-o para exibir o nome do usurio logado no Viewer.

Propriedade DataField 8. Insira dois objetos Texto, "Relatrio gerado" e "pelo usurio" conforme a figura a seguir.

204

Relatrios

Seo Report Footer

18.2.5 Imprimir
1. Para visualizar o Relatrio em tempo de execuo, insira na TelaGrafico um Boto de Comando com o texto "Imprimir". 2. No evento Click da figura da impressora, crie o script a seguir.
' Imprime o Relatorio ' Intervalo de data DataIni = Screen.Item("E3Chart1").HorScaleBegin DataFim = Screen.Item("E3Chart1").HorScaleEnd Set Report = Application.LoadReport("RelatorioGrafico") Set Consulta = Report.Item("Consulta1") Consulta.SetVariableValue "DataInicial", DataIni Consulta.SetVariableValue "DataFinal", DataFim Report.PrintPreview()

3. Digite "DataIni = " para criar a varivel interna de script que guardar a data inicial do grfico. 4. Com o auxlio do AppBrowser, busque o E3Chart dentro da TelaGrafico e direita selecione a propriedade HorScaleBegin.
DataIni = Screen.Item("E3Chart1").HorScaleBegin

5. Crie a varivel interna DataFim, referenciando a propriedade HorScaleEnd do grfico.


DataFim = Screen.Item("E3Chart1").HorScaleEnd

6. Com o auxilio do AppBrowser, acesse Tarefas - Carregar o relatrio - RelatorioGrafico Consulta1 e direita selecione o mtodo SetVariableValue.
Set Report = Application.LoadReport("RelatorioGrafico") Report.Item("Consulta1").SetVariableValue(VarName, Value)

7. Quebre a linha aps ("Consulta1") e no incio digite "set consulta= ".

Relatrios

205

Set Report = Application.LoadReport("RelatorioGrafico") Set consulta = Report.Item("Consulta1")_ .SetVariableValue(VarName, Value)

8. No incio da linha do mtodo SetVariableValue, digite "consulta." e substitua o parmetro VarName por "DataInicial" e o parmetro Value por "DataIni".
Consulta.SetVariableValue "DataInicial", DataIni

9. Remova os parnteses do mtodo SetVariableValue e copie a linha. 10.Repita o comando SetVariableValue substituindo o parmetro VarName por "DataFinal" e o parmetro Value por "DataFim".
Consulta.SetVariableValue "DataFinal", DataFim

11.Com o auxlio do AppBrowser, acesse Tarefas - Carregar o relatrio - RelatorioGrafico e direita o mtodo PrintPreview. 12.Apague a linha que faz referncia ao Report, pois j o declaramos no incio do script.
Report.PrintPreview()

13.Teste o mtodo Imprimir(PrintPreview). S podem ser impressos os dados dentro do intervalo especificado na escala horizontal do grfico.

18.2.6 Exportar
Para o usurio escolher o nome e diretrio do arquivo que ser gerado, abriremos uma caixa de dilogo. 1. Copie o boto Imprimir da TelaGrafico e altere o texto para "Exportar". 2. Substitua a ltima linha (Report.PrintPreview) para:
'Exportar ' Intervalo de data DataIni = Screen.Item("E3Chart1").HorScaleBegin DataFim = Screen.Item("E3Chart1").HorScaleEnd Set Report = Application.LoadReport("RelatorioGrafico") Set Consulta = Report.Item("Consulta1") Consulta.SetVariableValue "DataInicial", DataIni Consulta.SetVariableValue "DataFinal", DataFim If Application.ShowFilePicker(False, NomeArquivo,"pdf", 128, "Arquivos PDF|*. pdf|Todos os arquivos|*.*") Then Report.Export "PDF", NomeArquivo End If

206

Relatrios

3. Apague a linha Report.PrintPreview. 4. Com o auxlio do AppBrowser, busque o mtodo ShowFilePicker do Viewer.
Application.ShowFilePicker(Open, FileName, Extension, Flags, Filter)

5. Como desejamos salvar um arquivo, substitua o parmetro Open para False. 6. O parmetro FileName deve ser uma varivel interna de script que armazenar o nome do arquivo. Substitua-o por "NomeArquivo". 7. Caso no seja informada a extenso do arquivo, ser considerado como padro o que for informado no parmetro Extension. Digite "pdf". 8. Para uma mensagem de confirmao aparecer para o usurio caso o arquivo j exista, altere o parmetro Flags para 128. 9. As caixas de dilogo de arquivos permitem filtros para facilitar a busca por tipos de arquivos.

Tipos de Arquivos 10.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. 11.Substitua o parmetro Filter por "Arquivos PDF|*pdf | Todos os arquivos| *.*". 12.O arquivo s pode ser gerado se o usurio apertar o boto Salvar. Se o usurio cancelar a ao, nada deve acontecer. No incio do comando ShowFilePicker, digite "If" e no final digite "Then". 13.Para exportar o Relatrio busque, com o auxilio do AppBrowser, o item Tarefas Carregar o relatrio - RelatorioGrafico e direita o mtodo Export.
Set Report = Application.LoadReport("RelatorioGrafico") Report.Export([ExportFilter], [ExportFileName])

14.Apague a linha que faz referncia ao Report pois j o declaramos no incio.

Relatrios

207

15.Substitua o parmetro ExportFilter por "PDF" e o parmetro ExportFileName pela varivel NomeArquivo criada anteriormente. 16.Teste as novas funcionalidades da aplicao.

18.3 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

18.3.1 Group Header e Footer


Um Relatrio pode ter mltiplos grupos. Cada grupo possui uma seo Header e uma seo Footer. A seo Header imprime antes de qualquer seo Detail no grupo. A seo Footer imprime depois da seo Detail do grupo. Atravs do GroupFooter vamos mostrar as estatsticas de cada grupo separadas por coluna: soma de todos os dados, os valores mximo e mnimo que foram armazenados e a mdia. 1. Clique com o boto direito do mouse no fundo do Relatrio e escolha Insert - Group Header/Footer. Essa opo insere um novo grupo no Relatrio.

Inserir Group Header e Footer 2. Na propriedade DataField do GroupHeader1, escreva a expresso ou campo pelo qual deseja agrupar os dados. Nossos dados sero agrupados por minutos.

208

Relatrios

Propriedade DataField 3. Copie os Campos de Dados da seo Detail para a seo GroupFooter1.

Seo GroupFooter 4. frente dos Campos de Dados dos nveis, insira um texto fixo com a palavra "Mximo".

Campo de Dados Mximo 5. Para calcular o valor mximo dos nveis, modifique em todos os Campos de Dados de nvel no GroupFooter1 as seguintes propriedades:

Propriedades do GroupFooter 6. A propriedade SummaryGroup deve informar o nome do GroupHeader que contm os dados que devem ser considerados para o clculo. No caso, quer-se que seja retornado o valor mximo dos dados para o minuto em questo. 7. Crie mais duas cpias dos Campos de Dados para calcular o valor mnimo e a mdia, e modifique a propriedade SummaryFunc para 3 - ddSFMin e 1 - ddSFAvg, respectivamente.

Valor mnimo e mdia

Relatrios

209

18.3.2 KB
KB-27491: Exibindo a hora atual em um Relatrio.

210

Relatrios

18.4 Anotaes

Relatrios

211

19
Storage
O Storage um mdulo historiador do E3 desenvolvido para aperfeioar o uso de bancos de dados, fazendo com que uma determinada informao seja armazenada ocupando o menor espao possvel. Existe todo um conjunto de funcionalidades especficas para este mdulo, como consultas pr-construdas e algoritmos de compactao de dados, entre outros. Atravs desta ferramenta possvel recuperar com grande exatido todas as mudanas nas variveis de processo, ocupando assim o mnimo de espao no banco de dados. O uso do Storage fortemente recomendado para processos onde o objetivo do registro seja o acompanhamento de tendncias que necessitem manter informaes essenciais ao processo. Atravs de um algoritmo matemtico bastante difundido, o Storage pode fornecer informaes relevantes de um determinado processo ocupando menos espao em disco do que os dados gravados por um Histrico gravado periodicamente. Em processos onde os dados devem ser precisos, como medies usadas para faturamento de insumos (gua, energia ou gs), ou processos onde os dados devem ser integralizados em um perodo, o uso de Histricos convencionais o recomendado.

CAPTULO

19.1 Funcionamento
A gravao no Storage feita da seguinte maneira: Aps a definio da tabela, os dados so gravados de acordo com as configuraes. Se houver variao de qualidade no tag, os dados tambm sero gravados. Os dados s no sero gravados se a variao ocorreu num tempo menor do que o mnimo programado.

Conforme forem sendo obtidos novos valores para as variveis, um algoritmo de verificao de gravao vai interpretando a sequncia e decidindo se cada ponto ser ou no armazenado. 212 Storage

Esta verificao, entretanto, s ocorre para os campos analgicos. Para os campos de texto e digitais basta que haja uma mudana qualquer de valor ou de qualidade para que sejam gravados. Para cada tipo de grandeza armazenada, gerado automaticamente um conjunto de tabelas, um para os tags analgicos, outro para os textos e um terceiro para os digitais. Dessa forma, cada Storage pode gerenciar at sete tabelas (backup), caso se especifique que os trs tipos de tags devem ser armazenados:
<NomeTabela>_Fields <NomeTabela> <NomeTabela>_Text <NomeTabela>_Bit

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

213

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.

214

Storage

19.3.2 ArchivedValue
Retorna um valor armazenado em relao a um determinado instante de tempo definido na varivel TimeStamp. O tipo de relao pode ser: Previous: valor armazenado imediatamente anterior ao timestamp fornecido. Next: valor armazenado imediatamente posterior ao timestamp. Interpolated: valor calculado a partir do valor anterior e posterior. ExactTime: valor armazenado no exato instante que foi fornecido pelo timestamp.

19.3.3 TagAttribute
Retorna um atributo do tag, que pode ser: FieldDescription: significado ou descrio do tag FieldSource: caminho do tag que est sendo armazenado FieldType: tipo de dado (Double, Boolean ou String) FieldEU: unidades de engenharia FieldLowEng: limite inferior FieldHighEng: limite superior FieldDeadBand: banda morta para gravao FieldDeadBandUnit: unidade da banda morta (absoluta ou porcentagem) FieldMinRecTime: tempo mnimo para gravao FieldMaxRecTime: tempo mximo para gravao

Storage

215

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.

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 atravs do PenGroup e o Storage com os dados das bombas ser utilizado pelo PlayBack.

216

Storage

19.4.1 Temperatura
1. Insira um objeto Storage no projeto. Altere o nome para StorageTemp.

Inserir Storage 2. No objeto StorageTemp, insira dois campos e configure-os como na figura a seguir.

Configurao dos campos 3. Clique sobre a opo Propriedades Banco de dados: BancoDados Tabela: Temperatura e configure as seguintes opes.

4. Clique sobre o boto Gerar Tabela. Deve aparecer a mensagem da figura a seguir. Storage 217

Estrutura criada com sucesso

19.4.2 DadosBomba
1. No XObject DadosBomba insira um Storage. Chame de StorageBomba.

Inserir Storage 2. Adicione no StorageBomba as propriedades Automatico, Defeito e OnOff do objeto DadosBomba. Configure-as como na tabela a seguir.

218

Storage

Campos do Storage 3. Clique sobre o boto Propriedades Banco de dados: BancoDados Tabela: Bombas e configure as seguintes opes:

NOTA: Quando o Storage est inserido em um XObject, a estrutura da tabela ser gerada quando a aplicao for executada.

19.5 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

19.5.1 KB
KB-31955: Storage s est funcionando com Hardkey de Studio.

Storage

219

19.6 Anotaes

220

Storage

20

CAPTULO

Biblioteca Pen Group

Esta biblioteca tem por objetivo fornecer uma ferramenta de consulta de dados e exibio de grficos, de forma a criar uma maneira mais rpida de realizar a configurao do aplicativo, alm de permitir uma interface mais poderosa de anlise para o usurio final.

20.1 Funcionamento
A Biblioteca PenGroup formada por dois objetos principais, sendo o primeiro a interface grfica, Chart, e o outro um componente de dados chamado PenStorage. O objeto PenStorage permite buscar o contedo de at 50 Histricos ou Storages diferentes, armazenando informaes de todos os tags associados a ele em tabelas, num Banco de Dados SQL Server ou Access. O usurio poder adicionar outros tags inserindo as informaes diretamente nessas tabelas. O objeto Chart, onde o grfico ser plotado, formado por um objeto E3Chart e mais uma barra de ferramentas com as funcionalidades mais usuais da biblioteca. O usurio poder modificar estes objetos livremente de acordo com suas necessidades.

20.1.1 PenStorage
O nome de cada Histrico ou Storage deve ser informado nas propriedades de HistPath1 a HistPath50 presentes no objeto PenStorage (se o Histrico estiver dentro de alguma pasta, o caminho completo at ele deve ser informado), que deve ser inserido numa Pasta de Dados da sua aplicao conforme ser visto posteriormente. Uma aplicao pode lanar mo de um ou mais objetos PenStorage. Cada um deve ser associado a um objeto grfico Chart.

Bibliotec a Pen Group

221

20.1.2 Chart
O objeto Chart composto de um objeto E3Chart e mais uma barra de ferramentas com diversas opes. Dentre as principais caractersticas, possvel mudar: Intervalos de visualizao (incio, fim e intervalo) Imprimir o grfico Exportar para PDF Limpar o grfico Mudar o eixo horizontal para fixo ou rolante Criar ou apagar grupos de Penas Incluir um grid Mover o grfico, navegar pelos pontos, enquadrar penas, zoom Clicar sobre a legenda, na coluna de cor, modificar qualquer atributo da Pena Clicar sobre a legenda, nas outras colunas, exibir e destacar o eixo que est relacionado com a Pena Salvar a configurao das Penas para o grupo

222

Bibliotec a Pen Group

Chart

20.2 Banco de Dados PenGroup


A verso atual do PenGroup pode ser utilizada no SQL Server ou no Access. O desempenho do SQL Server melhor.

Bibliotec a Pen Group

223

20.2.1 SQL Server


1. No SQL Server 2005, abra o SQL Server Management Studio Express (SSMSE) e clique em Abrir. Selecione o arquivo sql2005.sql.

SQL Server Management Studio 2. Selecione o banco de dados master em System Databases. 3. Clique com o boto direito do mouse sobre o banco de dados e acesse suas propriedades. Selecione o item Files e copie o caminho completo do banco de dados.

224

Bibliotec a Pen Group

Propriedades do banco de dados master 4. Com o arquivo sql2005.sql aberto, cole o caminho copiado no passo anterior nas linhas seguintes.

Caminho do banco de dados 5. Clique em Execute. Depois verifique se a seguinte mensagem aparece na parte inferior do SSMSE, "A execuo do DBCC foi concluda". 6. Clique com o boto direito do mouse sobre o item Databases e selecione a opo Refresh.

Bibliotec a Pen Group

225

7. Verifique se o banco de dados PenDB aparece na lista de banco de dados.

Banco de dados PenDB

226

Bibliotec a Pen Group

20.2.2 Access
1. Copie o arquivo PenDB.mdb para o diretrio do seu projeto.

20.3 Configurando a Biblioteca para o E3


1. Copie o arquivo PenGroup.lib para o diretrio do seu projeto. 2. Abra a Lib atravs do E3 Studio e adicione-a ao Domnio. 3. Registre a biblioteca. 4. Numa Pasta de Dados do seu projeto, adicione o objeto PenStorage. 5. Insira o objeto Chart da biblioteca em uma Tela de sua preferncia. 6. Crie em seu projeto um objeto Banco de Dados com o nome de PenDB, e configure a conexo com o banco de dados criado anteriormente (SQL Server ou Access). 7. Crie um grupo de usurios no seu Domnio, com o nome Administradores e associe a ele os usurios que tero permisso para criar e modificar os grupos de Penas pblicos. 8. Preencha os parmetros dos objetos, conforme exposio a seguir.

NOTA: Se for necessrio redimensionar o objeto Chart, pode aparecer uma barra de rolagem na legenda. Neste caso, modifique o tamanho dos campos a serem exibidos dentro do objeto Chart na biblioteca para corrigir eventuais distores.

20.3.1 PenStorage
HistPath1 a HistPath50: Informe aqui o nome ou o caminho de at 50 Histricos ou Storages do seu projeto. A busca pelos Histricos ser interrompida quando for encontrado o primeiro campo HistPathN vazio.

20.3.2 Chart
PenSto: Informe o caminho ou o nome do objeto PenStorage que foi inserido no projeto numa Pasta de Dados.

Bibliotec a Pen Group

227

20.4 Relatrios
Como os Relatrios do E3 no podem ser inseridos dentro da biblioteca, fica a cargo do usurio desenvolver seus prprios Relatrios, garantindo assim a flexibilidade para adaptar-se necessidade de cada um. Como exemplo clssico para a impresso do grfico, basta inserir um Relatrio em seu projeto, adicionando na seo PageHeader, por exemplo, um objeto E3Chart. Deve ser criado um script no Relatrio para copiar a configurao atual do E3Chart que est na Tela e carregar os dados, conforme o exemplo a seguir.
Sub OnBeforePrint Set Chart = Report.Sections("PageHeader").Controls("E3Chart1") Set chartlib = Application.GetFrame().Screen.Item("Chart1") Set OriginChart = chartlib.ChartPointer Chart.CopyConfig(OriginChart) For i = 0 To Chart.Queries.Count - 1 Set Query = Chart.Queries.Item(i) If Query.FunctionType = 4 OR Query.FunctionType = 5 OR Query.FunctionType = 6 Then ' Teste para verificar se uma consulta do E3Storage Query.SetVariableValue "StartTime", Chart.HorScaleBegin Query.SetVariableValue "EndTime", Chart.HorScaleEnd End If Next Chart.LoadData() End Sub

NOTA: Tambm deve ser informado na propriedade ReportPath do objeto Chart o caminho (nome) do Relatrio criado.

20.4.1 Criando a Lista de Tags


Para a utilizao da biblioteca pela primeira vez, necessrio construir a lista de tags para que fiquem disponveis para serem inseridos nos grupos ( necessrio que o usurio do grupo Administradores esteja logado).

Lista de tags Chame a Tela que contm o objeto Chart e clique sobre o boto com a lupa Atualiza Lista de Tags, visto em detalhe na figura anterior. Aparecer uma caixa de dilogo solicitando se deseja recriar a lista ou atualizar, escolha Recriar. A opo Atualizar interessante quando foram modificados parmetros dos tags, que devem ser atualizados na tabela TagDef.

228

Bibliotec a Pen Group

Opo de Recriar ou Atualizar a lista de tags

20.4.2 Criando Grupos


Os grupos podem ser pblicos ou particulares. Para criar ou modificar grupos pblicos, um usurio Administrador deve estar logado. Para criar um novo grupo, digite o nome na caixa de seleo Nome Grupo e clique no boto de Novo Grupo.

Criar novo grupo Os tags podem ser escolhidos por nome ou por descrio e devem ser selecionados na caixa de seleo. Uma vez selecionada a Pena, deve-se clicar no boto Adicionar Pena para adicion-la no Chart. Este procedimento deve ser repetido at que todo o grupo de Penas esteja completo. Se o tag est sendo armazenado num objeto Storage, que um Historiador Otimizado do Processo, esto disponveis as seguintes opes: Gravado: So os valores efetivamente gravados em disco, de acordo com a variao do tag. Amostra: Valores interpolados a intervalos definidos pelo usurio. Calculados: Mdias, mnimos ou mximos, calculados a intervalos definidos pelo usurio. Em ambos os casos, possvel visualizar a Mdia, Mnima e Mxima dos tags adicionados na legenda do Chart nas colunas MediaY, MinY e MaxY. Para plotar o grupo clique no boto Carregar Grupo de Penas.

Carregar Grupo de Penas

Bibliotec a Pen Group

229

20.4.3 Utilizao de Barras de Ferramentas


Alm das barras de ferramentas citadas at o presente momento, ainda existem outras que tem a finalidade de facilitar o acesso do operador s principais funcionalidades do E3Chart, sendo que a maior parte delas se encontra na parte inferior do objeto. Entre elas esto:

Barra de ferramentas Ajusta Horrio Inicial: Modifica o intervalo inicial de visualizao. Ajusta Horrio Final: Modifica o intervalo final de visualizao. Recua/Avana Inicial: Modifica o intervalo inicial de visualizao em do total visvel. Funciona tanto se a escala X est fixa como rolante (tempo real). Recua/Avana Final: Modifica o intervalo final de visualizao em do total visvel. Funciona somente se a escala X est fixa, no tendo efeito quando est rolante (tempo real). Botes Recua/Avana e do Intervalo: Podem ser usados quando se deseja apenas deslocar o intervalo no tempo, sem alterar a diferena entre o instante final e o instante inicial. Intervalo: Mostra o intervalo total e permite, se o eixo X estiver como tempo real (rolante), que se modifique o intervalo, atravs da alterao do instante inicial visto que o final sempre o horrio corrente. Salva Penas: Salva a ltima configurao das penas, que podem ter sido alteradas pelo usurio atravs do menu de opes da legenda, no ndice do grupo atual. Este ndice corresponde ao grupo que foi carregado por ltimo no objeto Chart. Imprime/Exporta: Chama o objeto Relatrio, criado pelo usurio, cujo nome foi informado na propriedade ReportPath. Fundo do Grfico: Permite modificar a cor de fundo do grfico. Atualiza Grfico: Atualiza as consultas no grfico, principalmente as consultas de Penas do Storage, que no so automticas. Limpa o Grfico: Apaga todas as Penas e eixos do grfico. Eixo Rolante/Fixo: Modifica o eixo horizontal (X) para fixo (histrico) ou rolante (tempo real). 230 Bibliotec a Pen Group

Hora Atual: Se o eixo X estiver como fixo, muda o intervalo final para o horrio corrente. Se o eixo estiver como rolante, o intervalo final sempre o horrio corrente. Grid: Inclui ou exclui o grid. Cor do Cursor Diferencial: Modifica a cor dos cursores diferenciais (E3 verso 3.0).

20.4.4 Utilizao da Legenda


Ao clicar na legenda do objeto Chart, com pelo menos uma Pena carregada: Coluna de Cor (Primeira Coluna): Abre-se um menu de opes, permitindo mudar a cor, desenho (linhas-pontos-linhas e pontos-rea), estilo, espessura, visibilidade, tipo de traado (digital ou analgico), posio, alarmes alto e baixo, cor de fundo (quando o desenho for de rea) e apagar. Demais colunas: Ao clicar nas demais colunas, o Chart passa a exibir o eixo Y correspondente Pena clicada.

20.4.5 Menu Popup do Objeto E3Chart


As opes de uso do objeto E3Chart continuam sendo utilizadas, como Zoom, Enquadrar Penas, Mover, Pesquisar, etc.

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

20.5.1 Banco de Dados


1. Configure o Banco de Dados Access ou SQL Server conforme o tpico Banco de Dados PenGroup. 2. Crie em seu projeto um objeto Banco de Dados SQL Server com o nome de PenDB, e configure a conexo com o banco de dados criado no item anterior.

Bibliotec a Pen Group

231

20.5.2 Pen Group


1. Copie o arquivo PenGroup.lib para o diretrio do seu projeto. 2. Abra o arquivo PenGroup.lib atravs do E3 Studio, adicione-o ao Domnio e registreo.

20.5.3 Pen Storage


1. Na pasta Dados insira o objeto PenStorage. 2. Configure o objeto PenStorage1: HistPath1: HistNivel HistPath2: StorageTemp

DICA: Pode-se arrastar o objeto do Organizer at a propriedade na Lista de propriedades.

20.5.4 Chart
1. Insira o objeto Chart da biblioteca na TelaPenGroup. 2. Associe a propriedade PenSto do objeto Chart com o PenStorage1 inserido na pasta Dados.

Propriedade PenSto

20.5.5 Execuo
1. Faa o login com um usurio do grupo Administradores. 2. Digite o texto "Nivel" na Caixa de Listagem mostrada na figura e aperte o boto Novo Grupo.

Incluir novo Grupo

232

Bibliotec a Pen Group

3. Pressione o boto para atualizar a lista de Penas. possvel exibir a lista pelo nome dos tags ou pela descrio (propriedade DocString) .

Selecionar Pena 4. Selecione cada Pena de corrente e aperte o boto para adicion-la ao grupo.

Adicionar Pena ao Grupo 5. Para carregar os dados do grupo criado aperte o boto Carrega Grupo.

Carregar Grupo 6. Explore os botes do objeto Chart.

20.6 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

20.6.1 Storage ou Histrico Inseridos no XObject


Caso deseje usar o Pengroup para plotar Histricos ou Storages que foram inseridos dentro de um XObject, deve-se passar o nome completo da instncia do XObject e completar manualmente com o nome do Histrico ou Storage. 1. Na pasta Dados selecione o objeto PenStorage1 e configure: HistPath3: Dados.Bombas.B01.StorageBomba

Bibliotec a Pen Group

233

20.7 Anotaes

234

Bibliotec a Pen Group

21

CAPTULO

E3Playback

O E3Playback um ActiveX que roda dentro do E3 Viewer ou do E3 WebViewer e que permite visualizar as telas do aplicativo utilizando dados histricos armazenados em bancos de dados. O E3Playback busca no banco de dados os tags referenciados nas telas e mostra valores, animaes, estados e grficos de acordo com as informaes existentes no banco de dados, no perodo de playback definido.

NOTA: Em modo Demo (ou com uma licena de Studio) o perodo permitido para playback se resume s ltimas seis horas de dados armazenados no banco.

21.1 Interface de Usurio do E3Playback


A interface de usurio do E3Playback dividida em cinco partes, mostradas nas sees seguintes.

21.1.1 Barra de Ferramentas

Barra de Ferramentas do E3Playback

21.1.2 Linha de Tempo


A Linha de Tempo permite acompanhar visualmente e controlar o relgio de playback.

Linha de Tempo

E3Play bac k

235

21.1.3 rea de Telas


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

236

E3Play bac k

21.1.4 Lista de Eventos


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

Lista de Eventos

E3Play bac k

237

21.1.5 Lista de Tags


A Lista de Tags mostra os tags que esto sendo utilizados para playback.

Lista de Tags A Lista de Tags pode ajudar tambm a determinar quais tags necessitam ser gravados no banco de dados para permitir o playback completo de uma Tela, bastando verificar os tags com o sinal de proibido.

21.2 Restries e Comentrios


As Telas funcionam como se estivessem em um Viewer Read-Only. Isto garante que as operaes efetuadas no E3Playback no iro perturbar o funcionamento do aplicativo em tempo real. No permitido acesso aos objetos do servidor atravs do mtodo Application. GetObject. Os erros de script ocorridos dentro do E3Playback no geram uma mensagem de erro, so abortados silenciosamente. O E3Playback emula um Viewer real. Pode-se testar a propriedade IsPlaybackMode. O E3Playback trata os novos Quadros criados pelo aplicativo como novas abas no topo da rea de Telas. O ttulo da aba o nome do Quadro ou Tela que foi aberto. Todas as associaes que se referem a objetos do servidor so capturadas pelo E3Playback, e passam a receber os dados histricos de acordo com o relgio atual de playback. As Associaes feitas entre objetos do Viewer (por exemplo, um Display mostrando o valor de um tag Demo interno ao Viewer) funcionam normalmente, sem nenhuma interferncia do playback. O E3Chart s ir funcionar dentro do E3Playback se estiver configurado com Penas histricas. Penas de tempo real so desabilitadas. O E3Alarm ir mostrar o sumrio de alarmes de acordo com o que estiver registrado na tabela de alarmes no Banco de Dados.

238

E3Play bac k

O E3Browser ir funcionar normalmente.

21.2.1 Storage
A coluna Fonte no deve conter expresses, pois elas no podero ser utilizadas no playback.

21.2.2 Alarmes
Habilite ou configure o registro de alarmes em disco. Selecione os seguintes campos para registro (obrigatrios): EventTime (mais EventTimeMS) ou EventTimeDbl FullAlarmSourceName ConditionActive Acked AckRequired

21.2.3 Histricos
O formato de arquivo Histrico no o ideal para playback, pois normalmente muitos dados duplicados esto armazenados. recomendado o uso do Storage sempre que possvel. Seguir ao mximo as seguintes recomendaes: Configurar a propriedade UserTable para False. Colocar cada tag em um campo separado (no utilizar expresses). Criar um ndice para o campo E3TimeStamp. Utilizar tabelas com poucos campos e, se possvel, adicionar um ndice individual para cada campo (principalmente para os campos com poucas variaes). Configurar a propriedade CompressedTable para True e utilizar a propriedade DeadBand no Histrico.

E3Play bac k

239

21.3 Licenciamento
A Elipse fornece dois pacotes para o E3 Playback: Playback Bsico Playback Avanado: Bsico mais as ferramentas de Gravao de Vdeo e Captura de Tela Os pacotes so dimensionados conforme o nmero de pontos (Tags e Fontes de Alarmes) armazenados no Banco de Dados. Se o Banco de Dados tiver mais pontos que as licenas disponveis, a montagem do Banco de Dados ir falhar e ser mostrada uma mensagem de erro. A hardkey 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 hardkey) 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.

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

240

E3Play bac k

21.4.1 Configurao
1. Na TelaPlayBack insira o objeto E3PlayBack ocupando toda a Tela. 2. Acesse suas propriedades e configure conforme a figura a seguir.

Propriedades do E3Playback 3. Execute a aplicao.

21.4.2 Execuo
1. Aperte o boto para entrar no modo Online. Os primeiros dados de playback sero carregados, e o relgio de playback ser posicionado no centro dos dados disponveis. 2. Uma linha com o intervalo de dados existentes aparecer na Linha do Tempo e a Janela de Eventos ser preenchida.

E3Play bac k

241

Linha de Tempo 3. Escolha o evento que deseja iniciar a reproduo e aperte o boto Play.

21.5 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

21.5.1 Dados do Playback


1. Salve em Histricos ou Storages todos os tags que desejar visualizar no E3Playback.

242

E3Play bac k

21.6 Anotaes

E3Play bac k

243

22

CAPTULO

Event Log Viewer

O Elipse Event Log Viewer um sistema de logs desenvolvido pela Elipse Software. Os processos do E3 usam um formato binrio para gravao de eventos, disponvel para sistemas operacionais Windows XP ou superiores e, para sistemas anteriores, os logs so gravados em arquivos de texto. Os arquivos so armazenados em formato estruturado que permite uma srie de funcionalidades como filtros, gravao de mensagens binrias, ordenamento e pesquisa. O Event Log Viewer um controle ActiveX que pode ser integrado ao E3, para que seja possvel o acompanhamento dos processos do E3 de dentro da aplicao e possui um servio de controle e gerenciamento de arquivos pelo sistema, que garante a manuteno de um tamanho mximo de arquivos em disco sem esgotamento do espao disponvel. Para utilizar o Log Viewer, acesse o menu Iniciar - Programas - Elipse Software - Elipse E3 - Elipse Event Log Viewer.

22.1 Configurao do Armazenamento de Arquivos


Atravs da opo Storage Settings, possvel configurar o gerenciamento automtico dos arquivos .etl ou .log gravados pelo E3. Com ela, possvel gerenciar onde os arquivos de log sero armazenados, o tamanho mximo do repositrio, e o tempo que cada arquivo permanecer no repositrio (com base na data de criao do arquivo). Selecione o menu View - Storage Settings, ou clique no boto .

244

Event Log V iew er

Janela Storage Settings

22.2 Abertura de Arquivos


Os arquivos de log com extenso .etl podem ser abertos no Log Viewer de trs formas: Atravs do menu File - Open Atravs do cone na barra de ferramentas

Arrastando o arquivo at a janela

Event Log V iew er

245

Janela de visualizao de eventos Na rea de visualizao de eventos, os arquivos so ordenados cronologicamente, um evento por linha.

22.3 Merge de Eventos


Com o Log Viewer, tambm possvel abrir mais de um arquivo ao mesmo tempo e mesclar suas informaes como se fosse um nico arquivo. Os eventos so ordenados cronologicamente, de modo a permitir a anlise de eventos de causa e consequncia entre mquinas diferentes ou entre arquivos diferentes. Clique no boto ou use o menu File - Open Merged Files e selecione os arquivos que deseja mesclar atravs do boto Add file.

246

Event Log V iew er

Janela Merge Files

22.4 Filtros
Esta seo contm informaes sobre a filtragem de eventos no Elipse Event Log Viewer.

Event Log V iew er

247

22.4.1 Filtro de Mensagens


O Filtro de Mensagens permite restringir o intervalo dos eventos atravs da seleo do tipo de mensagem a ser mostrado. Para acessar esta opo selecione o menu Actions - Filter Editor ou o boto e clique na aba By Message.

Janela Filtro de Mensagem Ao clicar no boto Help, mostrada uma janela com a sintaxe correta para cada palavra chave vlida. Quando mais de um valor for usado em uma palavra-chave, necessrio separ-los com uma vrgula. A ordem de avaliao dos scripts de filtro dada por um OR entre palavras chave e um AND entre linhas. Exemplo:
Process == (0xC48,0x9C8); Module == ("MANAGER______");

Isto significa que apenas sero exibidos eventos que satisfaam a equao lgica equivalente a seguir:
(Process == 0xC48 OR 0x9C8) AND Module == MANAGER______

248

Event Log V iew er

Para ligar o filtro, use o boto correspondente na barra de ferramentas.

22.4.2 Filtro de Tempo


O Filtro de Tempo permite restringir o intervalo das mensagens atravs da seleo de data e hora iniciais e finais a serem mostradas. Para acessar esta opo, selecione o menu Actions - Filter Editor ou o boto e clique na aba By Time. No filtro por tempo, a hora inicial includa, mas a final excluda.

Janela Filtro de Tempo

Event Log V iew er

249

22.5 Exerccios
1. Abra o Event Log Viewer. 2. Selecione o arquivo com a data atual para ser visualizado. 3. Faa testes de filtros por mensagem e por tempo.

250

Event Log V iew er

22.6 Anotaes

Event Log V iew er

251

23

CAPTULO

E3 Tweak

O E3 Tweak uma pequena e simples ferramenta de configurao avanada para o E3 que est presente a partir da verso 3.1. A grande finalidade introduzir uma interface grfica a todas aquelas configuraes que at ento s poderiam ser feitas atravs do Editor do Registro do Windows. O E3 Tweak apresentado em uma janela com itens de configurao dispostos em uma estrutura de rvore. Os itens so classificados conforme a rea na qual suas configuraes atuam: E3 Server, E3 Run, REC, Logs e COMFilter.

23.1 Configuraes do E3 Server


Esta seo contm informaes sobre as configuraes do E3 Tweak para o E3 Server. Definir Nmero de Tentativas de Leitura da Hardkey Configurar o nmero de tentativas de leitura do HASP, feitas quando o E3 Server iniciado. Se configurado o valor 0, o modo Demo ser habilitado automaticamente. Desabilitar Mltiplas CPUs No caso de computadores biprocessados, possvel configurar o E3 Server para utilizar apenas a primeira ou todas as CPUs disponveis no sistema. Definir o Timeout para o Ping O ideal que seja sempre usado o menor valor possvel permitido pela rede. Isto faz com que o E3 Server detecte a queda dos Viewers no mnimo tempo possvel, evitando o empilhamento excessivo de mensagens. Configurar o Heartbeat da Licena Na conexo de licena do servidor com o Viewer aplicado por padro um keep-alive (ou heartbeat). Se o Viewer passar algum tempo sem responder, sua conexo desfeita automaticamente. Se o valor for 0, o heartbeat desligado. Configurar a Porta TCP/IP Utilizada pelo REC

252

E3 Tw eak

O valor configurado indica o nmero da porta utilizada pelo protocolo REC. Podem ser usados valores maiores que 1024 e at 65535. Valores iguais ou abaixo de 1024 so reservados. Valores nulos ou invlidos habilitam a utilizao da porta 6515. Definir Timeout para o Fim do E3Run O valor configurado indica o tempo mximo, em milissegundos, para que o E3Run seja encerrado.

23.2 Configuraes do E3 Run


Esta seo contm informaes sobre as configuraes do E3 Tweak para o E3 Run. Ocultar a Janela de Progresso possvel optar entre exibir ou ocultar a janela de progresso do E3 Run. Definir Tamanho da Pilha da Thread de Runtime O E3 Server armazena as chamadas de funes em uma estrutura temporria em tempo de execuo chamada de Pilha da Thread e, conforme as funes vo sendo processadas, so retiradas dessa pilha. Embora no seja recomendado, o tamanho dessa pilha pode ser ajustado. O campo de edio deve receber um valor numrico em megabytes a ser usado. Se este item no marcado, o valor da pilha fixado em 4 megabytes. O valor 0 indica que deve ser usado o tamanho padro do Windows (1 MB). O valor mximo dessa varivel 256.

23.3 Configuraes do REC


Esta seo contm informaes sobre as configuraes do E3 Tweak para o protocolo REC. Definir Nvel de Compresso possvel habilitar a compactao de pacotes de comunicao atravs do REC entre o E3 Server, o E3 Viewer e o E3 Studio. Qualquer valor entre 1 e 9 ativa a compactao. O valor recomendado 6. Quaisquer valores fora desta faixa desabilitam a compactao de pacotes do REC. Esta configurao ser aplicada somente para a compactao do E3 Server ou do E3 Viewer rodando localmente na mquina. Tanto o E3 Server quanto o E3 Viewer suportam descompactao de pacotes, independente de suas configuraes. Definir o Timeout da Conexo

E3 Tw eak

253

Controla o tempo mximo que o E3 Studio ou o E3 Admin levam para conectarem-se ao E3 Server. Quando o item no est marcado, assumido o valor padro de 6000 ms.

23.4 Configuraes dos Logs


Esta seo contm informaes sobre as configuraes do E3 Tweak para a gravao de logs. Definir o Tempo Mnimo da Funo de Gravar Logs possvel definir o tempo mnimo para logar uma funo nos logs Full (funes que durarem menos que este tempo no sero logadas). Quando este item est desmarcado, assume-se o valor padro de 100 ms. Definir o Tempo para Avisos de Funes Travadas possvel definir o tempo (em milissegundos) que uma funo deve estar rodando para que seja gerado um aviso (EcoLogWarning) de que a funo provavelmente est trancada. O valor zero no campo de edio com o item marcado desabilita a opo. Se no for zero, o valor mnimo aceito 20000. Habilitar ou Desabilitar as Sees de Logs possvel definir as sees de log que sero habilitadas. Algumas sees podem ser subdivididas em mdulos, sendo possvel habilitar cada mdulo separadamente.

23.5 Configuraes do COM Filter


Esta seo contm informaes sobre as configuraes do E3 Tweak para o filtro COM. Habilitar Filtro O E3 Run implementa um filtro de chamadas COM (Component Object Model) visando evitar chamadas reentrantes. Esse filtro por padro est desabilitado e para habilitlo (recomendvel apenas nos sistemas que apresentarem erros ou travamentos aparentemente sem causa), pode-se marcar o item Habilitar filtro.

23.6 Exerccios
1. Altere o nmero de retentativas de reconhecimento da hardkey para 10 retentativas.

254

E3 Tw eak

23.7 Anotaes

E3 Tw eak

255

24

CAPTULO

E3 WebViewer

O E3 WebViewer um componente ActiveX que faz o navegador comportar-se como o E3 Viewer, o que permite a visualizao e controle de aplicaes E3 via Internet. Desta forma, possvel visualizar e interagir com um processo de cho de fbrica atravs de um navegador web comum. O navegador pode estar em qualquer computador da rede que tenha acesso ao E3 Server. Depois de instalado, o E3 WebViewer vai funcionar exatamente como o E3 Viewer, fazendo o download da aplicao (telas, bitmaps, etc.) para a mquina local. Todas as funcionalidades do E3 Viewer (E3Chart, E3Alarm, etc.) so suportadas pelo E3 WebViewer.

24.1 Aplicaes E3 na Web


Para que aplicaes E3 estejam disponveis na web preciso utilizar um servidor de Internet que rode corretamente os scripts da pgina do controle E3 WebViewer. Qualquer servidor de Internet pode ser utilizado, desde que ele execute pginas ASP.

24.1.1 IIS (Internet Information Services)


Um servidor de internet fornecido juntamente com o Windows o servidor IIS ( Internet Information Services). Para acess-lo, siga estes passos. 1. Abra o Painel de Controle (Control Panel) no menu Iniciar do Windows. 2. Acesse a opo Adicionar programas (Add/Remove Programs). 3. Clique em Adicionar um componente do Windows (Add/Remove Windows Component).

256

E3 W ebV iew er

Assistente de componentes do Windows 4. Selecione na lista o item Internet Information Services (IIS) e clique em Prximo ( Next). 5. O sistema inicia a instalao do software (para instalar o IIS preciso ter o CD de instalao do Windows). 6. Aguarde a finalizao do processo para configurar o sistema. 7. Para o Windows 2003, devem-se habilitar as opes Pginas do Active Server e Conector de dados da Internet.

E3 W ebV iew er

257

Opes Pginas do Active Server e Conector de dados da Internet Para instalar o IIS no Windows Vista SP1 e no Windows 7, execute os passos a seguir utilizando uma conta com direitos de administrador. 1. Abra o Painel de controle (Control Panel). 2. Acesse a opo Programas e Recursos (Programs and Features). 3. Clique em Ativar ou desativar os recursos do Windows (Turn Windows features on or off). 4. Clique em Continuar (Continue). 5. Localize na lista o item Servios de Informaes da Internet (Internet Information Services) e clique no sinal de mais para expandir todos os seus subitens. 6. Selecione, no mnimo, as opes mostradas na figura a seguir e clique em OK.

258

E3 W ebV iew er

Servios de Informaes da Internet 7. O sistema iniciar a instalao do software (para instalar o IIS, preciso ter o CD de

E3 W ebV iew er

259

instalao do Windows). Aguarde a finalizao do processo para configurar o sistema.

24.1.2 Arquivos Web


Aps a instalao do IIS, todos os arquivos da pasta C:\Arquivos de programas\ElipseE3\Web devem ser copiados para C:\InetPub\wwwroot. Esta pasta criada na instalao do IIS. Alm desses arquivos, o instalador do E3 WebViewer (e3webviewer-x86-ptb.exe) tambm deve ser copiado para esta mesma pasta. Este arquivo est no CD de instalao do E3, ou pode ser obtido atravs de download no site da Elipse. Um detalhe muito importante que a verso destes instaladores deve ser exatamente a mesma verso do E3 Server. Qualquer usurio, desde que esteja devidamente autorizado pelas polticas de segurana e acesso da empresa, pode visualizar e controlar uma aplicao E3 na Internet atravs de seu navegador. Alguns requisitos bsicos so necessrios: Ter um PC com Windows XP Ter um navegador Internet Explorer 5.5 ou superior Ter acesso Internet O servidor verifica se o cliente tem um WebViewer instalado ou atualizado. Se no houver, o pacote do WebViewer enviado para a instalao no cliente.

260

E3 W ebV iew er

Aviso de Segurana Quando o usurio confirmar o aviso de segurana, o plug-in instalado. O componente assinado pela Elipse Software, e o usurio deve aceitar sua instalao para que ele inicie as configuraes necessrias. No acesso seguinte no ser mais necessrio instalar os componentes, e o tempo de conexo ser mais rpido.

24.2 Arquivos E3Web.asp e DocWrite.asp


Os arquivos E3Web.asp e DocWrite.asp tem a funo de carregar e iniciar o ActiveX E3Downloader. O e3downloader.cab o ActiveX que ser enviado para a mquinacliente e far a instalao do arquivo e3webviewer-x86-ptb.exe. Os arquivos e3web2. asp e docwrite2.asp tem a funo de carregar e iniciar o ActiveX do WebViewer que mostrar a aplicao sendo executada na mquina do Internet Explorer. Todos ficam disponveis para configurao do usurio. Estes arquivos ficam localizados no diretrio onde o E3 foi instalado, na pasta WEB. A pgina docwrite2.asp vem configurada considerando-se que o E3 Server est rodando no mesmo computador que o E3 WebServer (servidor web). Porm, possvel alterar o cdigo fonte desta pgina para atender a configurao desejada. Maiores informaes consulte o Manual do Usurio do E3. possvel editar o arquivo docwrite2.asp incluindo algumas configuraes. Caso se queira permitir ao usurio E3 W ebV iew er 261

informar uma tela inicial vlida, diferente da configurada no Domnio, deve-se alterar a linha a seguir, colocando em Nome_da_tela um nome de Tela vlido na aplicao.
<param name="Screen" value="Nome_da_tela">

Caso se queira informar a necessidade de se fazer o ping para o servidor antes de tentar a conexo, deve-se alterar a linha a seguir. O valor pode ser True ou False.
<param name="Ping" value="TRUE">

Se esta linha for omitida, o ping ser feito. A configurao do E3 WebViewer para abrir no modo Somente Leitura feita atravs da propriedade StartReadOnly.
<param name="StartReadOnly" value="False">

Exemplo:
<html> <head> <title></title> </head> <body topmargin="0" leftmargin="0"> <object classid="clsid:7EB4D157-FACC-45BB-9536-C14B9DCE3CA7" id="E3 Viewer1" width="100%" height="100%" align="center"> <param name="_Version" value="65536"> <param name="_ExtentX" value="19209"> <param name="_ExtentY" value="14552"> <param name="_StockProps" value="0"> <param name="Domain" value="\\servidor"> <param name="StartReadOnly" value="False"> </object> </body> </html>

24.3 Configurando o Internet Information Services


So necessrias algumas configuraes no IIS para que a aplicao E3 possa ser acessada via Web. Antes de tudo, deve-se liberar o acesso porta TCP 6515 (porta utilizada pelo Servidor E3 para comunicao com o WebViewer), e tambm a porta padro do IIS, normalmente a 80. Existem duas configuraes possveis para a organizao dos servidores E3 e IIS, o E3Server e o IIS no mesmo servidor ou em servidores distintos. Ser abordada apenas a primeira opo. Informaes detalhadas sobre este assunto podem ser obtidas no site do Knowledgebase da Elipse (kb.elipse.com.br), no artigo Publicando aplicaes E3 na Internet com o Microsoft Internet Information Services.

262

E3 W ebV iew er

E3 Server e IIS no mesmo servidor

24.3.1 Windows Server 2003 SP2 e XP SP2


1. Abra as configuraes do IIS atravs do menu Iniciar - Configuraes - Painel de Controle - Ferramentas Administrativas - Internet Information Services. 2. Clique com o boto direito do mouse no item Site da Web Padro, que se encontra na pasta Sites da Web do computador local e selecione a opo Novo (New), e depois Diretrio Virtual (Virtual Directory).

Adicionar novo Diretrio virtual 3. Na prxima janela, utilize qualquer nome conveniente e fcil de ser digitado

E3 W ebV iew er

263

futuramente na barra de endereos.

Alias do diretrio virtual 4. O diretrio padro pode ser livremente modificado conforme convenincia do usurio. A dica manter o diretrio padro para reduzir o nmero de etapas at o fim da configurao.

264

E3 W ebV iew er

Diretrio de contedo do site da Web 5. As permisses Leitura (Read) e Executar Scripts (Run scripts) so suficientes para que a aplicao esteja totalmente funcional via Internet.

E3 W ebV iew er

265

Permisses de acesso 6. Aps finalizar essas configuraes, necessrio definir qual arquivo ser executado assim que o usurio pressionar ENTER aps digitar o endereo no navegador. 7. Clique com o boto direito do mouse sobre o seu novo diretrio virtual e selecione a opo Propriedades (Properties).

266

E3 W ebV iew er

Propriedades do diretrio virtual 8. Utilize o boto Remover (Remove) para excluir todos os documentos disponveis no quadro Ativar documento padro (Activate default document). Em seguida, utilize o boto Adicionar (Add) para incluir o arquivo e3web.asp. Este ser o arquivo chamado quando o usurio acessar o site onde a aplicao est hospedada.

E3 W ebV iew er

267

Ativar documento padro 9. Na aba Diretrio virtual (Virtual directory) selecione, na caixa de seleo Permisses de execuo (Execute permissions), a opo Somente scripts (Scripts only ). Agora, a aplicao j est publicada e pronta para ser acessada.

268

E3 W ebV iew er

Aba Diretrio virtual 10.Para visualizar a aplicao, basta digitar na barra de endereos do navegador o endereo ou IP do servidor (por exemplo, http://servidor/diretoriovirtual).

24.3.2 Windows Vista SP1


No Windows Vista SP1 (IIS 7), siga estes procedimentos. 1. Acesse o Painel de Controle - Ferramentas Administrativas (Control Panel Administrative Tools). 2. Clique em Gerenciador de Servios e Informaes na Internet (IIS) (Internet Information Service (IIS) Manager) e clique em Continuar (Continue). 3. Clique no item Site da Web Padro (Default Web Site), clique com o boto direito do E3 W ebV iew er 269

mouse e escolha a opo Adicionar Diretrio Virtual (Add Virtual Directory).

Adicionar Diretrio Virtual 4. No campo Alias, digite um nome conveniente e fcil, pois ser utilizado para acessar o diretrio na barra de endereos do navegador. Em Caminho Fsico ( Physical Path), clique no boto e escolha o diretrio onde os arquivos foram armazenados (neste exemplo foi utilizado C:\Inetpub\wwwroot\). Clique em OK.

270

E3 W ebV iew er

Caminho fsico dos arquivos 5. Clique no Diretrio Virtual criado, que est dentro de Site da Web Padro (Default Web Site), e escolha a opo Documento Padro (Default Document), dentro do quadro central.

E3 W ebV iew er

271

Documento padro 6. Clique na opo Adicionar (Add) no painel Aes (Actions), digite "e3web.asp" no campo Nome (Name) e clique em OK.

272

E3 W ebV iew er

Adicionar documento padro 7. Aps estes procedimentos, a estao cliente poder acessar o servidor HTTP atravs do Internet Explorer. Para visualizar a aplicao, basta digitar na barra de endereos do navegador o endereo ou IP do servidor (por exemplo, http://servidor/ diretoriovirtual).

24.3.3 Windows 7
No Windows 7, siga estes procedimentos: 1. Acesse o Painel de Controle - Sistema e Segurana - Ferramentas Administrativas ( Control Panel - System and Security - Administrative Tools). 2. Clique em Gerenciador de Servios e Informaes na Internet (IIS) (Internet Information Service (IIS) Manager). 3. Clique com o boto direito do mouse na opo Site da Web Padro (Default Web Site ) e selecione Adicionar Diretrio Virtual (Add Virtual Directory).

E3 W ebV iew er

273

Adicionar diretrio virtual 4. No campo Alias, digite um nome conveniente e fcil, pois ser utilizado para acessar o diretrio na barra de endereos do navegador. Em Caminho Fsico ( Physical Path), clique no boto e escolha o diretrio onde os arquivos foram armazenados (neste exemplo foi utilizado C:\Inetpub\wwwroot\). Clique em OK.

274

E3 W ebV iew er

Caminho fsico dos arquivos 5. Clique no Diretrio Virtual criado, que est dentro de Site da Web Padro (Default Web Site), e escolha a opo Documento Padro (Default Document), dentro do quadro central.

E3 W ebV iew er

275

Documento padro 6. Clique na opo Adicionar (Add) no painel Aes (Actions), digite "e3web.asp" no campo Nome (Name) e clique em OK.

276

E3 W ebV iew er

Adicionar documento padro 7. Aps estes procedimentos, o computador cliente pode acessar o servidor web utilizando o navegador Internet Explorer.

24.4 Questes de Licenciamento


Deve-se considerar o nmero de licenas para acesso, pois cada WebViewer conectado consome uma licena de Viewer, como se estivesse fora do browser. Sempre que necessrio, podem ser adquiridas novas licenas de Viewer, possibilitando um maior nmero de acessos simultneos.

24.5 Exerccios
1. Siga o contedo do captulo e publique uma aplicao do E3 na Internet.

E3 W ebV iew er

277

24.6 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

24.6.1 KB
KB-32109: Licena para E3WebViewer.

278

E3 W ebV iew er

24.7 Anotaes

E3 W ebV iew er

279

25
barras amarelas

CAPTULO

Hot-Standby

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

25.1 Configuraes do Hot-Standby


Esta seo contm as configurao para o funcionamento de servidores E3 em modo Hot-Standby.

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

25.1.2 Servidores
Os servidores (principal e backup) devem estar listados na aba Servidores das opes do Domnio. 1. Para acessar as configuraes do Domnio, clique no cone do E3 Admin na rea

280

Hot-Standby

de Notificao do Windows e selecione o menu Domnio - Opes.

Menu Domnio - Opes 2. Os servidores podem ter o nome que se desejar no campo Nome do servidor. No campo Identificao do servidor na rede informe o nome do computador na rede. Por exemplo, Nome do servidor como Servidor1 e Identificao do servidor na rede como \\servidor1.

Hot-Standby

281

Aba Servidores

282

Hot-Standby

25.1.3 Opes de Configurao


Na aba Opes, o item Habilitar deve estar marcado e nos campos Servidor principal e Servidor de backup selecionados um dos servidores cadastrados previamente na aba Servidores.

Aba Opes Os itens descritos nas prximas sees tambm devem ser configurados.

25.1.4 Ping de Integridade


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

Hot-Standby

283

est com problemas e assume a execuo do Domnio.

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

25.1.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 ir gravar os dados nesse Banco de Dados. Existem dois bancos de dados rodando localmente, em ambos servidores (principal e backup). Nesse caso habilita-se a propriedade EnableSynchronization do objeto Banco de Dados, assim todos os dados gravados na base de dados principal so tambm atualizados na base de dados em Standby. Se a aplicao principal no conseguir enviar os dados para o servidor em Standby, esses dados ficaro armazenados em disco localmente, para posterior envio (quando a comunicao entre os dois computadores for restabelecida), assegurando assim a igualdade entre as tabelas geradas pela aplicao.

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

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

284

Hot-Standby

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

25.2.2 Falha Local


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

Criar evento de usurio 4. No evento Falha, crie o seguinte script:


Application.ReportFailure "Falha", "Falha no servidor ativo", 1 Value = False

Hot-Standby

285

5. Busque, com o auxlio do AppBrowser, o evento ReportFailure do Servidor.


Application.ReportFailure(FailureName, FailureDescription, FailureWeight)

6. Altere o parmetro FailureName para "Falha", FailureDescription para "Falha no servidor ativo" e FailureWeight para 1.
Application.ReportFailure "Falha", "Falha no servidor ativo", 1

7. Para o Tag retornar para o estado normal, digite na ultima linha a expresso "Value = False".
Value = False

8. Na TelaMenu, insira um boto com o texto "Falha Local". 9. No boto, crie um Pick Carregar Valor.

Pick Carregar Valor 10.Busque a propriedade Value do Tag FalhaLocal e escolha o valor booleano True.

Valor do Tag FalhaLocal

286

Hot-Standby

25.2.3 Sincronismo do Banco de Dados


1. No objeto BancoDados altere a propriedade EnableSynchronization para True.

25.2.4 Aplicao Standby


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

25.2.5 Configurao Hot-Standby


1. A partir do computador Hot ou do Standby, clique no cone do E3 Admin de Notificao do Windows e selecione o menu Domnio - Opes. na rea

2. Na aba Servidores, adicione dois servidores informando o nome que desejar e o nome do computador na rede. 3. Na aba Opes, habilite o Hot-Standby e escolha um servidor como principal e outro como backup. 4. Informe como ping de integridade o IP de um terceiro computador na rede. 5. Marque a opo Ativar backup em caso de falha local. 6. Execute a aplicao e teste as funcionalidades.

25.3 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

25.3.1 KB
KB-27642: Troca de servidores Hot-StandBy. KB-26057: Viewer durante troca de servidores em modo Hot-Standby.

Hot-Standby

287

25.4 Anotaes

288

Hot-Standby

26

CAPTULO

Domnios Remotos

A configurao de Domnios Remotos define que haver comunicao entre diferentes servidores e Viewers, onde uma aplicao se destina a fornecer dados, e a outra a receb-los. O Domnio que fornece dados a outro chamado de Domnio Servidor. J o Domnio que utiliza estes dados chamado de Domnio Cliente. A configurao de um Domnio como Domnio Cliente no impede que ele seja ao mesmo tempo um Domnio Servidor, e vice-versa.

NOTA: Domnios Remotos no esto disponveis em modo Demo.

Com a configurao de Domnios Remotos, o Domnio Cliente poder acessar objetos do Domnio Servidor de duas maneiras, atravs de scripts ou de links. Para que a conexo entre os Domnios possa ocorrer, todos os E3 Servers envolvidos devero estar rodando a mesma verso do E3.

NOTA: a porta de conexo do REC e as possveis configuraes de firewall associadas tambm se aplicam aos Domnios Remotos.

26.1 Configurao no E3 Studio


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

Domnios Remotos

289

26.2 Compartilhamento da Pasta do Domnio Servidor


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

26.2.1 Configuraes Gerais


As configuraes mostradas a seguir devem ser feitas na mquina que roda o Domnio Servidor. 1. Se a mquina utiliza Windows 2000, 2003 ou Vista, acesse o painel de controle Ferramentas Administrativas (Administrative Tools) - Diretiva de Segurana Local ( Local Security Policy). 2. Na janela seguinte, acesse Diretivas Locais (Local Policies) - Opes de Segurana ( Security Options). 3. Desabilite a opo Acesso de rede: acesso annimo restrito a pipes nomeados e compartilhamentos (Network Access: Restrict anonymous Access to Named Pipes and Shares).

290

Domnios Remotos

Opes de Segurana Se a mquina do Domnio Servidor utiliza Windows XP, a configurao deve ser feita diretamente no Registro do Windows. Nesse caso, siga esses procedimentos. 1. Acesse a chave HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Lanmanserver\param eters. 2. Crie a varivel RestrictNullSessAccess, do tipo DWORD, e coloque o valor 0.

Domnios Remotos

291

Varivel RestrictNullSessAccess A configurao atravs do Registro do Windows tambm pode ser feita em Windows 2000, 2003 e Vista. Segundo a Microsoft, a chave RestrictNullSessAccess especifica se o servidor vai limitar o acesso ao sistema por usurios logados sem autenticao de nome de usurio e senha. Os valores possveis so: 0: Acesso sem autenticao permitido e todos os usurios podem acessar os recursos compartilhados. 1: No permite acesso sem autenticao. Os usurios sem autenticao podero acessar apenas os diretrios listados na varivel NullSessionShares. Em qualquer um desses casos, ser necessrio reiniciar a mquina para que as alteraes tenham efeito. Alm disso, necessrio configurar o compartilhamento e o NTFS para aceitarem o acesso do usurio annimo (ANONYMOUS LOGON/LOGON ANNIMO) ou do usurio de rede (NETWORK/REDE). Isso feito da seguinte maneira. 1. Selecione a pasta que contm o Domnio Servidor, e que dever estar compartilhada. 2. Clique com o boto direito do mouse sobre ela e selecione a opo Propriedades. 3. Na aba Compartilhamento, clique no boto Permisses.

292

Domnios Remotos

Propriedades da pasta 4. Adicione o usurio REDE ou o usurio LOGON ANNIMO, permitindo acesso para leitura pasta e clicando aps no boto OK.

Domnios Remotos

293

Adicionar usurio 5. Acesse a aba Segurana, e adicione novamente o usurio REDE ou LOGON ANNIMO (o mesmo que foi adicionado na aba Compartilhamento), clicando aps no boto OK .

294

Domnios Remotos

Aba Segurana NOTA: Para que a comunicao entre as mquinas funcione corretamente em tempo de execuo, o firewall deve ser configurado corretamente, ou desabilitado.

Domnios Remotos

295

26.2.2 Aba Segurana


Em alguns casos, tambm pode ocorrer de a aba Segurana no estar visvel junto com a aba Compartilhamento, nas propriedades da pasta. Isso ocorre porque em algumas verses de Windows, como o XP, por exemplo, rodando sem pertencer a um domnio de rede Microsoft, o modo de compartilhamento simplificado habilitado por padro. Nesse caso, preciso trocar o modo de compartilhamento atravs da varivel ForceGuest na chave de registro, em HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\LSA. A varivel deve ser ajustada para 0.

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

26.4 Sintaxe dos Links


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

26.5 Alias Local


O Alias Local uma ferramenta do Elipse E3 que garante que a aplicao que ser servidora de um Domnio Remoto seja configurada da melhor maneira para promover a migrao fcil, rpida e confivel de um projeto para a aplicao remota. Essa ferramenta permite a criao de um Domnio Remoto na aplicao local que aponte para si mesmo, ou seja, aponte para o prprio Domnio e para a prpria mquina.

296

Domnios Remotos

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, os links de todos os objetos de tela ficam direcionados para os tags e objetos de dados da aplicao local, porm via Domnio Remoto.

Domnios Remotos

297

26.6 Permisses de Acesso


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

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

26.7.1 Compartilhamento
1. Compartilhe a pasta do projeto e faa as configuraes de permisso conforme a seo Compartilhamento da Pasta do Domnio Servidor.

26.7.2 Alias Local


1. Acesse as opes do Domnio atravs do cone do E3 na rea de Notificao do Windows. 2. Na aba Domnios Remotos, insira um Domnio e configure as seguintes propriedades: Nome do Domnio: Domnio_Local Arquivo de Domnio: Arquivo .dom em desenvolvimento Servidor principal: nome do computador atual na rede

298

Domnios Remotos

Configurao do Domnio 3. Clique no boto Aplicar e finalize a configurao com o boto 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. Busque, no AppBrowser, o Tag dentro do Domnio Remoto Domnio_Local. Domnios Remotos 299

Tag no Domnio Remoto

26.7.3 Domnio Remoto


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

300

Domnios Remotos

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

Projetos dos Domnios Remotos 5. Na TelaRemoto, crie um Display para exibir os valores de um Domnio Remoto. Domnios Remotos 301

Busque, no AppBrowser, um Tag dentro do Domnio Remoto Remoto1.

Tag no Domnio Remoto 6. Crie um Display ou Setpoint para cada Tag que desejar e associe-os atravs do caminho de Domnio Remoto.

TelaRemoto

302

Domnios Remotos

7. Cadastre quantos Domnios Remotos desejar.

26.8 Exerccios Complementares


Esta seo contm exerccios complementares ao contedo deste captulo.

26.8.1 KB
KB-26842: possvel unificar os usurios e permisses de vrios Domnios?

Domnios Remotos

303

26.9 Anotaes

304

Domnios Remotos

27
27.1 Exerccio

CAPTULO

Exerccios de Reviso

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

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

Imagem da minerao Exerc c ios de Reviso 305

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.

MNIMO 90 70 30 10 0 100 90 70 30 10

MXIMO Vermelho Amarelo Branco Azul Verde

COR

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

ALARME HiHi Hi 90 70

LIMITE

306

Exerc c ios de Reviso

Lo LoLo

30 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 a informao exibir simultaneamente.

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

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

A Tela principal deve ter uma imagem da minerao. 1. Inserir a figura como Recurso. 2. Alterar a propriedade FillStyle da Tela para 12 - bkPicture. 3. Informar o nome da figura na propriedade PictureFile da Tela.

Sobre cada tanque visualizar o nvel atravs de uma barra. 1. Inserir um Retngulo na tela sobre o tanque. 2. Acessar as propriedades do Retngulo, aba Associao. 3. Criar uma Associao na propriedade VerticalPercentFill com o tag Nivel correspondente.

Exibir o valor do Nivel na Tela formatada com sua unidade de engenharia igual a

308

Exerc c ios de Reviso

"%", uma casa decimal e obedecendo a tabela de cores. 1. Como sero diversos Displays iguais, a melhor opo criar um XControl. 2. Crie um arquivo de biblioteca e insira-o no Domnio. 3. Insira um XControl e chame-o de DisplayNivel.

4. Crie uma propriedade chamada Nivel do tipo Double.

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

8. Crie uma Associao por Tabela na propriedade ForegroundColor informando os limites e as cores desejadas. Na propriedade Fonte, busque a propriedade Nivel criada anteriormente.

9. Salve e registre-a. 10.Insira na tela um XControl chamado DisplayNivel. Exerc c ios de Reviso 309

11.Faa uma Associao Simples na propriedade Nivel com o tag desejado.

Sinalizar na tela os alarmes de todos os nveis conforme a tabela. 1. Se no existir no Domnio, insira no projeto um Servidor de Alarmes. 2. Se no existir, insira no projeto uma Configurao de Alarmes.

3. Na Configurao de Alarmes, insira uma rea de Alarme. 4. Na rea de Alarme, insira um Alarme Analgico.

5. Acesse as propriedades da Fonte de Alarme, aba Analgico. Informe os limites e mensagens de alarmes conforme a tabela.

310

Exerc c ios de Reviso

6. Na coluna Fonte, busque o tag que deseja monitorar o alarme. 7. Insira quantos alarmes forem necessrios e configure-os seguindo os passos anteriores.

Na tela principal deve ser possvel identificar o usurio logado. 1. Criar um Display na Tela. 2. Criar uma associao na propriedade Value do Display com a propriedade User do Viewer. 3. Insira um boto ao lado do Display.

4. No boto, crie o script a seguir.


Application.Login(True)

5. Acessar o menu Arquivo - Usurios e criar pelo menos um usurio. Exerc c ios de Reviso 311

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

312

Exerc c ios de Reviso

Em uma segunda tela, deve ser possvel visualizar os quatro nveis em um grfico onde possvel escolher atravs de botes qual a informao exibir simultaneamente. 1. Criar uma nova Tela. 2. Inserir um E3Chart na Tela. 3. Acessar as propriedades do grfico, aba Penas. 4. Inserir uma Pena. 5. Escolher um Nome e uma Cor. 6. Na aba Dados, manter a pena como Tempo Real e buscar o tag no campo Link do eixo vertical. 7. Repetir os passos anteriores para incluir as demais Penas.

Exerc c ios de Reviso

313

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

4. Acesse as propriedades do Histrico e configure o nome do Banco de Dados, nome da tabela (TabelaNivel) e tempo de gravao (2000 ms).

314

Exerc c ios de Reviso

Visualizar os dados armazenados no banco de dados em forma de tabela na mesma tela do grfico. 1. Insira na Tela um objeto E3Browser. 2. Acesse suas propriedades, aba Consulta e clique no boto Configurar.

3. Configure a Consulta para buscar no Banco de Dados a tabela criada. 4. Escolha os campos que deseja buscar e na aba Visualizar, aperte o boto para verificar os dados.

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

3. Escolher os campos de Nivel e E3TimeStamp. 4. Inserir na seo Detail um objeto Campo de Dados para cada coluna escolhida na Consulta. Preencher a propriedade DataField com o nome da coluna.

Exerc c ios de Reviso

315

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

316

Exerc c ios de Reviso

27.3 Anotaes

Exerc c ios de Reviso

317

Matriz Rua 24 de Outubro, 353 - 10 andar 90510-002 Porto Alegre RS Fone: (51) 3346-4699 Fax: (51) 3222-6226 E-mail: elipse@elipse.com.br

Filial MG Av. do Contorno, 6594- 17 andar Sala 01 30110-044 Belo Horizonte - MG Fone: (31) 3555-3366 Fax: (31) 3555-3399 E-mail: elipse-mg@elipse.com.br

Filial SP Rua dos Pinheiros, 870 - Conj. 141/142 05422-001 So Paulo - SP Fone: (11) 3061-2828 Fax: (11) 3061-2828 E-mail: elipse-sp@elipse.com.br

Filial PR Av. Sete de Setembro, 4698/1705 80240-000 Curitiba - PR Fone: (41) 3342-0120 Fax: (41) 3342-0120 E-mail: elipse-pr@elipse.com.br

USA 40190 Jarvis Gray Lane Avon - NC - USA 27915 Fone: (252) 995-6885 Fax: (252) 995-5686 E-mail: info@elipse-software.com

Taiwan 26F.-10, No.3, Zihciang 3rd Rd., Lingya District 802 Kaohsiung City Taiwan Fone: +886-7-5666587 Fax: +886-7-5666582 E-mail: evan@elipse.com.br

Alemanha D-67714 Waldfischbach Deutschland Fone: +49 (0) 6333 4439 Fax: +49 (0) 6333 2790045 E-mail: elipse@elipse.de

Consulte nosso website para informaes sobre o representante do seu estado.

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