e3tutorial certification ptb

21
Versão 4. 6.162 (03/03/2015) Tutorial Preparatório para Certificação do E3 Copyright © 1999 - 2015 Elipse Software Ltda. Todos os direitos reservados.

Upload: edson-leandro

Post on 10-Mar-2016

40 views

Category:

Documents


1 download

DESCRIPTION

Apostila elipse E3

TRANSCRIPT

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 1/80

Versão 4.6.162 (03/03/2015)

Tutorial Preparatório para Certificação do E3

Copyright © 1999 - 2015 Elipse Software Ltda. Todos os direitos reservados.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 2/80

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 3/80I

Sumário........................................................................................................................................................................ 11 Treinamento Avançado

.................................................................................................................................................................. 11.1 Exercícios

........................................................................................................................................................................ 22 Elipse Knowledgebase

.................................................................................................................................................................. 22.1 Elipse Knowledgebase

.................................................................................................................................................................. 22.2 Busca no Knowledgebase

.................................................................................................................................................................. 32.3 Categorias

........................................................................................................................................................................ 53 Referências aos Objetos

.................................................................................................................................................................. 53.1 Application

.................................................................................................................................................................. 53.2 Objetos do Servidor

.................................................................................................................................................................. 53.3 Método Item

.................................................................................................................................................................. 63.4 Comando Set

.................................................................................................................................................................. 63.5 Eventos

.................................................................................................................................................................. 73.6 Exercícios

........................................................................................................................................................................ 84 Usuários

.................................................................................................................................................................. 84.1 Login

.................................................................................................................................................................. 84.2 Administração de Usuários

.................................................................................................................................................................. 94.3 Confirmação de Senha

.................................................................................................................................................................. 94.4 Bloqueio de Senha

.................................................................................................................................................................. 104.5 Exercícios

........................................................................................................................................................................ 135 Bibliotecas

.................................................................................................................................................................. 135.1 XControl

.................................................................................................................................................................. 145.2 XObject

.................................................................................................................................................................. 145.3 Exercícios

........................................................................................................................................................................ 206 Layer

.................................................................................................................................................................. 206.1 Exercícios

........................................................................................................................................................................ 217 Adicionando Objetos em Tempo de Execução

.................................................................................................................................................................. 217.1 Adicionar Objeto

.................................................................................................................................................................. 227.2 Evento CustomConfig

.................................................................................................................................................................. 237.3 Exercícios

........................................................................................................................................................................ 248 Arrays

.................................................................................................................................................................. 248.1 Exercícios

........................................................................................................................................................................ 259 IOKit

.................................................................................................................................................................. 259.1 Trabalhando Offline

.................................................................................................................................................................. 259.2 Exercícios

........................................................................................................................................................................ 2910 Importação e Exportação

.................................................................................................................................................................. 2910.1 Arquivo CSV

.................................................................................................................................................................. 2910.2 Gerenciador de Modelos

.................................................................................................................................................................. 3210.3 Exercícios........................................................................................................................................................................ 3311 Consulta

.................................................................................................................................................................. 3311.1 Criando e Acessando Variáveis

.................................................................................................................................................................. 3311.2 Edição Direta do Código SQL

.................................................................................................................................................................. 3311.3 Update

.................................................................................................................................................................. 3311.4 Delete

.................................................................................................................................................................. 3411.5 Exercícios

........................................................................................................................................................................ 3812 GetADORecordSet

.................................................................................................................................................................. 3812.1 Exercícios

........................................................................................................................................................................ 4013 Alarmes

.................................................................................................................................................................. 4013.1 Eventos Versus Alarmes

.................................................................................................................................................................. 4013.2 Campos do Usuário

.................................................................................................................................................................. 4013.3 Assinatura Eletrônica

.................................................................................................................................................................. 4213.4 Exercícios

........................................................................................................................................................................ 4714 Relatórios

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 4/80II

.................................................................................................................................................................. 4714.1 Group Header e Footer

.................................................................................................................................................................. 4714.2 Exercícios

........................................................................................................................................................................ 5015 E3 WebViewer

.................................................................................................................................................................. 5015.1 Aplicações E3 na Web

.................................................................................................................................................................. 5315.2 Arquivos E3Web.asp e DocWrite.asp

.................................................................................................................................................................. 5415.3 Configurando o Internet Information Services

.................................................................................................................................................................. 6515.4 Questões de Licenciamento

.................................................................................................................................................................. 6515.5 Exercícios

.................................................................................................................................................................. 6515.6 Exercícios Complementares

........................................................................................................................................................................ 6716 Event Log Viewer

.................................................................................................................................................................. 6716.1 Configuração do Armazenamento de Arquivos

.................................................................................................................................................................. 6716.2 Abertura de Arquivos

.................................................................................................................................................................. 6816.3 Merge de Eventos

.................................................................................................................................................................. 6816.4 Filtros

.................................................................................................................................................................. 7016.5 Exercícios

........................................................................................................................................................................ 7117 E3 Tweak

.................................................................................................................................................................. 7117.1 Configurações do E3 Server

.................................................................................................................................................................. 7117.2 Configurações do E3 Run

.................................................................................................................................................................. 7117.3 Configurações do REC

.................................................................................................................................................................. 7217.4 Configurações dos Logs

.................................................................................................................................................................. 7217.5 Configurações do COM Filter

.................................................................................................................................................................. 7217.6 Exercícios

........................................................................................................................................................................ 7318 Preparatório para a Certificação

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 5/80Treinamento Avançado 1

1   Treinamento AvançadoCAPÍTULO

Durante o Treinamento vão ser discutidos os seguintes itens:

Referências aos Objetos: Referência a objetos do Servidor e do Viewer, Comandos Item e Set, Eventos de scr ipts

Usuários: Login, administração de usuári os, confirmação de senha, bloqueio de usuário, inatividade

Bibliotecas: XObject, XControl, Combo Box, Option Button, Tela Indexada

Layer: Camadas

Adicionando Objetos em Tempo de Execução: AddObject, TypeName, CustomConfig, CreateLink

Arrays: Copiar configuração de objetos

IOKit: Trabalhando offline, Driver em Bibli oteca

Importação e Exportação: Lista de Tags de Comunicação

Consulta: Consulta, Criando e Acessando Variáveis, Edição Direta do Código SQL, Update e Delete

GetADORecordSet: Buscando resultados de uma Consulta

Alarmes: Eventos, Campos do us uári o, Ass inatura Eletrônica , evento OnDrawRow do E3Browser

Relatórios: Grupos e Totali zadores

E3WebViewer: Publi cando uma apli cação do E3 na Internet

Event Log Viewer: Logs do E3

E3 Tweak: Chaves de regis tro

1.1 Exercícios

1.1.1 Projeto1. Crie uma nova apli cação padrão com o nome "TreinamentoAvancado". Responda Não à pergunta sobre comunicação com

equipamentos e Sim para armazenar dados em banco de dados e para monitorar alarmes. Salve os alarmes em disco.

1.1.2 Tela Inicial1. Configure como figura de fundo da Tela a figura FundoQuimica, inserida como Recurso.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 6/802 Elipse Knowledgebase

2   Elipse KnowledgebaseCAPÍTULO

O Elipse Knowledgebase tem como finali dade ajudar o usuári o dos softwares da Eli pse a encontrar respostas rápidas paradúvidas ou problemas que esteja enfrentando durante a sua utilização, seja no desenvolvimento de aplicações ou depois detê-las prontas. Este espaço nada mais é do que um portal onde muitas informações técnicas e dicas estão concentradas. A suabase de informações é constantemente atual izada e tem uma l inguagem simples que vis a o rápi do entendimento de quem está

util izando. Para a cessar a página i nicial do KB, util ize o endereço kb.elipse.com.br , conforme mostra a figura a seguir.

Página inicial do KB

2.1 Elipse KnowledgebaseNo cabeçalho da página existem as seguintes opções:

Glossário: Permite acessar todo o glossário de palavras que a ferramenta possui

Favoritos: Link  que mostra todos os artigos da base de dados que estão assi nalados como favoritos

Login: Serve apenas para uso interno da Elipse Software

2.2 Busca no KnowledgebaseEste campo busca em toda a base de dados pela pala vra ou palavras que o usuário digitar, retornando todos os artigos quepossuem a pal avra al vo da busca. Basta digitar a pal avra que se deseja busca r e então clicar em Busca.

Busca no KB

Ainda existe a possi bil idade de util izar a Busca Avançada, que permite refinar a consulta. Para i sto, clique em Busca Avançada.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 7/80Elipse Knowledgebase 3

Busca Avançada

Na opção Busca Avançada o usuári o pode digitar a pa lavra ou palavras que deseja busca r, filtrar por categoria específica, porautor e ainda pela cl ass ifica ção do artigo. Isto é, se ele ajudou muito, apenas ajudou, ajudou pouco ou não ajudou.

2.3 CategoriasExiste a possibilidade de o usuário acessar todos os artigos escolhendo diretamente a categoria a que ele pertence. Para isto,no campo Categorias, selecione a categoria que deseja buscar os artigos e clique em Ir.

Escolha de categorias

Todos os artigos da categoria s elecionada são retornados como resultado da busca. É i mportante ressaltar que toda a base deconhecimento está dividida em duas categorias principais : Inglês e Português. Dentro destas categorias existem várias sub-categorias, cada uma delas tratando de um tema específico. Acessando os artigos pela categoria Português - Elipse E3, por

exemplo, tem-se a tela da figura a seguir.

Categorias em português

Note que dentro de cada uma destas s ub-categorias aparece um número. Este número indi ca a quantidade de artigos

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 8/804 Elipse Knowledgebase

existentes dentro da categoria.

As demais seções existentes na página pri ncipal do Knowledgebase são:

Artigos Em Destaque: Mostra todos os artigos que estão cl assi fica dos para aparecerem em destaque. Normalmente estaseção é utilizada para ressaltar algum artigo que merece uma atenção especial por parte dos usuários dos softwaresda Elipse Software

Artigos Mais Lidos: Mostra a l is ta dos 10 artigos mais li dos no Knowledgebase

Últimos Artigos Adicionados: Mostra a l is ta dos últimos 10 artigos que foram adicionados na base de dados doKnowledgebase

Buscas Mais Utilizadas: Mostra as 10 pala vras que mais foram utili zadas como busca pela ferramenta de busca doKnowledgebase

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 9/80Referências aos Objetos 5

3   Referências aos ObjetosCAPÍTULO

Objetos são componentes de software reutilizáveis, que permitem maximizar o uso e aumentar a qualidade e produtividadeem apli cativos.

Um objeto no E3 encapsula ou contém três di ferentes partes (propri edades, métodos e eventos) que podem ser manipula daspara a utilização das vantagens de sua funcionalidade na aplicação.

Propriedades definem atributos de um objeto, como sua aparência na Tela ou seu valor i nicial quando o apli cativo é inici ado.

Métodos sã o funções que reali zam uma ação específica em ou com um objeto.

Eventos são notificações geradas por um objeto em resposta a alguma ocorrência em particular, como um clique de mouse ouuma mudança no valor de um Tag, entre outras .

Uma das características mais importantes ao se trabalhar com scripts dentro do E3 é considerar a separação existente entreos processos que são executados no Servidor e aqueles executados na i nterface do Cl iente (Viewer).

3.1 ApplicationA palavra Application representa o contexto atual do objeto e pode indicar tanto funções que são executadas no Viewer quantono Servidor. Neste caso, o objeto Appli cation sabe de antemão quais funções devem ser executadas tanto para um quanto paraoutro cas o. Não é poss ível, entretanto, executar funções de Viewer dentro do Servidor, as si m como também não é poss ívelexecutar funções de Servidor dentro do Viewer. Exemplo:

Application.ChangePassword : Método do Viewer que permite alterar a s enha do usuário atual

Application.Trace(mensagem): Método do Servidor que escreve em um arquivo texto

3.2 Objetos do ServidorPara se acessar um objeto que está sendo executado no Servidor a partir de um Objeto de Tela ou um Eli pseX, deve-se usa r ométodo Application.GetObject . Exemplo:

Objetos de Servidor

Application.GetObject("Dados.TagInterno1"): Tag Interno do Servidor de Dados

Application.GetObject("BancoDados") : Banco de Dados

3.3 Método ItemO método Item retorna a referência para o objeto fil ho do objeto que o chamou. Este método pode buscar um objeto tanto pelonome quanto pelo índice (inteiro). Se o índice ou o nome especificado for váli do, o método Item retorna a referência do objeto.Caso contrári o, o método retorna um erro de parâmetro inváli do. Exemplo:

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 10/806 Referências aos Objetos

Objeto E3Browser

Screen.Item("E3Browser1"): Objeto E3Browser que está dentro da Tela

Screen.Item("E3Browser1").Item("Consulta1"):Objeto Consul ta que está dentro do E3Browser

3.4 Comando SetO VBScript implementa o conceito das li nguagens orientadas a objeto, permitindo que uma variá vel do tipo Variant ass uma aforma de um objeto qual quer, através do comando Set. Deste modo, a vari ável funci ona como um ponteiro para o objetodesejado, permitindo acessar seus métodos e propriedades. Exemplo:

Set retangulo = Screen.Item("Retangulo1")retangulo.BackgroudColor = RGB(255, 0, 0)'Sem o comando Set, a mesma chamada teria que serScreen.Item("Retangulo1").BackgroundColor = RGB(255, 0, 0)

Aparentemente, não existe vantagem neste cas o, pois se pode fazer tudo em uma única li nha de códi go. Porém, se l ogo aseguir, no mesmo script, outras operações forem necessárias, o processo se torna mais simples e rápido se a chamada aométodo Item não for colocada em todas a s l inhas .

'Exemplo ruimScreen.Item("Retangulo1").BackgroundColor= RGB(212, 208, 20)Screen.Item("Retangulo1").Height = 500Screen.Item("Retangulo1").Width = 500'Exemplo melhorSet Retangulo = Screen.Item("Retangulo1")Retangulo.BackgroundColor = RGB(212, 208, 20)Retangulo.Height = 500Retangulo.Width = 500

3.5 EventosEventos são notificações geradas por um objeto em resposta a alguma ocorrência em particular, como um clique de mouse ouuma mudança no valor de um Tag, entre outras. Alguns exemplos de eventos estão l is tados nos tópicos a seguir .

3.5.1 KeyDownKeyDown(KeyCode, Shift )

Ocorre no momento em que uma tecla é pressionada, independente do foco na Tela. Os parâmetros deste evento estãodescri tos na tabela a seguir.

Parâmetros disponíveis no evento KeyDown

PARÂMETRO DESCRIÇÃO

KeyCode Número inteiro que identifica o caractere ASCII da tecla que foipressionada.

Shift Mostra a tecla press ionada juntamente com o mouse:4: Tecla SHIFT8: Tecla CTRL

12: Teclas CTRL + SHIFT

Exemplo:

Sub TelaInicial_KeyDown(KeyCode, Shift)  ' Mostra uma caixa de mensagem quando

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 11/80Referências aos Objetos 7

  ' o usuário pressiona uma tecla  MsgBox "Código da tecla: " & KeyCodeEnd Sub

3.5.2 MouseDownMouseDown(Button, ShiftState, MouseX , MouseY )

Ocorre quando se pressiona qualquer botão do mouse sobre a Tela. Utilize o evento MouseDown para determinar açõesespecíficas quando a Tela for clicada pelo usuário. Os parâmetros deste evento estão descritos na tabela a seguir.

Parâmetros disponíveis no evento MouseDown

PARÂMETRO DESCRIÇÃO

Button Mostra o botão do mouse pressi onado:1: O botão do mouse pressiona do é o es querdo2: O botão do mouse press ionado é o direito

ShiftState Mostra a tecla press ionada juntamente com o mouse:4: Tecla SHIFT8: Tecla CTRL12: Teclas CTRL + SHIFT

MouseX Mostra a coordenada X do cli que do mouse na Tela .

MouseY Mostra a coordenada Y do cli que do mouse na Tela .

Exemplo:Sub TelaInicial_MouseDown(Button, ShiftState, MouseX, MouseY)  ' Mostra uma caixa de mensagem  ' com as coordenadas do mouse  MsgBox "Coordenada X: " & MouseX & _  vbNewLine & "Coordenada Y: " & MouseYEnd Sub

3.6 Exercícios1. Qual das alternativas a seguir é o modo correto de se referenciar o objeto Consulta1?

Objeto Consulta

a. ( ) Screen.Item("Consul ta1")

b. ( ) Item("TelaInic ia l").Item("Consulta1")

c. ( ) Screen.Item("E3Browser1").Item("Consulta1")

d. ( ) Item("E3Browser1").Item("Consul ta1")

2. Para sai r da aplicação ao pressi onar a tecla ESC, crie um script no evento KeyDown da TelaInicial.

'ESC: Sair da aplicaçãoIf KeyCode = 27 Then

  Application.Exit()End If

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 12/808 Usuários

4   UsuáriosCAPÍTULO

Através desta opção é possível controlar o acesso às Telas, Alarmes, Domínios e ao Viewer em uma lista de usuários e grupos.Conforme a opção configurada, a apl icação permite ou não o acesso aos usuári os cadas trados.

As permissões de acesso s ão configuradas por usuário ou por grupos de usuários. Os grupos podem ser cria dos contendoapenas usuários ou também outros grupos.

4.1 LoginLogin(Mode)

Este método abre uma caixa de diálogo para o login (autenticação de usuári o) na apl icação. O usuári o logado permanece namemória até que seja feito outro login ou logout  (sa ída do usuári o da apli cação). Este método possui o parâmetro Mode, umBooleano que determina s e uma mensagem de confirmação ou de falha da operaçã o deve ser mostrada (o padrão é Fals o).

Tela de login

4.2 Administração de UsuáriosApenas o Admini strador pode ter acesso ao método UserAdministration. A caixa de diál ogo para configuração dos usuár ios éacessível somente ao usuário habil itado como Admini strador.

Administração de usuários

UserAdministration()

Este método abre uma caixa de diálogo que permite editar a lista de usuários do E3 Server. As funções disponíveis são asseguintes:

Mostrar a l is ta de todos os usuár ios

Apagar usuári os (não é possível apagar o usuári o atual)

Adici onar e editar usuári os

Editar as c onfigurações de um usuário

Alterar a senha do usuário

Alterar os demais dados do usuário (login, nome, etc.)

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 13/80Usuários 9

Aba Usuários

4.3 Confirmação de SenhaPara confirmar a senha do usuário logado na apli cação, utili ze o método PasswordConfirm.

PasswordConfirm(Mode)

Este método abre uma caixa de diálogo solicitando a confirmação da senha do usuário atualmente logado. O método retornaVerdadeiro se a senha for confirmada, ou Falso caso contrário. O parâmetro Booleano Mode determina se deve ser executadoum logout  em caso de falha na confirmação (Verdadeiro) ou não (Falso).

Se a cai xa de diálogo for fechada ao cl icar em Cancelar, o método retorna Falso. Caso não haja usuário logado, o métodoretorna Fals o, mas sem abrir a caixa de diál ogo. Caso a senha digitada não esteja correta, a s olicitação é repetida até nomáximo três vezes. Se o usuári o digi tar a s enha incorreta nestas três vezes, a ca ixa de diál ogo é fechada e o método retornaFalso.

Confirmação de senha

4.4 Bloqueio de SenhaA conta de um usuário pode ser bloqueada nas seguintes condições:

Se a senha expirar (o tempo de expiração pode ser atributo global, de grupo ou de usuário)

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 14/8010 Usuários

Se o usuári o digi tar a s enha errada um determinado número de vezes seguidas, isto é, ocorrer uma falha de login

Uma vez bloqueada, a conta não permite login. Esta condição persiste até que um administrador desbloqueie a senhamanualmente ou então o time-out  de bloqueio expire.

4.5 Exercícios

4.5.1 Usuários1. No menu Arquivo, selecione a opção Usuários.

2. Selecione a aba Grupos e crie dois grupos de usuários, chamados "Manutenção" e "Operador".

3. Através da aba Usuário, crie dois usuários. Configure um como pertencente ao grupo Manutenção e outro ao grupoOperador.

4.5.2 Login1. Insira o texto "Usuário" e ao lado um Displa y para exibir o nome do usuário logado.

2. No Display, crie uma Associação entre a propriedade Value e a propriedade User do Viewer.

3. Insira um botão com o texto "Login" na TelaInicial e crie o seguinte script:'LoginApplication.Login(true)

4.5.3 Administração de Usuários1. Ao lado do botão de login, insira um botão com o texto "Adm".

2. Neste botão, insira o seguinte script:

'Administração de usuáriosApplication.UserAdministration()

4.5.4 Opções de Segurança

1. Clique com o botão direito do mouse no ícone do E3, na Área de Notificações do Windows, e selecione o item Domínio -Opções.

Opções do Domínio

2. Na aba Segurança, configure as opções conforme a figura a seguir.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 15/80Usuários 11

Políticas de segurança

NOTA: Configurações de segurança não sã o a pl icadas aos usuários já existentes, apenas na alteração ou na criação de umusuário.

4.5.5 Confirmação de SenhaA cada 10 minutos, o usuário deve confirmar a sua senha.

1. Insi ra no Viewer um Tag Contador com o nome de "ConfirmarSenha".

2. Configure as seguintes propriedades do Tag Contador:

AutoRestart: True

CounterType: 0 - Preset

Preset: 600

3. No evento OnPreset do Tag Contador, insira o seguinte script:

'Confirmar senhaIf Parent.PasswordConfirm(True) = False Then  'Sair do Viewer  Parent.Exit()End If

4. Execute a aplicação e teste suas funcionalidades.

4.5.6 Logout por Inatividade1. Abra a janela de propriedades do Viewer e, na aba Visualizador, configure para verificar a inatividade após cinco minutos

e duas retentativas de login.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 16/8012 Usuários

Janela de propriedades do Viewer

2. No evento OnInactive do Viewer, crie o seguinte script:Logout(false)MsgBox "Sessão encerrada por inatividade."

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 17/80Bibliotecas 13

5   BibliotecasCAPÍTULO

O E3 fornece uma ferramenta de bibliotecas do usuário chamada de ElipseX. O uso de bibliotecas no E3 é altamenterecomendável na maioria dos casos, devido ao ganho de produtividade que trazem às aplicações. Algumas das vantagens dosElipseX:

Reutilização de código

Minimização de testes dura nte o desenvolvi mento

Criação de interfaces padrão para os objetos desenvolvidos

Diminui ção do tempo de desenvolvimento de novos projetos

Proteção do conteúdo do projeto

5.1 XControlUm XControl define uma i nterface gráfica com o usuário, que pode ser composta de quaisquer objetos do E3 e tem o propósitode ser multiplicada facilmente pelo projeto.

Aba Design de um XControl

Aba Propriedades de um XControl

A edição do objeto gráfico pode ser feita da mesma forma como é feita a edição de uma Tela, possuindo os mesmos recursosgráficos e opções. Pode-se ins erir XControls em qualquer Tela , ou ainda dentro de outro XControl.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 18/8014 Bibliotecas

NOTA: Se o ta ma nh o d es te obje to for a l te ra d o n a view  de Des ign da Bibl ioteca e registrado novamente, é necessárioselecionar a opção Tamanho Original no menu contextual da Tela para que a al teração se ja vis ível.

5.2 XObjectAlém dos Objetos gráficos XControls, pode-se criar uma biblioteca de dados, denominada XObject. Com esta bibl ioteca, pode-se definir uma estrutura de dados que é executada no Servidor. Tal estrutura pode realizar cálculos, Associações,comunicações, verifica ção de alarmes, regis tro histórico, entre outras tarefas, independente de haver al guma i nterface gráfica(Viewer) aberta ou em execução naquele momento.

Aba Propriedades de um XObject

Podem ser inseridos em um XObject quais quer módulos do E3 que sejam executados no Servidor, a saber:

Driver de Comunicação e Driver de Comunicação OPC

Servidor de Alarmes e Alarmes

Fórmulas

Servidor de Dados

Históricos

Isto permite que se poss a defini r como uma bibl ioteca um si stema complexo de gerenciamento, que pode ser faci lmentereplicado quantas vezes forem necessárias em um aplicativo.

IMPORTANTE: Veja que tanto os XControls quanto os XObjects só podem se relacionar com o mundo externo através daspropriedades (ou ainda a través do mouse e teclado, no caso dos XControls) . Isto s ignifica que não se pode acessar dadosinternos de u m XObject ou XControl, exceto de dentro do próprio obje to.

5.3 ExercíciosNestes exercícios, vamos trabalhar com a estrutura XObject-XControl e criar um terceiro objeto de biblioteca, o XControl"ConfigBomba", para a Tela indexada.

1. Crie um novo projeto e, através do Ass is tente de Apli cações, selecione a opção Biblioteca de componentes do E3. Nomeie abiblioteca como "LibQuimica". Avance, adicione-a ao Domínio ativo e conclua.

5.3.1 DadosBombaEsse XObject tem as propri edades Ligado, Velocidade  (baixa, média e alta) e Rotação. A propriedade Ligado habilita ou não apropriedade Rotação, que varia entre 0 (zero) e 100 conforme a propriedade Velocidade .

1. Insi ra um novo XObject na bibl ioteca, nomeando-o como "DadosBomba". Insi ra três propriedades e configure-asconforme a figura a seguir.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 19/80Bibliotecas 15

XObject DadosBomba

2. Para si mular a rotação, insira um Servidor de Dados no XObject chamado "Dados".

3. Na pas ta Dados, insira um Tag Demo com o nome de "Rotacao" com o tipo Rampa de Descida (5 - RampDown) e Scan de 200ms.

4. O valor da rotação deve estar acessível através da propriedade do XObject. Crie uma Associa ção Reversa na propriedadeValue do Tag Demo com a propriedade Rotacao do objeto DadosBomba.

5. A rotação só deve estar habilitada se a bomba estiver li gada. No Tag Rotacao, crie uma Associ ação Si mples napropriedade Enabled com a propriedade Ligado do objeto DadosBomba.

6. A velocidade de um Tag Demo está associada ao seu período. Crie uma Associa ção por Tabela na propriedade Period doTag Rotacao com a propriedade Velocidade do objeto DadosBomba.

Associação por Tabela

7. Salve o objeto e registre a biblioteca.

5.3.2 BombaO XControl Bomba si mula um movimento de rotação, conforme as configurações do XObject DadosBomba. A imagem da bombana Tela pode estar na horizontal ou na vertical, sendo necessária uma lógica para escolher onde exibir o nome do objeto.

1. Insi ra um novo XControl na biblioteca, com o nome "Bomba".

2. Desenhe a bomba conforme o modelo da fi gura a seguir. O desenho da bomba pode ser encontrado na Galeria (Pumps).

Bomba

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 20/8016 Bibliotecas

3. Na aba Propriedades, crie as propriedades mostradas na fi gura a seguir.

Aba Propriedades

4. Clique com o botão direito do mouse na figura e selecione as opções Converter para símbolo, Explodir símbolo eDesagrupar.

5. Selecione as i magens do centro, que si mulam a rotação da bomba, e agrupe-as.

6. Insi ra uma Animação por Rotação e si mule o movimento do início ao fim. Verifique se a propriedade RotationAngle estáem 359, e as propriedades Enabled e EnabledSlider em Falso.

Rotação da bomba

7. Crie uma Associação na propriedade Value na Animação com a propriedade Rotacao do objeto DadosBomba.

Associação com a propriedade Value

NOTA: O valor da Animação varia no intervalo das propriedades RangeMin  e RangeMax  (p ad rã o é e ntre 0 e 100) e o Ta gas sociado à Animação deve es tar na mesma escal a, ou deve-se util izar uma Ass ociação Anal ógica para a conversão.

8. Os Textos devem mostrar o nome do objeto DadosBomba as sociado. Na propriedade Value dos Textos, cri e umaAssociação Simples com a propriedade Name de DadosBomba.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 21/80Bibliotecas 17

Associação com a propriedade Value

9. O Texto com o nome da bomba pode aparecer em cima ou embaixo da figura, dependendo da posiçã o do objeto na Tela.Crie uma Associação na propriedade Visible do Texto de baixo com a propri edade Embaixo do objeto Bomba.

10. Para o Texto de cima, crie uma Associa ção na propriedade Visible do com a express ão "NOT Bomba.Embaixo".

Associação com a propriedade Visible

11. Salve as modificações e regis tre a bibli oteca.

5.3.3 Tela1. Sobre cada imagem de bomba na Tela, insira um XControl do tipo Bomba. Para as bombas na vertical , altere a

propriedade Angle para 90. Ajuste a propriedade Embaixo conforme desejar.

5.3.4 DadosPara faci li tar futuras l ógicas, vamos separar os XObjects DadosBomba em uma pasta chamada Bombas.

1. No Servidor de Dados, pasta Dados, insi ra uma Pas ta de Dados chamada "Bombas".

2. Para cada bomba na Tela, insira na pasta Bombas um XObject DadosBomba. Configure as propriedades Name e DocString.

3. Associe o XControl Bomba da Tela com o XObject criado.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 22/8018 Bibliotecas

Associação com a propriedade DadosBomba

4. Configure as propriedades Ligado e Velocidade  das bombas e verifique a funcional idade.

5.3.5 ConfigBombaPara a lterar as propriedades da bomba, vamos criar um XControl que vai ser utili zado como Tela indexada. Usaremos osobjetos MSForms Botão de Opção (Option Button) e Lis ta de Seleção (Combo Box ).

1. Insira um XControl chamado "ConfigBomba".

2. Configure-o conforme a figura a seguir. São util izados três Textos ("Nome", "Descri cao" e "Velocidade"), dois Botões deOpção ("Ligado" e "Desli gado") e uma Lis ta de Seleção.

XControl ConfigBomba

3. Crie a propriedade mostrada na figura a seguir.

Propriedade DadosBomba4. No Texto Nome, crie uma Associaçã o Simples na propriedade Value com a propriedade Name do objeto DadosBomba.

5. No Texto Descrição, crie uma Associaçã o Simples na propriedade Value com a propriedade DocString do objetoDadosBomba.

6. No Botão de Opção Ligado, crie uma Associ ação Bidi recional na propriedade Value com a propriedade Ligado do objeto

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 23/80Bibliotecas 19

DadosBomba.

7. No Botão de Opção Desligado, crie uma Associação Simples na propriedade Value com a propriedade Ligado do objetoDadosBomba, acrescentando o comando NOT para i nverter o valor l ido.

Botão de Opção Desligado

8. Para que a Lista de Seleção inici e preenchida, crie o script a seguir no evento OnStartRunning.

Clear()AddItem "Alta"AddItem "Média"AddItem "Baixa"

NOTA: Para não inseri r i tens repetidos na Li s ta de Seleção (Combo Box ), u ma d a s opções é s e mp re a p aga r os re gi s trosexistentes antes de i nserir novos.

9. Na Lista de Seleção, crie uma Associação Bidirecional na propriedade ListIndex com a propriedade Velocidade do objetoDadosBomba.

10. Salve as modificações e regis tre a bibli oteca.

11. Crie uma Tela chamada "TelaConfigBomba", com o tamanho de 300 por 300 pixels.

12. Insira o XControl ConfigBomba nesta Tela .

5.3.6 Tela IndexadaÉ muito comum termos Telas que se repetem na aplicação. Ao invés de criar várias Telas, vamos criar apenas uma e configurarde onde busca r os dados. Para este tipo de Tela usamos o nome de Tela Indexada.

1. Para abrir a tela de configuração ao clicar em uma bomba, no XControl Bomba agrupe as figuras e insi ra o seguinte scriptno evento Click do grupo.

Arg = Bomba.DadosBomba.PathNameApplication.DoModal "TelaConfigBomba", "", 0, 0, , , Arg, 1 + 2 + 64 + 2048

2. O método DoModal possui o parâmetro Arg, que neste exercício contém o nome da bomba da qual desejamos visua li zar asinformações. Este parâmetro deve ser pass ado ao XControl i nserido na Tela. No evento OnPreShow da Tela, crie o seguintescript:

Item("ConfigBomba1").DadosBomba = Arg

3. Salve a aplicação e teste a funcionalidade.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 24/8020 Layer

6   LayerCAPÍTULO

A propriedade Layer de uma Tela define em quais camadas um objeto deve aparecer. O valor representa uma máscara de 32bits, um bit para cada camada. Portanto, podem ser definidas até 32 camadas individuais. Assim, objetos podem seragrupados l ogicamente e mostrados ou escondidos apenas modificando a máscara da propriedade Layer.

Opções disponíveis para a propriedade Layer

BIT2 BIT1 BIT0 LAYER DESCRIÇÃO0 0 0 0 -0 0 1 1 Camada 10 1 0 2 Camada 20 1 1 3 Camada 3 (exibe

também as camadas 1 e2)

1 0 0 4 Camada 41 0 1 5 Camada 5 (exibe

também a camada 1)1 1 0 6 Camada 6 (exibe

também a camada 2)1 1 1 7 Camada 7 (exibe

também as camadas de1 a 6)

6.1 Exercícios1. No objeto Bomba, altere a propri edade Layer dos Textos que exibem o nome do objeto para 2 (dois ).

2. Salve a biblioteca e registre-a.

3. Na TelaInicial, ins ira uma Cai xa de Seleção com o texto "Identifi caçã o". Altere o nome do objeto para "ckLayer".

4. Na janela de propriedades da TelaInicial, aba Associações, crie uma Associ ação Digital na propriedade Layer da Telacom a propriedade Value do objeto ckLayer. Configure o campo Ligado para 3 (propriedade Layer l igada) e o campoDesligado para 1 (propriedade Layer desligada).

Associação Digital

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 25/80Adicionando Objetos em Tempo de Execução 21

7   Adicionando Objetos em Tempo de ExecuçãoCAPÍTULO

Em algumas situações, uma aplicação não tem uma estrutura fixa, precisando criar os objetos que deseja em tempo deexecução. Por exemplo, uma apl icação que deve ler uma l is ta de equipamentos em um banco de dados e estabelecer umacomunicação com estes equipamentos. Além disto, estes equipamentos var iam com o tempo, junto com sua s propriedades.

Se os objetos ins eridos em tempo de execução s ão objetos do s ervidor (Tags, Drivers, His tóricos , Ala rmes, etc.), asmodificações podem ser sa lvas através do comando Save. Objetos de visualização (Telas ou Relatórios, por exemplo) nãopodem ser sa lvos.

7.1 Adicionar ObjetoAddObject(ClassName, Activate, ObjectName)

Este método adici ona um novo objeto à apl icação. Os parâmetros deste método estão descritos na tabela a seguir .

Parâmetros disponíveis no método AddObject

PARÂMETRO DESCRIÇÃO

ClassName Tipo de objeto que vai ser criado.

Activate Indica s e o objeto é ativado após sua criação.

ObjectName Nome do objeto.

Quando o objeto estiver ativo, as Associações e os scripts ficam habilitados. Se o objeto for criado com o parâmetro  Activate

em Falso, mais tarde ele pode ser ativado pelo método Activate. Exemplo:

Set retangulo = Screen.AddObject("DrawRect", True)retangulo.X = 200retangulo.Y = 200retangulo.ForegroundColor = vbRed

O tipo do objeto pode ser visualizado na barra de título da Lista de Propriedades.

Objeto Retângulo (DrawRect)

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 26/8022 Adicionando Objetos em Tempo de Execução

Objeto Tag Interno (InternalTag)

7.2 Evento CustomConfigO evento CustomConfig é um recurso presente a partir da versão 3.2 do Elipse E3. Permite criar Assistentes de configuraçãodas instâncias de um objeto ElipseX dentro do E3 Studio.

Uma opção de configuração aparece no menu contextual das instâncias de objetos ElipseX, sempre que existir um scriptass ociado ao evento CustomConfig da definição do objeto ElipseX. Quando a opção é selecionada no menu, o evento édisparado.

O texto que aparece na opção do menu pode ser informado na propri edade CustomConfigText da definição do objeto ElipseX.Se esta propriedade estiver em branco, aparece o texto "Configurar", conforme mostra a figura a s eguir .

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 27/80Adicionando Objetos em Tempo de Execução 23

Configurando um XControl

NOTA: O s cri p t a s s oci a do a o e ve nto CustomConfig  e xe cu ta n o E3 Stu di o , ond e os obje tos n ã o e s tã o a ti vos . Porta n to , ocomportamento é diferente do us ual.

7.3 ExercíciosNeste exercício é usado o evento CustomConfig do XControl Bomba para cri ar o XObject e associá-lo à bombaautomaticamente, facilitando a configuração.

7.3.1 CustomConfig

1. No XControl Bomba, selecione o evento CustomConfig e insira o script a seguir.'Nome da bombaNome = InputBox("Digite o nome da Bomba:")If Nome = "" Then Exit Sub

'Cria objeto DadosBombaSet obj = Application.GetObject("Dados.Bombas")._AddObject("DadosBomba", True, Nome)obj.DocString = InputBox("Digite uma descrição para a Bomba:")

'Associa o XControl ao XObjectDadosBomba = obj.PathName

2. Salve as modificações e registre a biblioteca.3. Na Tela, cl ique com o botão direito do mouse em uma bomba e selecione a opção Configurar.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 28/8024 Arrays

8   ArraysCAPÍTULO

Em certas situações é conveniente atribuir mais de um valor relacionado a uma única variável. Para isto, pode-se criar umavariável que contém uma série de valores, uma variável do tipo Array ou Vetor.

Para declarar uma variável expli citamente, utili za-se o comando Dim. A declaração de um array  utiliza parênteses contendosua dimensão. Exemplo:

Dim A(10)

Pode-se atribuir dados a cada um dos elementos de um array  usando-se um índice começando em 0 (zero) e terminando notamanho declarado (o número de elementos de um array  é sempre o número mostrado nos parênteses mais um). Exemplo:

A(0) = 256A(1) = 324A(2) = 100...A(10) = 55

Também é poss ível criar um array  util izando o método Array(arglist ) do VBScript. Este comando retorna uma variável do tipoVariant que contém um array . Os val ores devem ser separados por vírgula. Exemplo:

A = Array(10, 20, 30)MsgBox A(0)MsgBox A(1)MsgBox A(2)

8.1 ExercíciosNeste exercício, vamos programar a opção de copiar as configurações de uma bomba e passá-las para as demais bombasusando o botão direito do mouse.

1. Crie um Tag no Viewer chamado "CopiarBomba".

2. No XControl Bomba, selecione o grupo com a i magem da bomba e insira o s eguinte scri pt no evento MouseDown:

If Button=2 Then 'Clique com o botão direito do mouse

  If TypeName(Application.Item("CopiarBomba").Value) = "Empty" Then  Menu = "Copiar"  Else  Menu = "Copiar|Colar"  End If

  opcao = Application.SelectMenu(Menu)  If opcao = 1 Then 'Copiar  'Salva as informações no Tag do Viewer  Dim arr(2)  arr(1) = Bomba.DadosBomba.Ligado  arr(2) = Bomba.DadosBomba.Velocidade  Application.Item("CopiarBomba").Value = arr  ElseIf opcao = 2 Then 'Colar

  'Passa as informações do tag do Viewer para DadosBomba  arr = Application.Item("CopiarBomba").Value  Bomba.DadosBomba.Ligado = arr(1)  Bomba.DadosBomba.Velocidade = arr(2)  End IfEnd If

3. Salve as modificações e registre a biblioteca.

4. Execute a aplicação e teste a nova funcionali dade.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 29/80IOKit 25

9   IOKitCAPÍTULO

O IOKit é um componente compartilhado utilizado pelos Drivers de Comunicação da Elipse, implementando o acesso padrãodo nível físi co e proporci onando i nterfaces para Serial , Modem, Ethernet e RAS.

Atualmente o IOKit permite que apenas uma conexão seja aberta para cada Driver. Isto significa que, se for necessário oacesso a duas portas seriai s, devem ser adicionados dois Drivers na apli cação e cada um deles configurado para cada umadas portas s eriai s.

9.1 Trabalhando OfflineO modo Offline foi planejado para sistemas onde o Driver necessita ser configurado em tempo de execução. Este é o casoquando simplesmente não s e sabe o tipo de conexão ou os parâmetros até que a apl ica ção esteja em execução. Em modoOffline, todos os Tags de Comunicação do Driver falham (todas as escritas e leituras). Os únicos Tags permitidos são os Tagsgerais do IOKi t (N1/B1 = -1 e N2/B2 = 0). Embora s eja possível chavear o Driver entre os modos Online e Offline em tempo deexecução, geralmente os seguintes passos são necessários:

1. Configurar a opção Start driver Offline na j anela de propriedades Extras do Driver. Esta opção faz com que o Driver inicieno estado Offline.

2. Configurar os parâmetros do Driver em um scri pt da apl icação. O script pode ser executado automaticamente ou deacordo com uma sol ici tação do usuári o.

3. Configurar o Driver para o modo Online.

9.2 ExercíciosO Driver de Comunicação vai ser i nserido em um XObject e recebe as i nformações de IP, Porta e Address (ID) do equipamentoao iniciar a aplicação.

9.2.1 DadosTanque1. Insi ra um novo XObject na bi blioteca, nomeando-o como "DadosTanque". Configure as propriedades conforme a figura a

seguir.

XObject DadosTanque

2. Insira um objeto Driver de Comunicação no XObject DadosTanque.

3. Configure este Driver para comunicar com o Simulador.

Physical Layer: Ethernet

IP: 127.0.0.1

Porta: 502

Use Default Slave Address: True

4. Insi ra um Tag de Comunicação e configure-o para ler o endereço 1:

N1: 0

N2: 1

N3: 0

N4: 1

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 30/8026 IOKit

5. Como o Simulador Modbus da Eli pse tem variação de valores entre 0 (zero) e 65535, e a variação usada na apl icaçã o deveestar entre 0 (zero) e 100, habil ite a escal a no Tag, conforme a figura a seguir.

Tag de Comunicação

6. Teste a conexão.

7. Para passa r as configurações do equipamento para o Driver, no evento AfterStart do Driver ins ira o script a seguir.

'Parametros de configuraçãoDim arr(2)arr(1) = Array("IO.Ethernet.MainIP", Parent.IP)arr(2) = Array("IO.Ethernet.MainPort", Parent.Porta)Item("Nivel").N1 = Parent.Address

Write -1, 0, 0, 3, arr

'OnlineWrite -1, 0, 0, 4, 1

8. Na aba Setup, selecione a opção Start driver OFFLINE.

9. Deseja-se acessar todas as propriedades do TagNivel na apli cação. Para i sto, deve-se associa r o Tag de Comunicação àpropriedade do XObject do tipo IOTag. Arraste o Tag de Comunicação até o campo Valor inicial da propriedade Nivel doobjeto DadosTanque.

Valor inicial da propriedade Nivel

10. Salve a bibli oteca e regis tre-a.

9.2.2 Tanque

1. Insi ra um XControl na bibl ioteca com o nome de "Tanque".

2. Configure o objeto Tanque conforme o modelo da figura a seguir, com uma Esca la , um Retângulo e um Displa y.

XControl Tanque

3. Na aba Propriedades, crie a propriedade "DadosTanque", conforme a figura a seguir.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 31/80IOKit 27

Propriedade DadosTanque

4. O Retângulo deve si mular o l íquido do tanque. Na propriedade VerticalPercentFill do Retângulo, crie uma AssociaçãoSimples com a propriedade Nivel.Value do objeto DadosTanque.

Propriedade VerticalPercentFill

NOTA: Como a propriedade Nivel é do tipo IOTag, deve-se cria r a Ass ociação com a proprieda de Value da proprieda de Nivel.

5. Para vis uali zar o valor do nível numericamente, é feita a mesma Associa ção do item anterior na propriedade Value doDis play, "Tanque.DadosTanque.Nivel.Value".

NOTA: Caso a formatação do Display s eja Porcentagem, a Associação deve ser Analógica, pois esta formatação es pera valoresentre 0 (zero) e 1 (um), e a variá vel Nivel varia entre 0 (zero) e 100.

6. O Displa y deve desl izar acompanhando o nível do preenchimento do Retângulo. Insi ra uma Associação por Transl ação noDisplay. Associe a Animação com o valor do nível, "Tanque.DadosTanque.Nivel.Value".

Associação porTranslação

7. Salve as modificações e registre a biblioteca.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 32/8028 IOKit

9.2.3 Tela1. Sobre cada i magem de tanque na Tela, insi ra um XControl Tanque.

Tela

9.2.4 Dados1. Na pas ta Dados, insi ra uma Pas ta de Dados chamada "Tanques".

2. Para cada Tanque na Tela , insira na pasta Tanques um XObject DadosTanque. Configure os valores de IP, Porta e Address.

3. Associe o XControl Tanque da Tela com o XObject criado.

XObject DadosTanque

4. Execute a aplicação e teste a nova funcionali dade.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 33/80Importação e Exportação 29

10 Importação e ExportaçãoCAPÍTULO

A ferramenta de importação de objetos do E3 tem como objetivo ler as informações sobre os objetos de um arquivo CSV erecriá-los no ambiente de configuração (E3 Studio). Para cada objeto, é possível obter informações sobre propriedades,Associações e itens de coleções.

A ferramenta de exportação de objetos do E3 tem como objetivo salvar informações sobre os objetos selecionados noambiente de configuração (E3 Studio) para um arquivo CSV. Para cada objeto, podem ser gravadas suas propriedades,Associações e seus itens de coleções.

Qualquer objeto do E3 pode ser importado ou exportado. O objeto selecionado para a operação é chamado de objeto rai z.Além dos objetos, as Associações e as coleções também podem ser importadas e exportadas.

NOTA: Os s cri p ts NÃO  são exportados, apenas objetos e Associações . Para trabalhar com importação ou exportação énecessá rio ter uma licença de Studio.

10.1 Arquivo CSVUm arqui vo CSV (Comma Separated Values) é um arquivo texto baseado em colunas separadas por um caractere separadorpreviamente definido. Cada coluna do arquivo CSV representa uma ou mais propriedades de objetos do E3. Cada linha do

arqui vo representa um objeto, Ass ociação ou item de coleção. Para que estes arquivos sejam utili zados corretamente, éprecis o observar al guns detalhes:

A primeira l inha do arqui vo CSV deve conter um cabeçalho que identifi que as col unas corretamente

O cabeçal ho deve ter obri gatoriamente uma coluna que identifica o tipo do objeto que está s endo importado ouexportado. Esta coluna chama-se ObjectType

O cabeçalho das demais colunas deve ser o próprio nome da propriedade

As colunas podem ser colocadas em qualquer ordem no arquivo. Pode haver colunas a mais ou a menos, sem prejuízoda operação de importação ou exportação. A única coluna obrigatória é ObjectType , porque sem ela nã o é possívelidentificar o tipo de objeto que deve ser criado

10.2 Gerenciador de ModelosModelos são arquivos INI utilizados para configurar a ferramenta de importação e exportação, informando, por exemplo, qualo separador que deve ser util izado no arquivo CSV, se as Ass ociações dos objetos devem ou não ser exportadas, entre outrasconfigurações.

O Gerenciador de Modelos é uma ferramenta para auxi li ar o usuár io na cr iaçã o de um arquivo INI para ser util izado naimportação ou exportação de objetos do E3.

Na aba Configurações é possível salvar um arquivo de modelo. Quando a opção Salvar as alterações deste modelo em umarquivo INI for selecionada, define-se o arquivo INI onde as alterações do modelo são salvas, e este arquivo pode serreutilizado.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 34/8030 Importação e Exportação

Aba Configurações

Através da aba Propriedades, o usuário escolhe quais a s propriedades dos objetos que deseja util izar na importação ou naexportação. O valor inicial da lista é ObjectType. As demais propriedades devem ser adicionadas manualmente pelo usuário.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 35/80Importação e Exportação 31

Aba Propriedades

Ao clica r em , a janela da figura a seguir é aberta para a seleção de propriedades.

Adicionar propriedades

As propriedades em negrito nesta l is ta já foram inseridas na l is ta que define as col unas do arquivo CSV. Clicar duas vezes emuma propriedade faz com que ela seja adicionada ou removida, dependendo se ela já estava na lista ou não.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 36/8032 Importação e Exportação

As propriedades também podem ser agrupadas . Selecione as que deseja agrupar e cl ique em . Os nomes das propri edadessão agrupados em uma mesma linha, utilizando o nome da coluna definido para a propriedade que está no topo da lista.

10.3 Exercícios

10.3.1 Exportação1. Clique com o botão direito do mouse em um objeto Driver e selecione a opção Exportar.

Menu Exportar

10.3.2 Importação1. Clique com o botão direito do mouse no Driver e selecione a opção Importar.

2. Selecione o arquivo CSV criado no exercício anterior.

3. Caso j á exista o Tag que foi importado, aparece uma mensagem perguntando se este deve ser sobrescri to ou ignorado.

Aviso de importação

4. Verifique se todos os Tags foram criados com sucesso.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 37/80Consulta 33

11ConsultaCAPÍTULO

Neste capítulo vamos abordar o objeto Consulta do E3 (Query), com foco na utilização da edição direta do código SQL(Structured Query Language), isto é, sem a utilização do Assistente de Configuração de Consultas.

11.1 Criando e Acessando VariáveisNa janela de configuração da Consulta, na aba Campos, pode-se adicionar filtros diretamente nos campos. Estes filtros podemser constituídos de variá veis que são definidas por scri pt, utili zando o método SetVariableValue da Consul ta. A forma dedeclarar as variáveis depende do tipo de dado que elas representam:

<%Nome_da_Varia vel%> se o val or for numérico

'<%Nome_da_Variavel%>' se o val or for uma String

#<%Nome_da_Variavel%># se o valor for uma data

11.2 Edição Direta do Código SQLO objeto Consulta do E3, além de criar o código SQL automaticamente através de configuraçã o, também permite que o usuári o

defina diretamente a consulta desejada. Para isto, utilize a opção Habilita edição direta do SQL na aba SQL.

Opção Habilita edição direta do SQL

11.3 UpdateUtilizando o comando Update para editar campos da tabela, respeitando condições.

UPDATE Tabela1  SET Tabela1.Campo = '<%NovoValor%>'  WHERE Tabela1.Campo = '<%ValorAntigo%>'

11.4 DeleteUtil ização do comando Delete na sintaxe SQL:

DELETE  FROM Tabela1  WHERE Tabela1.Campo = '<%Valor%>'

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 38/8034 Consulta

NOTA: Deve-se uti l izar o método Execute  da Consulta ao uti l izar um comando SQL que não tenha retorno, como Delete  ouUpdate. O pa râmetro ImmediateExecute  indica se a operação passa pelas f i las de operações do Banco de Dados (configuradacomo Fal so) ou s e é enviada di retamente para o ba nco de dados (configurada como Verdadeiro).

11.5 ExercíciosNeste exercício vamos implementar uma Tela para o cadastro de equipamentos da apli caçã o, informando o nome, IP, porta eendereço do equipamento.

11.5.1 Aplicação1. Insi ra no projeto um novo Servidor de Dados, chamado "DadosHistorico".

2. Neste Servidor de Dados, insi ra quatro Tags Internos chamados "IP", "Porta", "Address" e "Nome".

Tags Internos

3. Insi ra um objeto His tórico com o nome "His tEquipamento" e crie os campos IP, Porta, Address e Nome, configurando acoluna Fonte de cada campo com seus respectivos Tags Internos, criados no item anterior.

4. Não é permitido mai s de um registro com o mesmo nome de equipamento, portanto selecione o campo Nome como chaveprimária.

Objeto HistEquipamento

5. Abra a j anela de propriedades do Histórico e configure-o para gravar os dados na tabela ConfigEquipamento do Banco deDados, gravando um registro novo a cada 0 ms.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 39/80Consulta 35

Propriedades do Histórico

5. Gere a estrutura da tabela.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 40/8036 Consulta

11.5.2 Tela

Tela de configuração dos equipamentos1. Insi ra uma nova Tela no projeto, chamada "TelaConfigEquipamento", com o tamanho de 500 por 500 pixels.

2. Insira nesta Tela um objeto E3Browser.

3. Configure o E3Browser para exibir a tabela ConfigEquipamento e retornar os campos Nome, IP, Porta, Address e aindaatuali zar-se a cada 1000 ms.

4. Abaixo do E3Browser, insi ra quatro SetPoints para poder editar o nome, IP, porta e endereço do equipamento. Identifiquecada SetPoint com um Texto.

5. Para faci li tar os scr ipts seguintes, renomeie os SetPoints para "spNome", "spIP", "spPorta" e "spAddress".

6. Crie uma Associação Bidirecional dos SetPoints com seus respectivos Tags em DadosHistorico.

7. Abaixo dos textos, ins ira três Botões de Comando: "Inserir", "Atual izar" e "Remover".

8. Na TelaInicial, insira um botão para abrir a TelaConfigEquipamento.

11.5.3 InserirPara i nserir um registro no Histórico sem habil itar a gravação por scan, deve-se utilizar o método WriteRecord do próprioHistórico.

1. Ao c licar em Inserir, o objeto Histórico deve inserir uma linha na tabela. No evento Click do botão Inserir, crie o script aseguir.

Application.GetObject("HistEquipamento").WriteRecord()

2. Execute a apl icaçã o e cadastre os três tanques existentes. Use o nome do XObject criado anteriormente.

11.5.4 AtualizarPara atualizar um registro já existente na tabela, deve-se utilizar o comando Update. O registro que deve ser modifica do é oregistro selecionado. Para retornar o valor dos campos de um E3Browser, use o método GetColummValue.

1. Insi ra na Tela um objeto Consulta e nomeie-o como "ConsultaUpdate".

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 41/80Consulta 37

2. Na aba SQL, habil ite a edição di reta e al tere o comando existente.

UPDATE ConfigEquipamento  SET IP = '<%IP%>', Porta = <%Porta%>, Address = <%Address%>  WHERE (Nome = '<%Nome%>')

3. Deseja-se atual izar a l inha selecionada no E3Browser. Para retornar o valor de uma li nha do E3Browser, crie o script aseguir no evento DblClick.

Screen.Item("spNome").Value = GetColumnValue(0)Screen.Item("spIP").Value = GetColumnValue(1)

Screen.Item("spPorta").Value = GetColumnValue(2)Screen.Item("spAddress").Value = GetColumnValue(3)

4. No botão Atualizar, adicione o scri pt a seguir.

'UPDATEScreen.Item("ConsultaUPDATE").SetVariableValue _  "Nome", Screen.Item("spNome").ValueScreen.Item("ConsultaUPDATE").SetVariableValue _  "IP", Screen.Item("spIP").ValueScreen.Item("ConsultaUPDATE").SetVariableValue _  "Porta", Screen.Item("spPorta").ValueScreen.Item("ConsultaUPDATE").SetVariableValue _  "Address", Screen.Item("spAddress").ValueScreen.Item("ConsultaUPDATE").Execute(True)

5. Execute a aplicação e teste a nova funcionali dade.

11.5.5 ApagarNeste exercício, vamos apagar o regis tro selecionado no E3Browser. Para remover um registro da tabela, use o comandoDelete.

1. Insi ra na Tela um objeto Consulta e nomeie-o como "ConsultaDelete".

2. Na aba SQL, edite o comando para o códi go a seguir.

DELETE FROM ConfigEquipamento  WHERE (Nome = '<%Nome%>')

3. No botão Remover, insira o script a seguir.

'Nome do equipamentoNome = Screen.Item("E3Browser1").GetColumnValue(0)'Confirmação do usuárioIf MsgBox("Tem certeza que deseja apagar o equipamento " & _  Nome & "?", vbYesNo) = vbYes Then  Screen.Item("ConsultaDELETE").SetVariableValue "Nome", Nome  Screen.Item("ConsultaDELETE").Execute(True)End If

4. Execute a aplicação e teste a nova funcionali dade.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 42/8038 GetADORecordSet

12GetADORecordSetCAPÍTULO

O método GetADORecordSet da Consulta retorna um Recordset do tipo ADO ( ActiveX Data Object ), resultante da execução daConsulta configurada.

O objeto ADORecordset é usado para acessar os registros de uma tabela do banco de dados e possui as propriedades emétodos descritos nas tabelas a s eguir.

Propriedades do objeto ADORecordset

PROPRIEDADE DESCRIÇÃO

BOF Retorna Verdadeiro se a pos ição do ponteiro é anterior aoprimei ro regi stro

EOF Retorna Verdadeiro se a pos ição do ponteiro é posterior aoúltimo registro

RecordCount Retorna o número de regis tros na tabela

Métodos do objeto ADORecordset

MÉTODO DESCRIÇÃO

MoveFirst Move o po nteiro para o p rimeiro regis troMoveLast Move o po nteiro para o ú ltimo regis tro

MoveNext Move o pontei ro para o próximo regis tro

MovePrevious Move o po nteiro para o regi stro anterior

Para acessar registros individual mente, utili ze o comando Fields("NomeCampo"). Exemplo:

Set RS = Screen.Item("Consulta1").GetADORecordset()For i = 1 To RS.RecordCount  Campo1 = RS.Fields("Campo1").Value  Campo2 = RS.Fields("Campo2").Value  Campo3 = RS.Fields("Campo3").Value  MsgBox Campo1 & vbTab & Campo2 & vbTab & Campo3

Next

12.1 ExercíciosAo iniciar a aplicação, cada Tanque deve ler do banco de dados suas configurações de IP, Porta e Endereço.

12.1.1 GetADORecordSet1. No XObjectDadosTanque, insira um Servidor de Dados e altere o nome para "Consultas".

2. Neste Servidor de Dados, insi ra um objeto Consulta (Query) com o nome de "ConsultaEquipamento".

Objeto Consulta

3. Configure a Consulta para acessar a tabela ConfigEquipamentos e retornar os campos Nome, IP, Porta e Address.

4. No campo Nome, crie o fil tro mostrado na figura a seguir.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 43/80GetADORecordSet 39

Filtro para o campo Nome

5. No evento OnStartRunning da Consulta, insira o script a seguir.

'Nome do equipamentoSetVariableValue "Nome", DadosTanque.Name

'Resultado da consultaSet RS = GetADORecordset()DadosTanque.IP = RS.Fields("IP").ValueDadosTanque.Porta = RS.Fields("Porta").ValueDadosTanque.Address = RS.Fields("Address").Value

6. Execute a aplicação e teste a nova funcionali dade.

DICA: É possível acompanhar o valor de informações do Servidor através da janela WatchWindow.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 44/8040 Alarmes

13AlarmesCAPÍTULO

O E3 dispõe de um conjunto de objetos que permite ao usuário monitorar alarmes em sua apl ica ção. Com eles, é possívelespecificar e gerenciar alarmes e eventos das variáveis de um processo.

13.1 Eventos Versus AlarmesUm Evento, ao ser ativado, é reconhecido automaticamente pelo us uári o System e não incrementa o número de alarmes ativos ,nem o número de alarmes não reconhecidos.

13.2 Campos do UsuárioÉ possível especificar as configurações de Banco de Dados e determinar campos para a geração da tabela de alarmes. Cadacampo possui uma propriedade correspondente. Caso o usuári o queira inserir mais informações nesta tabela , na aba Camposdo usuário pode-se adicionar valores a rbitrários aos eventos de alarmes.

Aba Campos do usuário

As opções dis poníveis nesta aba estão descritas na tabela a s eguir.

Opções disponíveis na aba Campos do usuário

OPÇÃO DESCRIÇÃO

Nome Determina o nome do campo.

Tipo Determina o tipo do campo (Text, Integer, DateTime ou Double).

Tamanho Determina o tamanho do campo.

Fonte Determina a fonte de da dos do Ala rme.Propagar Força a atuali zação imediata de todos os al armes que herdam

o valor deste Campo do Usuá rio, sempre que este receber umvalor forçado ou se a Ass ociação for alterada .

13.3 Assinatura EletrônicaPara executar a assinatura eletrônica no E3, utilize o método ESign do Viewer. Quando este método é util izado, a cai xa dediál ogo da figura a s eguir é mostrada.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 45/80Alarmes 41

Assinatura Eletrônica

ESign(ObjName, Description, Action[, From[, To[, User [, Comment ]]]])

ObjName:Texto que contém o nome de um Tag ou outro objeto da aplicação

Description: Texto que contém a descrição de ObjName. Este parâmetro é opcional e, se for omitido, a caixa de diálogotenta buscar os dados da propriedade DocString de ObjName

Action:Texto que contém a ação a ser executada (por exemplo, "Alteração do valor"). Este parâmetro é opcional e o seuvalor padrão é uma String vazia

From: Variant que contém o valor original, ou o estado que vai ser alterado. Este parâmetro é opciona l

To: Variant que contém o novo valor do Tag, ou o valor a s er apli cado em Action. Este parâmetro é opcional

User: Texto de retorno. Recebe o nome de login digitado na caixa de diálogo. Este parâmetro é opcional

Comment: Texto de retorno. Recebe o comentári o digitado na cai xa de diál ogo. Este parâmetro é opcional

Ao cl icar em , abre-se uma janela que permite autenticar o usuário. Se a opção Windows for selecionada, os campos Nomedo usuário e Senha são automaticamente desabilitados. Clique em Outro usuário para selecionar um usuário pertencente aodomínio de rede. Caso a opçã o E3 seja selecionada, digite as informações de um usuário pertencente ao Domínio do E3 noscampos Nome do usuário e Senha.

Login integrado

Este método retorna Verdadeiro se o usuári o cl icar em OK, e se os campos Usuário e Senha forem válidos. Se a cai xa de diál ogofor cancelada ou se o login ou a s enha estiverem errados , após três tentativas o método retorna Fal so. Em caso de fal ha, osparâmetros User  e Comment  são configurados para uma String vazia.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 46/8042 Alarmes

Os comentários pré-definidos são guardados no Regis tro do Windows. Apenas os úl timos 26 comentários são sal vos. Cadavez que a janela é criada, os últimos comentários são buscados no Registro e usados para preencher a lista de seleção. Se umnovo comentário for informado pelo usuário, ele é salvo e o mais antigo é descartado, caso não haja posição livre. Se forutilizado um comentário pré-definido, este passa a ser o primeiro da lista de comentários mais recentes.

13.4 ExercíciosNeste exercício, vamos monitorar o nível dos tanques e, caso esteja fora do valor esperado, é gerado um al arme. Desejamossalvar na tabela de al armes a descrição do tanque, e também o motivo de reconhecimento do ala rme.

13.4.1 Servidor de AlarmesConfiguraremos o Servidor de Alarmes para salvar o horário de entrada, saída e reconhecimento do alarme, a mensagem, ovalor, se o alarme está ativo ou já retornou ao estado normal e dois campos de usuário, que configuraremos mais adiante.

1. Abra a ja nela de propriedades do Servidor de Alarmes e configure-o para salvar as i nformações no objeto BancoDados.Mantenha o nome da tabela como Ala rms.

2. Selecione os campos a seguir e mais os que desejar.

Campos da tabela

13.4.2 Configuração de AlarmesTodo tanque deve ter um ala rme monitorando a i nformação de nível.

1. Insira no XObjectDadosTanque um objeto Configuração de Alarmes.

2. No objeto ConfigAlarmes, ins ira uma nova Área com o nome de "Tanques".3. Na Área Tanques, insi ra um Alarme Analógico para a propriedade Nivel.Value do objeto DadosTanque.

Configuração de Alarmes

4. Configure os níveis e mensagens do Alarme conforme desejar.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 47/80Alarmes 43

Toda bomba deve si nali zar quando foi l igada ou desli gada.

1. Insira no XObjectDadosBomba um objeto Configuração de Alarmes.

2. No objeto ConfigAlarmes, ins ira uma nova Área com o nome de "Bombas".

3. Na Área Bombas, insi ra um Alarme Digital para a propriedade DadosBomba.Ligado.

4. Configure as mensagens do Alarme conforme desejar.

5. Para tratar este Alarme como um Evento, abra a sua janela de propriedades e, na aba Fonte, selecione a opção Tratar estealarme como um evento.

13.4.3 Campos do UsuárioPor padrão, pode-se inclui r na tabela de alarmes até quatro campos de usuári os, podendo ser adicionados mais campos apartir do Servidor de Alarmes. Usaremos o Campo de Usuário 1 para salvar a descrição do tanque e o Campo de Usuário 2para inserir o motivo do reconhecimento do alarme.

1. Abra a janela de propriedades da Área Tanques do XObjectDadosTanque e configure o Campo1 (Campos de Usuário)para salvar a descrição (propriedade DocString) do objeto Tanque.

Propriedades da Área Tanques

2. Verifique se a propriedade DocString dos tanques está corretamente configurada.

3. Para justificar o motivo de reconhecimento de um Alarme, insi ra na pasta Dados um Tag Interno chamado"MotivoReconhecimento".

Tag MotivoReconhecimento

4. Abra a janela de propriedades do Servidor de Alarmes e configure o Campo2 (aba Campos do usuário) para salvar omotivo de reconhecimento do Alarme.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 48/8044 Alarmes

Propriedades do Servidor de Alarmes

13.4.4 E3AlarmPara visualizar os alarmes em tempo real, use o objeto E3Alarm e, na opção Filtrar por Tipo, selecione Alarmes e Eventos.

1. Na parte inferior da Telainicial, insira um objeto E3Alarm.

2. Configure o campo Nome do Servidor de Alarmes.

3. Selecione as colunas e cores de sua preferência . Não se esqueça de selecionar os Campos de Usuário 1 e 2.

Vamos configurar uma opção de filtro através de uma lista de seleção. Caso seja selecionado o item Todos, não deve haverfiltro. Caso contrário, deve exibi r apenas a Área selecionada na l is ta de seleção.

1. Insira, ao lado do objeto E3Alarm, uma Lista de Seleção (Combo Box ) e altere seu nome para "cbFi ltroAlarme".

2. No evento OnStartRunning, insi ra o s cript a seguir para preencher a l is ta de seleção.'Limpar a listaClear()'Adicionar itensAddItem "Todos"AddItem "Tanque"AddItem "Bomba"

3. No E3Alarm, crie uma Associação Múltipla no campo AreaFilter  com a expressão TelaInicial.cbFiltroAlarme.Value ="Todos".

4. Adici one duas l inhas na Associ ação Múltipla. Para o valor 0 (zero), o fil tro deve receber o valor da li sta de seleção. Para ovalor -1, deve receber uma String vazia.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 49/80Alarmes 45

Associação Múltipla

5. Teste a nova funcionalidade.

13.4.5 Assinatura EletrônicaPara reconhecer um Alarme, é necessá rio informar um usuári o vál ido e o motivo do reconhecimento.

1. Insi ra um botão próximo ao E3Alarm para reconhecer o Alarme selecionado.

2. No evento Click deste botão, insi ra o s cript a s eguir.

Set alarme = Screen.Item("E3Alarm1").GetFocusedEvent()

ObjName = alarme.AlarmSourceNameDescription = alarme.MessageAction = "Reconhecimento de alarme"

If Application.ESign(ObjName, Description, Action, "", "",_  Usuario, Comentario) Then  'Motivo do reconhecimento  Application.GetObject("Dados.MotivoReconhecimento").Value = Comentario

  'Reconhece o alarme  Screen.Item("E3Alarm1").AckSelected(Usuario)  'Limpa o motivo  Application.GetObject("Dados.MotivoReconhecimento").Value = ""End If

3. Execute a aplicação e teste a nova funcionali dade.

13.4.6 E3BrowserOs Alarmes gravados na tabela de alarmes são vis uali zados em um E3Browser. Para separar os tipos de informação (entrada,reconhecimento e saída do Alarme), mudaremos a cor do texto da li nha.

1. Insi ra uma nova Tela, chamada "TelaAlarmes", com o tamanho de 500 por 500 pixels.

2. Insira um E3Browser nesta Tela.

3. Configure o E3Browser para exibir a tabela Alarms. Selecione os campos ConditionActive, InTime, OutTime e AckTime emais os ca mpos de sua preferência.

4. Para colorir o E3Browser simulando o E3Alarm, no evento OnDrawRow insi ra o script a seguir.

ConditionActive = GetColumnValue(0)InTime = GetColumnValue(1)

OutTime = GetColumnValue(2)AckTime = GetColumnValue(3)

'Alarme ativoIf ConditionActive = 1 Then  'Entrada de alarme ou reconhecimento  If AckTime = "00:00:00" Then 'Entrada

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 50/8046 Alarmes

  RowTextColor = vbRed  Else 'Reconhecimento  RowTextColor = vbBlue  End IfElse  'Saida de alarme ou reconhecimento  If AckTime = "00:00:00" Then 'Saida  RowTextColor = vbBlack  Else 'Reconhecimento  RowTextColor = vbBlack  End If

End If

5. Ins ira na TelaInicial um botão para abri r a TelaAlarmes.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 51/80Relatórios 47

14RelatóriosCAPÍTULO

O Relatório é um componente ActiveX chamado ActiveReport, que permite a visualização e impressão de valores instantâneosde variáveis do si stema e dados armazenados em Banco de Dados (Alarmes, Históricos , Consul tas e Fórmulas ). Para utili zar oRela tório, cl ique com o botão direito do mouse no i tem Visualização - Relatórios do Organizer, em modo Domínio, selecione aopção Inserir Relatório em e em seguida o nome do projeto desejado.

O Relatório também utiliza o objeto Consulta. Este objeto permite que seja especificada a origem dos dados do Banco deDados que são visual izados no Relatório.

Um Relatório contém várias Seções. Cada Seção do Relatório contém um grupo de controles que são processados e impressosao mesmo tempo, como uma unidade.

14.1 Group Header e FooterUm Relatório pode ter múltiplos Grupos. Cada Grupo possui uma Seção Header e uma Seção Footer. A Seção Header imprimeantes de qualquer Seção Detail no Grupo. A Seção Footer imprime depois da Seção Detail do Grupo.

Através do Group Footer vamos mostrar as estatísticas de cada Grupo, separadas por col una:

Soma de todos os dados

Valores máximo e mínimo que foram armazenados

Média

14.2 Exercícios

14.2.1 Relatório1. Insira um Relatório no projeto, chamado "RelatorioAlarmes".

2. Clique com o botão direito do mouse no objeto Consulta1 do Relatório e selecione a opção Configurar.

3. Selecione o Banco de Dados e, na sequência, a tabela Alarms.

4. Selecione o campo E3TimeStamp e mais os campos que desejar.

5. Para cada campo selecionado na Consulta, insira um Campo de Dados na Seção Detail e configure sua propriedadeDataField.

6. Finalize o design do Relatório conforme sua preferência.

14.2.2 Group Header e Footer1. Clique com o botão direito do mouse no fundo do Relatório e selecione a opção Insert - Group Header/Footer. Esta opção

ins ere um novo Grupo no Relatório.

Inserir Group Header ou Footer

2. Na propriedade DataField do GroupHeader1, escreva a expressão ou campo pelo qual deseja agrupar os dados. Nossosdados vão ser agrupados por minuto.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 52/8048 Relatórios

Inserir expressão em um Campo

3. Copie o campo E3TimeStamp, da seção Detail para a seção GroupFooter1.

4. Para cal cular o número de regis tros no minuto modifique, no Campo de Dados E3TimeStamp no GroupFooter1, aspropriedades conforme a figura a seguir.

Propriedades de E3TimeStamp

5. À frente do Campo de Dados, ins ira um texto fixo com a express ão "Número de alarmes no minuto".

14.2.3 Imprimir1. Na TelaAlarmes, ins ira um Botão de Comando e altere a propriedade Caption para "Imprimir".

2. Insira um Pick do tipo Imprimir Relatório e selecione o RelatorioAlarmes para s er impresso na Tela .

14.2.4 ExportarPara que o usuári o escolha o nome e diretório do arquivo que vai ser gerado, vamos abrir uma ca ixa de diá logo.

1. Na TelaAlarmes, ins ira um Botão de Comando e altere a propriedade Caption para "Exportar".

2. Crie o script a seguir.

'ExportarIf Application.ShowFilePicker(False, NomeArquivo,"pdf", _  128, "Arquivos PDF|*.pdf|Todos os arquivos|*.*") Then

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 53/80Relatórios 49

  Set Report = Application.LoadReport("RelatorioAlarmes")  Report.Export "PDF", NomeArquivoEnd If

3. Com o auxílio do AppBrowser, selecione o método ShowFilePicker do Viewer.

Application.ShowFilePicker(Open, FileName, Extension, Flags, Filter)

4. Como desejamos sal var um arquivo, substitua o parâmetro Open por "False".

5. O parâmetro FileName deve ser uma variável interna de script, que armazena o nome do arquivo. Substitua-o por

"NomeArquivo".

6. Caso não seja i nformada a extensão do arquivo, consi dera-se como padrão o que for informado no parâmetro Extension.Digite "pdf".

7. Para que uma mensagem de confirmação apareça para o usuári o caso o arquivo já exista, altere o parâmetro Flags para"128".

8. As cai xas de diál ogo de arquivos permitem filtros para facilitar a busca por tipos de arquivos.

Filtro de arquivos

9. O filtro é sempre um par de Strings separadas pelo caractere "|", sendo que o primeiro i tem é o nome que aparece para o

usuári o e o segundo é uma identific ação para o si stema operacional .10. Substitua o parâmetro Filter  por "Arquivos PDF|*pdf | Todos os arqui vos| *.*".

11. O arquivo só pode ser gerado se o usuári o cli car em Salvar. Se o usuário cancelar a ação, nada deve acontecer. No iníciodo comando ShowFilePicker, digi te "If" e ao fina l digi te "Then".

12. Para exportar o Relatório, selecione no AppBrowser o item Tarefas - Carregar relatório - RelatorioAlarmes e, à direita, ométodo Export.

Set Report = Application.LoadReport("RelatorioAlarmes")Report.Export([ExportFilter], [ExportFileName])

13. Substitua o parâmetro ExportFilter  por "PDF" e o parâmetro ExportFileName pela variável NomeArquivo, criadaanteriormente.

14. Teste a nova funcionalidade da apli cação.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 54/8050 E3 WebViewer

15E3 WebViewerCAPÍTULO

O E3 WebViewer é um componente ActiveX que permite ao navegador comportar-se como o E3 Viewer, visualizando econtrolando aplicações E3 via Internet. Desta forma, é possível visualizar e interagir com um processo de chão de fábricaatravés de um navegador web comum. O navegador pode estar em qualquer computador da rede que tenha acess o ao E3Server.

Depois de instalado, o E3 WebViewer funci ona exatamente como o E3 Viewer, executando o download  da a plicação (Telas ,bitmaps, etc.) para a máquina local. Todas as funcionalidades do E3 Viewer (E3Chart, E3Alarm, etc.) são suportadas pelo E3WebViewer.

15.1 Aplicações E3 na WebPara que apli cações E3 estejam disponíveis na web, é preciso util izar um servidor de Internet que execute corretamente osscr ipts da página do controle E3 WebViewer. Qual quer servidor de Internet pode ser utili zado, desde que execute páginas ASP.

15.1.1 IIS (Internet Information Services)Um servidor de Internet fornecido j untamente com o Windows é o servidor I IS (Internet Information Services). Para instalá-lo noWindows Server 2003 SP2 e Windows XP SP3, siga estes passos:

1. Abra o menu Iniciar - Painel de Controle (Start - Control Panel ).

2. Cl ique em Adicionar ou remover programas ( Add or remove programs).

3. Cl ique em Adicionar ou remover componentes do Windows ( Add or remove Windows component ).

Assistente de componentes do Windows

4. Selecione na lista o item Serviços de Informações da Internet (Internet Information Services) e clique em Avançar (Next ).

5. O sis tema i nicia a instalação do software (para i nstalar o IIS é preciso ter o CD de instalação do Windows).

6. Aguarde a finalização do processo para configurar o sis tema.

7. Para o Windows Server 2003 SP2, deve-se habilitar as opções Páginas do Active Server ( Active Server Pages) e Conector dedados da Internet (Internet data connector ).

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 55/80E3 WebViewer 51

Opções Páginas do Active Server e Conector de dados da Internet

Para instalar o IIS no Windows Vista SP2, Windows 7 SP1, Windows 8 e Windows 8.1, execute os passos a seguir, utilizandouma conta com direitos de administrador:

1. Abra o menu Iniciar - Painel de Controle (Start - Control Panel ) no Windows Vista SP2 e Windows 7 SP1, ou abra o itemAplicativos - Sistema do Windows - Painel de Controle ( Apps - Windows System - Control Panel ) na tela Inicial do Windows 8e Windows 8.1.

2. Cl ique em Programas e Recursos (Programs and Features).

3. Cl ique em Ativar ou desativar recursos do Windows (Turn Windows features on or off ).

4. Localize na lista o item Serviços de Informações da Internet  (Internet Information Services) e cl ique em para expandirtodos os seus subi tens.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 56/8052 E3 WebViewer

Recursos do Windows

5. Selecione, no mínimo, as opções a seguir e cli que em OK.

Ferramentas de Gerenciamento da Web (Web Management Tools)

Console de Gerencia mento do IIS (IIS Management Console)

Scripts e Ferramentas de Gerenciamento do IIS (IIS Management Scripts and Tools)

Serviço de Gerencia mento do IIS (IIS Management Service)

Serviços da World Wide Web (World Wide Web Services)

Recursos de Desenvolvimento de Aplicativos ( Application Development Features)ASP

Extensões ISAPI (ISAPI Extensions)

Filtros ISAPI (ISAPI Filters)

Recursos Http Comuns (Common Http Features)

Conteúdo Estático (Static Content )

Documento Padrão (Default Document )

Redirecionamento de HTTP (HTTP Redirection)

Segurança (Security )

Autenticação Bás ica (Basic Authentication)

Filtragem de Solicitações (Request Filtering)

6. O sis tema i nicia a instalação do software. Aguarde a finali zação do processo para configurar o si stema.

15.1.2 Arquivos WebApós a instalação do IIS, todos os a rquivos da pasta C:\Arquivos de programas\Elips eE3\Web devem ser copiados para C:\InetPub\wwwroot. Esta pasta é criada na instalação do IIS. Além destes arquivos, o instalador do E3 WebViewer(e3webviewer-x86-ptb.exe) também deve ser copi ado para esta mesma pas ta. Este arquivo pode ser obtido através dedownload  no s ite da El ips e. Um detalhe muito importante é que a versã o destes instal adores deve ser exatamente a mesma

versão do E3 Server.

Qualquer usuário, desde que esteja devidamente autorizado pelas políticas de segurança e acesso da empresa, podevisual izar e controlar uma apli cação E3 na I nternet através de seu navegador. Alguns requisi tos bási cos s ão necessários:

Ter um PC com Windows XP

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 57/80E3 WebViewer 53

Ter um navegador Internet Explorer 5.5 ou superior

Ter acesso à Internet

O servidor verifi ca s e o cli ente tem um WebViewer instal ado e atual izado. Se não exis tir, o pacote do WebViewer é enviadopara a instalação no cliente.

Aviso de Segurança

Quando o usuário confirmar o aviso de segurança, o plug-in é instalado. O componente é assinado pela Elipse Software, e ousuário deve aceitar sua instalaç ão para que ele inici e as configurações necessárias.

No acesso s eguinte não é mais necessári o ins tala r os componentes, e o tempo de conexão é mais rápi do.

15.2 Arquivos E3Web.asp e DocWrite.aspOs arquivos E3Web.asp e DocWrite.asp têm a função de carregar e iniciar o ActiveX E3Downloader. O arquivoe3downloader.cab é o ActiveX que é enviado para a máquina cliente e executa a instalação do arquivo e3webviewer-x86-

ptb.exe. Os arqui vos e3web2.asp e docwrite2.asp têm a função de carregar e ini ciar o ActiveX do WebViewer que mostra aaplicação sendo executada na máquina do Internet Explorer. Todos ficam disponíveis para configuração do usuário. Estesarquivos fi cam local izados no diretório onde o E3 foi i nstalado, na pasta Web.

A página docwrite2.asp vem configurada cons iderando-se que o E3 Server está roda ndo no mesmo computador que o E3WebServer (servidor web). Porém, é poss ível al terar o código fonte desta página para atender a confi guração desejada. Paramaiores informações, consulte o Manual do Usuário do E3. É possível editar o arquivo docwrite2.asp incluindo a lgumasconfigurações. Caso se queira permitir ao usuário informar uma tela i nicial váli da, diferente da configurada no Domínio,deve-se alterar a linha a seguir, colocando em Nome_da_tela um nome de Tela váli do na apl icação.

<param name="Screen" value="Nome_da_tela">

Caso se queira informar a necessidade de se executar o comando ping para o servidor antes de tentar a conexão, deve-sealterar a l inha a seguir. O valor pode ser True ou False.

<param name="Ping" value="TRUE">

Se esta linha for omitida, o comando ping é executado. A configuração do E3 WebViewer para abrir no modo Somente Leituraé feita através 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">

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 58/8054 E3 WebViewer

  </object>  </body></html>

15.3 Configurando o Internet Information ServicesSão necessári as algumas configurações no I IS para que a apli cação E3 poss a ser acessada via Web. Antes de tudo, deve-seli berar o acesso à porta TCP 6515 (porta utili zada pelo Servidor E3 para comunicação com o WebViewer), e também a portapadrão do IIS, normalmente a 80.

Existem duas configurações possíveis para a organização dos servidores E3 e IIS, o E3Server e o IIS no mesmo servidor ou em

servidores distintos. Neste Tutorial é abordada apenas a primeira opção. Informações detalhadas sobre este assunto podemser obtidas no Knowledgebase da Elipse (kb.elipse.com.br ), no artigo Publicando aplicações E3 na Internet com o MicrosoftInternet Information Services.

E3 Server e IIS no mesmo servidor

15.3.1 Windows Server 2003 e Windows XPNo Windows Server 2003 SP2 e Windows XP SP3, siga estes procedimentos:

1. Abra o menu Iniciar - Painel de Controle - Ferramentas Administrativas (Start - Control Panel - Administrative Tools).

2. Cl ique em Serviços de Informações da Internet (Internet Information Services), no caso do Windows XP SP3, ou emGerenciador de Serviços da Internet (Internet Services Manager ), no caso do Windows Server 2003 SP2.

3. Clique com o botão direito do mouse no item Site da Web Padrão (Default Web Site), e selecione o item Novo - Diretóriovirtual (New - Virtual directory ).

Adicionar novo Diretório virtual

4. Na próxima janela, utili ze qualquer nome conveniente e fácil de ser digi tado futuramente na barra de endereços.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 59/80E3 WebViewer 55

Alias do diretório virtual

5. O diretório padrão pode ser livremente modificado conforme conveniência do usuári o. A dica é manter o diretório padrãopara reduzir o número de etapas até o fim da confi guração.

Diretório de conteúdo do site da Web

6. As permissões Leitura (Read ) e Executar scripts (Run scripts) são sufici entes para que a apli cação esteja totalmentefuncional via Internet.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 60/8056 E3 WebViewer

Permissões de acesso

7. Após final izar estas configurações, é necessári o definir qual arquivo é executado ass im que o usuário pressionar a teclaENTER após digi tar o endereço no navegador.

8. Clique com o botão direito do mouse no novo diretório virtual e selecione a opção Propriedades (Properties).

Propriedades do diretório virtual9. Cl ique em Remover (Remove) para excluir todos os documentos dis poníveis no quadro Ativar documento padrão ( Activate

default document ). Em seguida, clique em Adicionar ( Add ) para incluir o arquivo e3web.asp. Este é o arquivo chamadoquando o usuário acess a o s ite onde a apl icação está hospedada.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 61/80E3 WebViewer 57

Ativar documento padrão

10. Na aba Diretório virtual (Virtual directory ) selecione, na cai xa de seleção Permissões de execução (Execute permissions), aopção Somente scripts (Scripts only ). Agora, a apli cação já está publicada e pronta para ser acessada.

Aba Diretório virtual

11. Para vi sual izar a apli cação, digite na barra de endereços do navegador o endereço ou IP do servidor (por exemplo, http:// 

servidor/diretoriovirtual ).

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 62/8058 E3 WebViewer

15.3.2 Windows VistaNo Windows Vista SP2 (IIS 7), si ga estes procedimentos.

1. Abra o menu Iniciar - Painel de Controle - Ferramentas Administrativas (Start - Control Panel - Administrative Tools).

2. Cl ique em Gerenciador de Serviços e Informações na Internet (IIS) (Internet Information Service (IIS) Manager ) e cli que emContinuar (Continue).

3. Clique com o botão direito do mouse no item Site da Web Padrão (Default Web Site) e selecione a opção Adicionar DiretórioVirtual ( Add Virtual Directory ).

Adicionar Diretório Virtual

4. No campo Alias, digite um nome conveniente e fácil, pois é utilizado para acessar o diretório na barra de endereços do

navegador. Em Caminho físico (Physical path), cl ique em e selecione o diretório onde os arqui vos foram armazenados(neste exemplo foi utilizado C:\Inetpub\wwwroot\). Clique em OK.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 63/80E3 WebViewer 59

Caminho físico dos arquivos

5. Clique no Diretório Virtual criado, que está em Site da Web Padrão (Default Web Site), e selecione a opção DocumentoPadrão (Default Document ), dentro do quadro central .

Documento padrão

6. Cl ique em Adicionar ( Add ) no painel Ações ( Actions), digite "e3web.asp" no campo Nome (Name) e clique em OK.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 64/8060 E3 WebViewer

Adicionar documento padrão

7. Após estes procedimentos, a estação cli ente pode acessar o servidor HTTP através do Internet Explorer. Para vis uali zar aaplicação, digite na barra de endereços do navegador o endereço ou IP do servidor (por exemplo, http://servidor/ 

diretoriovirtual ).

15.3.3 Windows 7No Windows 7 SP1, siga estes procedimentos:

1. Abra o menu Iniciar - Painel de Controle - Ferramentas Administrativas (Start - Control Panel - Administrative Tools).

2. Cl ique em Gerenciador do Serviços de Informações da Internet (IIS) (Internet Information Services (IIS) Manager ).

3. Clique com o botão direito do mouse no item Site da Web Padrão (Default Web Site) e selecione a opção Adicionar DiretórioVirtual ( Add Virtual Directory ).

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 65/80E3 WebViewer 61

Adicionar diretório virtual

4. No campo Alias, digite um nome conveniente e fácil, pois é utilizado para acessar o diretório na barra de endereços do

navegador. Em Caminho Físico (Physical Path), cl ique em e selecione o diretório onde os arqui vos foram armazenados(neste exemplo foi utilizado C:\Inetpub\wwwroot\). Clique em OK.

Caminho físico dos arquivos

5. Clique no Diretório Virtual criado, que está em Site da Web Padrão (Default Web Site), e selecione a opção DocumentoPadrão (Default Document ), dentro do quadro central .

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 66/8062 E3 WebViewer

Documento padrão

6. Cl ique em Adicionar ( Add ) no painel Ações ( Actions), digite "e3web.asp" no campo Nome (Name) e clique em OK.

Adicionar documento padrão

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 67/80E3 WebViewer 63

7. Após estes procedimentos, o computador cli ente pode acessar o servidor web util izando o navegador Internet Explorer.

15.3.4 Windows 8 e Windows 8.1No Windows 8 e Windows 8.1, siga estes procedimentos:

1. Na tela Inicial, abra o item Aplicativos - Sistema do Windows - Painel de Controle - Ferramentas Administrativas ( Apps -

Windows System - Control Panel - Administrative Tools).

2. Abra o item Gerenciador do Serviços de Informações da Internet (IIS) (Internet Information Services (IIS) Manager ).

3. Clique com o botão direito do mouse no item Site da Web Padrão (Default Web Site) e selecione a opção Adicionar DiretórioVirtual ( Add Virtual Directory ).

Adicionar diretório virtual

4. No campo Alias, digite um nome conveniente e fácil, pois é utilizado para acessar o diretório na barra de endereços do

navegador. Em Caminho físico (Physical Path), cl ique em e selecione o diretório onde os arqui vos foram armazenados(neste exemplo foi utilizado C:\Inetpub\wwwroot\). Clique em OK.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 68/8064 E3 WebViewer

Caminho físico dos arquivos

5. Clique no Diretório Virtual criado, que está em Site da Web Padrão (Default Web Site), e selecione a opção DocumentoPadrão (Default Document ), dentro do quadro central .

Documento padrão

6. Cl ique em Adicionar ( Add ) no painel Ações ( Actions), digite "e3web.asp" no campo Nome (Name) e clique em OK.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 69/80E3 WebViewer 65

Adicionar documento padrão

7. Após estes procedimentos, o computador cli ente pode acessar o servidor web util izando o navegador Internet Explorer.

15.4 Questões de LicenciamentoDeve-se consi derar o número de li cenças para acesso, pois cada WebViewer conectado consome uma l icença de Viewer, comose estivesse fora do browser. Sempre que necessário, podem ser adquiridas novas licenças de Viewer, possibilitando ummaior número de acessos simultâneos.

15.5 Exercícios1. Siga o conteúdo do capítulo e publique uma apli cação do E3 na Internet.

15.6 Exercícios Complementares

15.6.1 Restrições de IP e Número de AcessosCom este recurso, é possível bloquear totalmente a conexão, ou ainda limitar a quantidade e o tipo de licenças que sãousadas simultaneamente para um determinado grupo de IPs.

1. Para acessar os grupos de Viewers, cli que com o botão direito do mouse no ícone do E3 na Área de Notificação doWindows e selecione o item Domínio - Opções.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 70/8066 E3 WebViewer

Domínio - Opções

2. Cl ique na aba Grupos de Viewers e configure os grupos que desejar.

Grupos de Viewers

15.6.2 KBKB-32109: Licença para E3WebViewer.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 71/80Event Log Viewer 67

16Event Log ViewerCAPÍTULO

O Elipse Event Log Viewer é um si stema de logs desenvolvido pela Elipse Software. Os process os do E3 usa m um formatobinári o para gravação de eventos, disponível para s is temas operacionais Windows XP ou superiores e, para s is temasanteriores, os logs são gravados em arquivos de texto.

Os arquivos são armazenados em formato estruturado que permite uma série de funcionalidades como filtros, gravação demensagens binárias, ordenamento e pesquisa.

O Event Log Viewer é um controle ActiveX que pode ser i ntegrado ao E3, para que seja poss ível o acompanhamento dosprocessos do E3 de dentro da aplicação e possui um serviço de controle e gerenciamento de arquivos pelo sistema, quegarante a manutenção de um tamanho máxi mo de arqui vos em disco sem esgotamento do espaço dis ponível.

Para util izar o Log Viewer, acess e o menu Iniciar - Programas - Elipse Software - Elipse Event Log - Log Viewer.

16.1 Configuração do Armazenamento de ArquivosAtravés da opção Storage Settings, é possível configurar o gerenciamento automático dos arquivos .etl ou .log gravados peloE3. Com ela , é possível gerenciar onde os arqui vos de log s erão armazenados, o tamanho máxi mo do repositório, e o tempoque cada arquivo permanecerá no repositório (com base na data de criação do arquivo). Selecione o menu View - Storage

Settings, ou cl ique em .

Janela Storage Settings

16.2 Abertura de ArquivosOs arqui vos de l og com extensão .etl podem ser abertos no Log Viewer de três formas:

Através do menu File - Open

Através do ícone na barra de ferramentas

Arrastando o arquivo até a j anela

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 72/8068 Event Log Viewer

Janela de visualização de eventos

Na área de visualização de eventos, os arquivos são ordenados cronologicamente, um evento por linha.

16.3 Merge de EventosCom o Log Viewer, também é possível a brir mais de um arquivo ao mesmo tempo e mesclar s uas informações como se fosseum único arqui vo. Os eventos são ordenados cronologicamente, de modo a permitir a análi se de eventos de caus a e

consequência entre máquinas di ferentes ou entre arqui vos diferentes. Cli que em ou use o menu File - Open Merged Files eselecione os arquivos que deseja mescl ar c li cando em Add file.

Janela Merge Files

16.4 FiltrosEsta seção contém informações sobre a fil tragem de eventos no Elipse Event Log Viewer.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 73/80Event Log Viewer 69

16.4.1 Filtro de MensagensO Filtro de Mensagens permite restringir o intervalo dos eventos através da seleção do tipo de mensagem a ser mostrado. Para

acessar esta opção, selecione o menu Actions - Filter Editor ou cl ique em e cl ique na aba By Message.

Janela Filtro de Mensagem

Ao clicar em Help, é mostrada uma janela com a si ntaxe correta para ca da pal avra chave váli da. Quando mais de um valor forusado em uma palavra-chave, é necessário separá-los com uma vírgula. A ordem de avaliação dos scripts de filtro é dada porum OR entre palavras chave e um AND entre li nhas. Exemplo:

Process == (0xC48,0x9C8);Module == ("MANAGER______");

Isto si gnifica que apenas s ão exibidos eventos que satisfaça m à equação lógica a seguir.

(Process == 0xC48 OR 0x9C8) AND Module == MANAGER______

Para ligar o filtro, use a opção correspondente na barra de ferramentas.

16.4.2 Filtro de TempoO Filtro de Tempo permite restringir o intervalo das mensagens através da seleção de data e hora i niciai s e finai s a serem

mostradas. Para acessar esta opção, selecione o menu Actions - Filter Editor ou cl ique em e cl ique na aba By Time. No fil tropor tempo, a hora inici al é incluída, mas a final é excluída.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 74/8070 Event Log Viewer

Janela Filtro de Tempo

16.5 Exercícios1. Abra o Event Log Viewer.

2. Selecione o arquivo com a data atual para ser visual izado.

3. Faça testes de fil tros por mensagem e por tempo.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 75/80E3 Tweak 71

17E3 TweakCAPÍTULO

O E3 Tweak é uma pequena e si mples ferramenta de configuração a vançada para o E3, que está presente a partir da versão3.1. A grande finalidade é introduzir uma interface gráfica para todas aquelas configurações que até então só poderiam serfeitas através do Editor do Registro do Windows.

O E3 Tweak é apresentado em uma j anela com itens de configuraçã o dis postos em uma estrutura de árvore. Os i tens s ãoclas si ficados conforme a área na qual suas configurações atuam: E3 Server, E3 Run, REC, Logs e COMFilter.

17.1 Configurações do E3 ServerDefinir Número de Tentativas de Leitura da Hardkey

Configura o número de tentativas de leitura do HASP, executadas quando o E3 Server é ini ciado. Se configurado o valor 0(zero), o modo Demo é habil itado automatica mente.

Desabilitar Múltiplas CPUs

No caso de computadores bi-process ados, é possível configurar o E3 Server para util izar a penas a pri meira ou todas as CPUsdisponíveis no si stema.

Definir o Timeout para o Ping

O ideal é que seja sempre usado o menor val or possível permitido pela rede. Isto faz com que o E3 Server detecte a queda dosViewers no mínimo tempo possível, evitando o empil hamento excess ivo de mensagens.

Configurar o Heartbeat da Licença

Na conexão de licença do servidor com o Viewer é aplicado por padrão um keep-alive (ou heartbeat ). Se o Viewer passar algumtempo sem responder, sua conexão é desfeita automaticamente. Se o valor for 0 (zero), o heartbeat  é desl igado.

Configurar a Porta TCP/IP Utilizada pelo REC

O valor configurado indica o número da porta utilizada pelo protocolo REC. Podem ser usados valores maiores que 1024 e até65535. Valores i guais ou abai xo de 1024 são reservados. Valores nulos ou invál idos habi li tam a utili zação da porta 6515.

Definir Timeout para o Fim do E3Run

O valor configurado indica o tempo máximo, em milissegundos, para que o E3Run seja encerrado.

17.2 Configurações do E3 RunOcultar a Janela de Progresso

É possível optar entre exibir ou ocultar a janela de progresso do E3 Run.

Definir Tamanho da Pilha da Thread de Runtime

O E3 Server armazena a s chamadas de funções em uma estrutura temporária em tempo de execução cha mada de Pilha daThread e, conforme as funções vão sendo processadas, são retiradas desta pilha. Embora não seja recomendado, o tamanhodesta pi lha pode ser aj ustado. O ca mpo de ediçã o deve receber um val or numérico em megabytes a ser us ado. Se este item nãoé marcado, o valor da pilha é fixado em 4 megabytes. O valor 0 (zero) indica que deve ser usado o tamanho padrão doWindows (1 MB). O valor máximo desta variável é 256.

17.3 Configurações do RECDefinir Nível de Compressão

É possível habi li tar a compactação de pacotes de comunicação através do REC entre o E3 Server, o Viewer e o E3 Studio.Qualquer valor entre 1 e 9 ativa a compactação. O valor recomendado é 6. Quaisquer valores fora desta faixa desabilitam acompactação de pacotes do REC.

Esta configuração é apl icada s omente para a compactação do E3 Server ou do Viewer rodando loca lmente na máquina. Tantoo E3 Server quanto o Viewer s uportam descompactaçã o de pacotes, independente de suas configurações.

Definir o Timeout da Conexão

Controla o tempo máxi mo que o E3 Studio ou o E3 Admin levam para conectarem-se ao E3 Server. Quando o item não estáselecionado, é ass umido o val or padrão de 6000 ms.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 76/8072 E3 Tweak

17.4 Configurações dos LogsDefinir o Tempo Mínimo da Função de Gravar Logs

É possível definir o tempo mínimo para logar uma função nos logs Full (funções que durarem menos que este tempo não sãologada s). Quando este item está desmarca do, ass ume-se o valor padrão de 100 ms.

Definir o Tempo para Avisos de Funções Travadas

É possível definir o tempo (em milissegundos) que uma função deve estar rodando para que seja gerado um aviso(EcoLogWarning) de que a função provavelmente está trancada. O valor zero no campo de edição com o i tem marcado

desabilita a opção. Se não for zero, o valor mínimo aceito é 20000.

Habilitar ou Desabilitar as Seções de Logs

É possível definir as seções de log que são habilitadas. Algumas seções podem ser subdivididas em módulos, sendo possívelhabil itar cada módulo separadamente.

17.5 Configurações do COM FilterHabilitar Filtro

O E3 Run implementa um fil tro de chamadas COM (Component Object Model ) visando evitar chamadas reentrantes. Este filtropor padrão está desabilitado e para habilitá-lo (recomendável apenas nos sistemas que apresentarem erros ou travamentosaparentemente sem caus a), pode-se selecionar o i tem Habilitar filtro.

17.6 Exercícios1. Altere o número de retentativas de reconhecimento do disposi tivo de proteção para 10 retentativas .

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 77/80Preparatório para a Certificação 73

18Preparatório para a CertificaçãoCAPÍTULO

Leituras recomendadas:

Como o Elipse E3 funciona

Noções de VBScript no Software Elipse E3: Introdução

Usando Bibliotecas no Elipse E3: Introdução

Usando o Viewer no E3: Introdução

Usando Bancos de dados no E3: Introdução

Seguem alguns exercícios para estudar para a prova de certificação:

1. Util izando os recursos gráficos do E3 (círculo, retângulo, linhas , etc.), crie um velocímetro.

2. Crie uma apli cação com um gráfico. Ao entrar na Tela, o gráfico deve exibir os últimos 20 minutos.

3. Exporte um relatório gráfico para PDF.

4. Insi ra uma caixa de seleção na Tela que li sta o nome de todos os Tags Demo da Pasta de Dados. Ao selecionar um Tag nalista, um Display deve ser criado em tempo de execução e associado ao Tag selecionado.

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 78/80

A   Anotações

Anotações

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 79/80Anotações

7/21/2019 e3tutorial Certification Ptb

http://slidepdf.com/reader/full/e3tutorial-certification-ptb 80/80

MatrizRua 24 de Outubro, 353 - 10º andar90510-002 Porto Alegre RSFone: (51) 3346-4699Fax: (51) 3222-6226E-mail: [email protected]

Filial SPRua dos Pinheiros, 870 - Conj. 141/14205422-001 São Paulo - SPFone: (11) 3061-2828Fax: (11) 3061-2828E-mail: [email protected]

Filial PRAv. Sete de Setembro, 4698/170580240-000 Curitiba - PR

Fone: (41) 3342-0120Fax: (41) 3342-0120E-mail: [email protected]

USA2501 Blue Ridge Road, Suite 250Raleigh - NC - 27607 USAFone: +1 (252) 995-6885Fax: +1 (252) 995-5686E-mail: [email protected]

Filial MGRua Antônio de Albuquerque, 1567° andar Sala 705

30112-010 Belo Horizonte - MGFone: (31) 2511-2121E-mail: [email protected]

Taiwan9F., N.12, Beiping 2nd St., Sanmin Dist.807 Kaohsiung City - TaiwanFone: +886 (7) 323-8468Fax: +886 (7) 323-9656E-mail: [email protected]

Filial RJAv. Praia de Botafogo, 300/52522250-044 Rio de Janeiro - RJFone: (21) 2158-1015Fax: (21) 2158-1099E-mail: [email protected]