Académique Documents
Professionnel Documents
Culture Documents
I
6.3 Objeto _top ......................................................................................................................................... 154
6.4 Pasta do Viewer .................................................................................................................................. 154
7 Telas e Objetos de Tela ............................................................................................................................ 156
7.1 Tela ....................................................................................................................................................... 156
7.2 Objetos de Tela ................................................................................................................................... 158
7.3 Configuraes Gerais ......................................................................................................................... 162
7.4 Formatao de Cores ......................................................................................................................... 172
7.5 Formatao de Valores ...................................................................................................................... 173
8 Associaes ............................................................................................................................................... 177
8.1 Simples ................................................................................................................................................. 178
8.2 Bidirecional ......................................................................................................................................... 178
8.3 Digital .................................................................................................................................................. 179
8.4 Analgica ............................................................................................................................................ 180
8.5 Por Tabela ........................................................................................................................................... 180
8.6 Reversa ................................................................................................................................................. 181
8.7 Mltipla ............................................................................................................................................... 182
8.8 Edio de Associaes ........................................................................................................................ 183
9 Bibliotecas ................................................................................................................................................. 187
9.1 Galeria .................................................................................................................................................. 187
9.2 Biblioteca do Usurio (ElipseX) ......................................................................................................... 188
9.3 Quando Criar um ElipseX ................................................................................................................... 197
10 ActiveX ..................................................................................................................................................... 198
10.1 Objetos Microsoft Forms .................................................................................................................. 200
10.2 Elipse KeyPad .................................................................................................................................... 201
11 Servidor de Dados .................................................................................................................................. 203
11.1 Impressora de Linha .......................................................................................................................... 203
11.2 Pasta de Dados .................................................................................................................................. 205
11.3 Tag Contador ..................................................................................................................................... 206
11.4 Tag Demo .......................................................................................................................................... 207
11.5 Tag Interno ........................................................................................................................................ 208
11.6 Tag Timer ........................................................................................................................................... 209
12 Banco de Dados ...................................................................................................................................... 211
12.1 Access .................................................................................................................................................. 211
12.2 Oracle ................................................................................................................................................. 212
12.3 SQL Server ......................................................................................................................................... 216
12.4 Objetos do E3 e Permisses ............................................................................................................. 219
13 Alarmes ................................................................................................................................................... 220
13.1 Configurao de Alarmes ................................................................................................................. 220
13.2 Filtro de Alarmes .............................................................................................................................. 222
13.3 Fontes de Alarme .............................................................................................................................. 227
13.4 Servidor de Alarmes ........................................................................................................................ 234
II
14 E3Alarm .................................................................................................................................................. 243
14.1 Configuraes ................................................................................................................................... 243
14.2 Caractersticas Especficas de Tempo de Execuo ........................................................................ 252
15 Storage .................................................................................................................................................... 256
15.1 Configuraes ................................................................................................................................... 258
15.2 Configurao da Tabela ................................................................................................................... 259
16 Histrico .................................................................................................................................................. 269
16.1 Configuraes ................................................................................................................................... 270
17 Consultas ................................................................................................................................................. 278
17.1 Criando uma Consulta ...................................................................................................................... 279
17.2 Uso dos Filtros da Consulta atravs de Scripts ............................................................................... 285
17.3 Uso de Recordsets de uma Consulta atravs de Scripts ................................................................ 285
18 E3Browser ............................................................................................................................................... 286
18.1 Objeto Consulta no E3Browser ........................................................................................................ 286
18.2 Outras Configuraes ....................................................................................................................... 287
19 E3Chart .................................................................................................................................................... 291
19.1 Configuraes .................................................................................................................................... 291
19.2 Exemplos de Utilizao ..................................................................................................................... 313
19.3 Caractersticas Especficas de Runtime ............................................................................................ 315
20 E3Playback ............................................................................................................................................. 320
20.1 Objeto E3Playback ............................................................................................................................ 320
20.2 Adicionar Playback ao Demo do E3 ............................................................................................... 320
20.3 Interface de Usurio ........................................................................................................................ 324
20.4 Banco de Dados de Playback .......................................................................................................... 333
20.5 Configurao dos Objetos de Banco de Dados do E3 ................................................................... 335
21 Frmulas ................................................................................................................................................. 338
21.1 Configuraes ................................................................................................................................... 338
21.2 Templates .......................................................................................................................................... 340
21.3 Unidades ........................................................................................................................................... 342
21.4 Conjunto de Valores ........................................................................................................................ 342
21.5 Criao de uma Frmula ................................................................................................................. 343
22 Relatrios ............................................................................................................................................... 348
22.1 Objeto Consulta ................................................................................................................................ 348
22.2 Componentes ................................................................................................................................... 348
22.3 Configuraes .................................................................................................................................. 350
22.4 Criando um Relatrio no E3 ............................................................................................................ 361
22.5 Exemplos de Utilizao .................................................................................................................... 362
23 Segurana .............................................................................................................................................. 365
23.1 Usurios ............................................................................................................................................. 365
23.2 Grupos ............................................................................................................................................... 369
23.3 Permisses ......................................................................................................................................... 371
III
23.4 Proteo de Arquivos ...................................................................................................................... 375
24 E3 Viewer e E3 WebViewer ................................................................................................................... 379
24.1 Viewer Only (Modo Somente Leitura) ............................................................................................ 379
24.2 Execuo do E3 Viewer ................................................................................................................... 380
24.3 Logs do Viewer ................................................................................................................................. 383
24.4 Execuo do E3 WebViewer ........................................................................................................... 383
25 Hot-Standby ........................................................................................................................................... 387
25.1 Configurando .................................................................................................................................... 387
25.2 Executando um Domnio Redundante ........................................................................................... 388
25.3 Parando um Domnio Redundante ................................................................................................ 388
25.4 Parando um dos Servidores do Domnio ...................................................................................... 389
25.5 Tempo de Troca entre Servidores .................................................................................................. 389
25.6 Reconexo de Viewers ..................................................................................................................... 389
25.7 Utilizando Bancos de Dados com Hot-Standby ............................................................................ 389
26 Configuraes Avanadas ..................................................................................................................... 390
27 Dvidas mais Frequentes ...................................................................................................................... 391
27.1 Alarmes .............................................................................................................................................. 391
27.2 Associaes ....................................................................................................................................... 392
27.3 Bibliotecas ......................................................................................................................................... 393
27.4 Domnios e Projetos ........................................................................................................................ 393
27.5 Domnios Remotos ........................................................................................................................... 394
27.6 Drivers de Comunicao ................................................................................................................. 397
27.7 E3Alarm ............................................................................................................................................. 398
27.8 E3Browser ......................................................................................................................................... 398
27.9 E3Chart .............................................................................................................................................. 398
27.10 Histrico .......................................................................................................................................... 398
27.11 Impressora de Linha ........................................................................................................................ 399
27.12 Objetos de Tela ............................................................................................................................... 399
27.13 Ordem dos Tabs .............................................................................................................................. 399
27.14 Relatrios ........................................................................................................................................ 399
27.15 Servidor de Banco de Dados Oracle ............................................................................................. 400
27.16 Servidor de Banco de Dados SQL Server ...................................................................................... 401
27.17 Servidor de Dados .......................................................................................................................... 402
27.18 Sobreposio de Animaes nos Objetos .................................................................................... 402
27.19 Stored Procedure ........................................................................................................................... 402
27.20 Viewer ............................................................................................................................................. 403
IV
CAPTULO
Introduo
1
Desenvolvido pela Elipse Software, o E3 uma poderosa plataforma para superviso e controle de processos
totalmente voltada operao em rede e aplicaes distribudas. O E3 um sistema SCADA (Supervisory Control and
Data Acquisition) que oferece um avanado modelo de objetos, uma poderosa interface grfica, alm de uma
arquitetura que permite o rpido desenvolvimento de aplicaes e mxima conectividade com dispositivos e outros
aplicativos. Sua concepo incorpora as mais novas tecnologias em desenvolvimento de software, maximizando o
desempenho, a produtividade e a qualidade de suas aplicaes e do prprio processo, minimizando perdas e custos.
Os sistemas construdos com o E3 geralmente partem da coleta de dados em tempo real de equipamentos de
aquisio de dados ou de controle, como os CLPs (Controladores Lgicos Programveis), UTRs (Unidades Terminais
Remotas), DAQs (Data Acquisition Boards, Placas de Aquisio de Dados), controladores Multi-Loop ou Single-Loop,
centrais de incndio e balanas, dentre outros dispositivos. Estes equipamentos normalmente possuem alguma
interface que permitem sua conexo ao software, como padres seriais RS232, RS422 ou RS485; rdio ou modem
(linhas privadas ou discadas), TCP/IP ou UDP/IP, placas ligadas diretamente ao barramento do computador e outros.
O E3 l e escreve dados dos equipamentos atravs de mdulos (Drivers de Comunicao) que implementam o
protocolo (de domnio pblico ou privado) disponvel em cada um destes equipamentos. Estes Drivers podem ainda
estar em um formato prprio da Elipse Software ou no formato OPC (OLE for Process Control).
De posse dos dados, possvel criar vrias maneiras para exibir, analisar, controlar, comandar, gravar ou divulgar tais
informaes, dentre elas:
Telas: Permitem criar uma IHM (Interface Homem-Mquina) localmente, pela rede local ou Internet, com o intuito
de exibir o status atual ou passado dos dados em vrias formas, com o auxlio de um editor grfico e objetos
especficos
Alarmes e Eventos: Monitoram o acontecimento de situaes especficas
Histricos: Armazenam os dados em bancos de dados relacionais
Relatrios: Permitem visualizar e imprimir os dados, dentre outros mdulos e possibilidades
1.1.1 E3 Server
o Servidor de Aplicaes, onde os principais processos so executados, incluindo a comunicao em tempo real
com os equipamentos de controle. O servidor tambm responsvel por enviar dados e Telas aos clientes
conectados em qualquer parte da rede (intranet e Internet). O servidor pode executar vrios projetos ao mesmo
tempo e conversar com outros E3 Servers para realizar um fail-over (standby) ou distribuir cargas de processamento
entre as mquinas.
1.1.2 E3 Studio
Ferramenta nica de configurao, agindo como plataforma universal de desenvolvimento, que possui um ambiente
moderno e amigvel, incluindo um completo editor grfico e de scripts (VBScript). Permite que um projeto seja
editado por vrias pessoas ao mesmo tempo ou que vrios E3 Studios estejam conectados ao mesmo servidor
remoto, com mltiplas configuraes.
Introduo 1
1.1.3 E3 Viewer
Permite operar as aplicaes residentes no servidor a partir de qualquer computador com o programa executvel
Viewer ou com um navegador de Internet. Em ambos os casos, no necessrio instalar a aplicao na mquina
cliente, pois feito o download e o registro de todos os componentes (Telas, bibliotecas e controles ActiveX).
1.1.4 E3 Admin
o mdulo responsvel pela interface do E3 Server e de outros mdulos do E3 com o usurio. Atravs dele o usurio
pode enviar comandos ao E3 Server, utilizando o cone na rea de Notificaes do Windows, e controlar o Domnio
pela linha de comando.
1.2 Arquitetura
Para supervisionar um determinado processo com um sistema SCADA, geralmente construda uma aplicao que
contm a definio das variveis envolvidas, com nomes e endereamentos, Telas, definies de alarmes e outros, a
qual se chama Banco de Dados da Aplicao.
Quando este processo exige o uso de dois ou mais computadores, preciso fazer com que cada aplicao em cada
computador troque dados com as outras. A maioria dos sistemas SCADA tradicionais baseiam-se em uma arquitetura
comum para realizar esta tarefa:
Cada servidor SCADA deve ter uma cpia (parcial ou no) da aplicao configurada na base de dados local
Cada servidor SCADA possui e executa somente uma base de dados ao mesmo tempo
Isto leva a alguns problemas de gerenciamento, como aplicar mudanas a todos os servidores, controlar verses do
aplicativo ou ento trabalhar com diferentes fabricantes de software e hardware.
O E3 resolve este problema usando o conceito de Domnio que inclui, em um nico ambiente, a definio dos
computadores executando tarefas em tempo real (servidores) e as bases de dados de projeto que devem ser
executadas nestes servidores, com a possibilidade de execuo de vrios projetos em cada servidor. Tambm
possvel inserir, apagar ou modificar projetos durante a execuo, sem afetar as outras partes do Domnio em
execuo.
Cada projeto pode conter qualquer tipo de objeto, como Telas, Drivers de Comunicao, Alarmes, Histricos,
Relatrios, Frmulas e Bancos de Dados, dentre outros. Quando dois ou mais projetos esto dentro de um mesmo
Domnio, eles podem acessar as propriedades e objetos entre si como se estivessem residentes em uma nica base
de dados. Isto possvel atravs do uso de Associaes (conexes) que um objeto pode fazer com qualquer outro.
Se ambos os objetos existem e esto executando, a conexo est ativa e qualquer mudana de valor enviada
assincronamente entre as partes (dependendo do tipo da conexo). Se um dos objetos destrudo ou parado, a
conexo quebrada, ento a aplicao notificada e pode indicar seu estado em uma forma definida pelo usurio.
A estrutura do Domnio restrita aos servidores e afins, como as mquinas servidoras, projetos, usurios e senhas. A
interface do cliente para operao e visualizao, chamada E3 Viewer, pode se conectar diretamente a qualquer
servidor E3 (com licenas suficientes de Viewer). O E3 Viewer possui trs destaques especiais:
Os projetos da aplicao residem somente no servidor
O navegador Internet Explorer pode ser usado como interface de operao, sem nenhuma mudana
A interface do cliente capaz de alternar de um servidor desligado ou com falha para o prximo servidor
disponvel, sem interromper o monitoramento do processo
Como alternativa ao uso do E3 Viewer na mquina cliente, possvel utilizar a tecnologia Terminal Service. Este
servio surgiu no Windows NT 4.0 e sua funo permitir o acesso remoto entre computadores, atravs de um
protocolo chamado RDP (Remote Desktop Protocol). Este protocolo permite a interao entre uma estao cliente e
uma mquina servidora (que acessada remotamente). O E3 Viewer executado em uma nova sesso de usurio
criada na mquina servidora, que por sua vez transfere para a mquina cliente os dados de vdeo e recebe de volta
os eventos de mouse e teclado.
2 Introduo
Arquitetura do E3
possvel observar que, em todos os casos, o E3 Viewer continua sendo a interface de operao e visualizao. A
diferena est no local de execuo, que pode ser na mquina cliente (operao normal do E3 Viewer) ou na mquina
servidora, com o operador fisicamente junto mquina ou atravs dos Terminal Services. Com o E3 Viewer sendo
executado diretamente na estao cliente, existe um trfego inicial maior para o download de Telas e objetos. Este
trfego diminui substancialmente medida que somente as mudanas nos dados so reportadas do servidor para o
Viewer, o que traz vantagens em termos de desempenho e qualidade de apresentao grfica.
O Terminal Service, por outro lado, possui maior alcance e exige menor capacidade de processamento da mquina
cliente quando existem poucos efeitos grficos e visuais, alm da possibilidade de operar o E3 em outras plataformas
de software que no so suportadas pelo E3 Viewer, como o Windows CE e o Linux ou Unix. Entretanto, o RDP possui
a limitao de exibir somente 256 cores, o que aumenta consideravelmente o trfego quando existem muitas
animaes ou efeitos piscantes nas Telas. Para verificar qual a melhor maneira de implementar mltiplos acessos a um
E3 Server, importante estudar caso a caso, para poder definir a melhor alternativa para a aplicao. Para utilizar o
RDP com mltiplos usurios, necessrio uma licena de Windows 2003 Server SP2, alm do mesmo nmero de
Viewers disponveis no Servidor.
Introduo 3
Diagrama dos blocos que compem o E3
Introduo 5
CAPTULO
E3 Studio
2
O E3 Studio o ambiente de desenvolvimento do E3. Nele, possvel a criao e manuteno de Domnios, projetos
e bibliotecas.
cone do E3 Studio
6 E3 Studio
2. O dispositivo de proteo deve estar conectado na porta de comunicao adequada, no caso de uma edio
local, ou a mquina deve estar na mesma rede local que outra com o E3 Server j previamente instalado, e com
um dispositivo de proteo presente.
E3 Studio 7
rea de trabalho do E3 Studio
A Barra de Ttulo mostra o caminho e o nome da aplicao, ou o nome do objeto cujo Editor esteja sendo mostrado
na rea de trabalho.
A Barra de Status mostra informaes de ajuda a respeito da rea da tela, sobre a qual est o ponteiro do mouse.
A Barra de Ferramentas mostra os objetos, componentes e demais recursos que podem ser utilizados na Tela e no
E3.
A rea de Trabalho onde os Editores so mostrados.
2.3 Configurao
O E3 permite personalizar alguns recursos do E3 Studio, tais como barra de ferramentas, teclado, menus, mouse, etc.
2.3.1 Aparncia
Para personalizar a aparncia do E3 Studio, clique no menu Visualizar - Personalizar. As opes disponveis deste
item so as seguintes:
Aba Comandos: Atravs desta aba pode-se definir os cones de cada uma das barras de ferramentas. Para isto,
clique no cone na lista Comandos e arraste-o para dentro da barra de ferramentas desejada
8 E3 Studio
Aba Comandos
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Comandos
OPO DESCRIO
Categorias Mostra as opes dos menus e barras de ferramentas
disponveis no E3 Studio
Aba Barras de ferramentas: Atravs desta aba pode-se configurar, editar ou criar novas barras de ferramentas
E3 Studio 9
Opes disponveis na aba Barra de ferramentas
OPO DESCRIO
Barras de ferramentas Lista as opes de barras de ferramentas disponveis
Aba Menus
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Menus
OPO DESCRIO
Mostra menus para Exibe o menu pr-definido da aplicao. Esta opo no
tem efeito e mantida no E3 por questo de
compatibilidade
Aba Aparncia: Atravs desta aba possvel alterar a aparncia das janelas e barras de ferramentas no E3 Studio
10 E3 Studio
Aba Aparncia
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Aparncia
OPO DESCRIO
Office XP Configura a aparncia do E3 Studio como no Office XP
Aba Opes: Atravs desta aba possvel configurar as especificaes gerais do projeto. Neste item possvel
habilitar ou desabilitar as opes da barra de ferramentas
Aba Opes
As opes disponveis nesta aba esto descritas na tabela a seguir.
E3 Studio 11
Opes disponveis na aba Opes
OPO DESCRIO
Mostrar descries Habilita o E3 a mostrar uma breve descrio nas opes
das barras de ferramentas e menus quando o ponteiro
do mouse posicionado sobre um item
Incluir teclas de atalho Mostra ou no a tecla de atalho na descrio do boto
Aba Geral
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Geral
OPO DESCRIO
Ativar o Editor de Scripts Ativa a aba Scripts do Editor do objeto na ocorrncia de
um duplo-clique do mouse
Mostrar boto de fechar na aba ativa Permite fechar a aba ativa ao clicar no seu respectivo
boto de fechar. Desmarcar esta opo posiciona o
boto de fechar direita do Editor
12 E3 Studio
Aba Editor de Scripts
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Editor
OPO DESCRIO
Abrir-e-Fechar blocos do texto Permite ocultar ou mostrar os blocos de cdigo no script
NOTA
Feche os editores de scripts abertos para que as modificaes sejam aplicadas.
E3 Studio 13
Aba Arquivos
Toda vez que um projeto ou uma biblioteca criado, o E3 grava internamente um cdigo CRC (Cyclic Redundancy
Check, Verificao de Redundncia Cclica) dos dados deste arquivo. Cada vez que um arquivo aberto, feita uma
verificao deste CRC. Caso esta verificao falhe, ou seja, o CRC no coincida com os dados, a carga do arquivo
abortada, indicando uma corrupo dos dados do arquivo. Isto pode ser causado por falhas diversas de hardware:
memria, rede, dispositivo de armazenamento, etc.
Porm, se um projeto criado na verso atual modificado em uma verso inferior verso 1.00.019 build 203, o CRC
no atualizado. Com isto, o arquivo no pode ser aberto novamente com as verses atuais, pois a verificao de
CRC falha, mesmo que o arquivo no esteja efetivamente corrompido. Para solucionar esta questo, necessrio
habilitar a opo Ignorar verificao de CRC. Assim, o projeto pode ser aberto em uma verso atual.
Neste caso, a opo deve permanecer habilitada at que todos os objetos editados na verso antiga tenham sido
salvos com a verso atual, o que atualiza o CRC.
NOTA
No recomendvel que arquivos .prj sejam editados em verses mais antigas do E3 e depois abertos novamente
em verses atuais, pois no h garantia de que com este procedimento no sejam perdidas as configuraes destes
arquivos.
14 E3 Studio
CONE COMANDO AO
Recortar Remove a informao selecionada e
a move para a rea de Transferncia
Copiar Copia a informao selecionada e a
move para a rea de Transferncia
Colar Cola a informao selecionada da
rea de Transferncia
Desfazer Desfaz a ltima ao executada
E3 Studio 15
CONE COMANDO AO
Sombra Abaixo Desloca a sombra para baixo do
objeto
Sombra Esquerda Desloca a sombra para a esquerda
do objeto
Sombra Direita Desloca a sombra para a direita do
objeto
Cor da Sombra Seleciona a cor da sombra do
objeto
16 E3 Studio
CONE COMANDO AO
Conector Insere um objeto do tipo Conector
E3 Studio 17
CONE COMANDO AO
Espessura da Borda Define a espessura da borda do
objeto
Estilo de Preenchimento Define o estilo de preenchimento do
objeto
NOTAS
O menu contextual Contagem de Objetos no est disponvel no Organizer em modo Domnio para os itens
Configurao, Servidores, Arquivos e Domnios Remotos.
Os arquivos individuais do item Arquivos no Organizer em modo Domnio permitem utilizar o menu contextual
Contagem de Objetos.
No caso de arquivos protegidos por senha, necessrio que estes arquivos estejam abertos para que sejam
includos na contagem.
E3 Studio 19
Esta ferramenta gera um arquivo texto que pode ser editado em qualquer programa de edio de textos. A
formatao do arquivo de documentao feita atravs de um assistente chamado Assistente de Documentao de
Scripts. Este assistente responsvel por guiar o usurio na configurao do arquivo de documentao de scripts.
20 E3 Studio
Detalhamento do arquivo
Por exemplo, o script a seguir:
Sub TelaInicial_KeyDown(KeyCode, Shift)
If (KeyCode = 27) Then
Application.Exit
End Sub
Se a opo selecionada Apenas os nomes dos scripts, o texto a seguir gravado no arquivo:
TelaInicial_KeyDown(KeyCode, Shift)
Se for selecionada a opo Todo o script, ento todo o cdigo gravado com a mesma formatao (identao,
linhas em branco, etc.) realizada pelo usurio no editor de scripts.
Independente do tipo de formatao escolhida, antes do script gravado um identificador contendo o nome
completo do objeto, para evitar conflitos. Por exemplo, para os seguintes objetos:
TelaInicial
CommandButton1
Tela1
CommandButton1
Ambos os scripts (considerando um mesmo evento, Click) seriam CommandButton1_Click(). Assim, a gravao no
arquivo ficaria desta forma:
<TelaInicial.CommandButton1:CommandButton1_Click()>
Sub CommandButton1_Click()
...
End Sub
E:
<Tela1.CommandButton1:CommandButton1_Click()>
Sub CommandButton1_Click()
...
End Sub
Isto permite a identificao correta de cada script. Clique em Avanar para ir prxima janela.
Na janela Separador de scripts possvel definir o texto que gravado entre um script e outro no arquivo de
documentao. possvel escolher entre linhas em branco ou personalizadas, e ainda informar quantas linhas do tipo
escolhido so inseridas no arquivo.
E3 Studio 21
Separador de scripts
Pode-se optar entre uma Linha em branco ou uma Linha personalizada. Selecionando a opo Linha em branco, o
arquivo de documentao tem uma linha em branco entre um script e outro. Selecionando a opo Linha
personalizada, pode-se informar um ou mais caracteres para compor a linha que usada como separador. Os
caracteres so informados no campo Entre com o texto da linha. Se a opo selecionada Repetir at o final da
linha, os caracteres informados so repetidos at o limite de tamanho da linha, que de 80 caracteres. Pode-se
tambm utilizar mais de uma linha como separador, seja ela em branco ou personalizada. Basta informar um nmero
entre 1 (um) e 100, no campo Entre com o nmero de linhas do separador. Clique em Avanar para finalizar a
configurao. Logo aps, o assistente mostra uma mensagem indicando a finalizao da configurao e a gerao do
arquivo que contm a documentao dos scripts.
22 E3 Studio
Os scripts de XControls, XFolders e XObjects so gravados apenas uma vez no arquivo, pois so encontrados
durante a pesquisa na biblioteca. Scripts de instncias so gravados quando o objeto pai da instncia
pesquisado
Picks so internamente scripts. Logo, tambm so documentados
A gravao no arquivo feita em ordem alfabtica do nome do objeto, dentro de cada projeto ou biblioteca
No possvel adicionar scripts a um arquivo j existente, via Assistente. Sempre que o Assistente iniciado, um
novo arquivo criado ou, caso j exista, sobrescrito
Esta ferramenta pode demorar algum tempo para gerar o arquivo de documentao, caso a aplicao seja
grande e a pesquisa envolva muitos tipos de objetos. Para agilizar a pesquisa, interessante gerar um arquivo
para cada tipo de objeto do E3
Janela Procurar/Substituir
Existem trs maneiras de se realizar a procura e a substituio:
Clicar com o boto direito do mouse em um item no Organizer e selecionar a opo Procurar/Substituir. Esta
procura realizada a partir do item, seguindo a hierarquia (apenas objetos filhos so pesquisados)
Clicar no menu principal do E3 Studio, em Ferramentas - Procurar/Substituir. Esta procura realizada em todos
os projetos e bibliotecas abertos
Clicar em Procurar/Substituir , na barra de ferramentas Padro. A procura efetuada em todo o Domnio
E3 Studio 23
OPO DESCRIO
Uma a uma Executa a substituio da linha selecionada e seleciona a
prxima linha vlida
Todas Substitui, de uma s vez, todas as ocorrncias do texto
NOTA
Para selecionar o objeto e mostrar o local exato onde o texto se encontra, clique duas vezes na lista de resultados,
na linha desejada.
A tabela a seguir contm as principais opes de pesquisa, bem como as limitaes para os principais tipos de
dados.
Principais opes de pesquisa
TIPO DE DADOS EXEMPLO OBSERVAO
Data / Hora 10/02/2010 Encontra em propriedades do tipo
00:00:10 Data/Hora. Se for especificada
somente a data, encontra todas as
ocorrncias desta data, independente
da hora. Se for especificada somente
a hora, encontra todas as ocorrncias
desta hora, independente da data. Os
milissegundos so ignorados na
pesquisa
Inteiro 0 Encontra em todas as propriedades
100 numricas. Pesquisando por 10
encontra 10 e 10.0, mas no encontra
10.1 ou 100
Ponto flutuante 10.0 Encontra em todas as propriedades
40,5 numricas de tipo Ponto Flutuante.
Pesquisando por 10.1 no encontra
10 (inteiro). As configuraes
regionais do Windows so
consideradas para validar o smbolo
decimal no nmero
Cor 255,255,0 Encontra apenas em propriedades do
0,0,234 tipo Cor. Deve necessariamente usar
vrgulas para separar os valores, que
devem estar no sistema RGB
Booleano Verdadeiro Leva em considerao o idioma do
True Windows para entender a pesquisa
como sendo de um valor Booleano
String Teste Encontra Strings inteiras ou partes
Tag de Strings (de acordo com o tipo de
pesquisa, por palavra inteira ou no).
Qualquer tipo de dado pode ser
encontrado em propriedades do
tipo String
24 E3 Studio
2.4.4 Relatrio de Verses
A ferramenta Relatrio de verses permite a visualizao das verses e comentrios dos projetos e das bibliotecas
abertos, pertencentes ou no ao Domnio. Para acessar esta ferramenta, clique em na barra de ferramentas Padro
para mostrar a caixa de dilogo da figura a seguir.
Relatrio de verses
As opes desta caixa de dilogo so mostradas na tabela a seguir.
Opes disponveis na caixa de dilogo Relatrio de verses
OPO DESCRIO
Projeto/Biblioteca Nome do projeto ou da biblioteca abertos
NOTA
Estes campos so apenas para visualizao, no sendo permitida sua edio.
E3 Studio 25
Verificao de Erros no Projeto
Enquanto o erro no for solucionado, a caixa de dilogo continua sendo mostrada e no possvel executar o Viewer.
Aps a resoluo do problema, o E3 Studio mostra uma caixa de mensagem indicando que no encontrou nenhum
erro no Domnio, e libera a execuo do Viewer.
2.4.6 WatchWindow
A ferramenta WatchWindow permite a visualizao do valor corrente de qualquer propriedade ou Tag em tempo de
execuo no E3 Studio. Para utilizar esta ferramenta, clique em WatchWindow na barra de ferramentas Padro ou
utilize o menu Ferramentas - WatchWindow para mostrar a caixa de dilogo da figura a seguir.
26 E3 Studio
Caixa de dilogo WatchWindow
As opes desta caixa de dilogo so mostradas na tabela a seguir.
Opes disponveis na caixa de dilogo WatchWindow
OPO DESCRIO
Adicionar Abre o DomainBrowser (uma janela do AppBrowser com
os objetos criados no servidor) e seleciona o objeto que
mostrado na janela WatchWindow
Caso a coluna Valor mostre a indicao Array, isto significa que o Tag ou a propriedade do tipo Variant e contm
um Array. Para visualizar os valores deste Array, clique na clula desejada e selecione a opo Visualizar Array. A
janela da figura a seguir mostrada.
E3 Studio 27
Janela Edio de Arrays
Nesta janela, se algum dos valores tambm mostrar a indicao Array, seus valores podem ser visualizados repetindo
o procedimento anterior.
2.5 Organizer
O Organizer permite uma viso simples e organizada de toda a aplicao, ajudando na edio e configurao de
todos os objetos envolvidos, atravs de uma rvore hierrquica de opes. Possui dois modos de visualizao,
Domnio e Explorer.
Organizer
O modo Domnio mostra apenas as informaes dos objetos abertos pertencentes ao Domnio. Estas informaes
esto organizadas em quatro grupos: Configurao, Bibliotecas de Objetos, Visualizao e Objetos de Servidor.
Cada grupo apresenta seus objetos ordenados alfabeticamente dentro do respectivo n.
28 E3 Studio
Modo Domnio
O grupo Configurao mostra os servidores configurados, bem como os nomes dos arquivos de projetos e de
bibliotecas pertencentes ao Domnio.
O grupo Bibliotecas de Objetos agrupa os objetos ElipseX de todas as bibliotecas pertencentes ao Domnio,
organizados por tipo de objetos (XControls, XFolders e XObjects).
Os demais objetos do E3 esto nos grupos Visualizao e Objetos de Servidor. Em Visualizao esto os objetos
que executam na mquina cliente. J os objetos executados na mquina servidor esto em Objetos de Servidor.
O modo Explorer mostra projetos e bibliotecas abertos no E3 Studio, pertencentes ou no ao Domnio. Os objetos
so mostrados no projeto ou na biblioteca ao qual pertencem, ordenados alfabeticamente dentro de cada um.
Modo Explorer
A manuteno da aplicao pode ser feita em qualquer um dos dois modos. As operaes realizadas em um modo
so imediatamente refletidas no outro. Para facilitar a localizao dos objetos, ambos os modos so intercambiveis,
tanto entre si como com a aba Design do Editor do objeto. Para alternar o modo de visualizao, siga estes
procedimentos:
1. No modo Domnio, clique com o boto direito do mouse no objeto e selecione Mostrar no Explorer para
visualiz-lo no modo Explorer.
2. No modo Explorer, clique com o boto direito do mouse no objeto e selecione Mostrar no Organizer para
visualiz-lo no modo Domnio.
3. Em qualquer um dos modos, clique com o boto direito do mouse no objeto e selecione Mostrar no Editor para
visualiz-lo diretamente na aba Design.
E3 Studio 29
4. Em qualquer Editor de objetos, na aba Design, clique com o boto direito do mouse no objeto e selecione
Mostrar no Organizer ou Mostrar no Explorer para visualiz-lo no Organizer, em seu respectivo modo.
Ao clicar em um objeto com o boto esquerdo do mouse, suas propriedades podem ser visualizadas e editadas
atravs da Lista de Propriedades, se habilitada. Clicando com o boto direito do mouse em cada item do Organizer,
so mostradas as opes da tabela a seguir.
Opes disponveis no Organizer
OPO DESCRIO
Fechar Fecha o projeto ou biblioteca corrente
30 E3 Studio
OPO DESCRIO
Importar/Exportar Auxilia o usurio na importao e na exportao de
objetos, Associaes e colees. Maiores informaes
sobre esta opo no tpico Importao e Exportao
deste captulo
Documentar Scripts Auxilia o usurio com a documentao dos scripts da
aplicao. Maiores informaes sobre esta opo no
tpico Documentao de Scripts deste captulo
Verificar Verifica os erros ocorridos na aplicao. Maiores
informaes sobre esta opo no tpico Verificar
Domnio deste captulo
Editar Associaes Muda uma ou mais Associaes, eventos de usurio e
propriedades do tipo Link feitas na aplicao, de forma
mais rpida do que pela janela tradicional. Maiores
informaes sobre esta opo no captulo Associaes
Copiar/Colar Associaes Copia ou cola Associaes de um objeto para outro. A
segunda opo s mostrada se o que estiver copiado
na rea de Transferncia do Windows for uma
Associao. Se a propriedade em questo j possuir uma
Associao, mostrada uma mensagem ao usurio
perguntando se a Associao deve ser sobrescrita ou no.
Se as Associaes copiadas na rea de Transferncia
forem coladas em um objeto que no possua alguma das
propriedades, estas so listadas para o usurio em uma
mensagem informando o problema. As propriedades que
existirem tm as Associaes criadas corretamente.
Associaes de propriedades escondidas dos ElipseX no
so copiadas
Propriedades Abre a janela de propriedades do objeto. Quando esta
opo aberta pelo menu, a primeira aba a ser aberta
a de configuraes do objeto. Mais informaes sobre
esta opo nos respectivos captulos de cada objeto.
NOTA: A janela de propriedades tambm pode ser aberta
utilizando as combinaes de teclas ALT + ENTER, CTRL +
ALT + ENTER ou ALT + duplo-clique do mouse
Novo Arquivo de Aplicao (.prj) Cria um novo arquivo .prj e o inclui no Domnio
Nova Biblioteca de Objetos (.lib) Cria um novo arquivo .lib e o inclui no Domnio
E3 Studio 31
NOTA
As opes da tabela anterior tambm esto disponveis utilizando a combinao de teclas SHIFT + F10, que
corresponde tecla de aplicao ou de menu .
Qualquer objeto do E3 pode ser importado ou exportado. O objeto selecionado para a operao chamado de
objeto raiz. Com isto, possvel importar ou exportar, por exemplo, uma Pasta de Dados com XObjects definidos
pelo usurio, ou mesmo exportar uma Tela, listando todos os objetos filhos.
Alm dos objetos, as Associaes e as colees tambm podem ser importadas e exportadas. O usurio tem a opo
de informar se quer importar ou exportar Associaes e colees ou no.
NOTA
A ferramenta de importao e exportao considera apenas as propriedades e Associaes dos objetos e colees
do E3. Informaes que no estejam descritas em propriedades no so importadas ou exportadas. Este o caso,
por exemplo, de scripts e configuraes internas dos objetos de Tela.
32 E3 Studio
2.6.1 Arquivo CSV
Um arquivo CSV (Comma Separated Values) um arquivo texto baseado em colunas separadas por vrgula, ou por
outro separador previamente definido. No E3, eles contm as informaes sobre os objetos que foram exportados, e
so utilizados na importao para que estes objetos sejam criados corretamente no E3 Studio. Cada coluna do
arquivo CSV representa uma ou mais propriedades de objetos do E3. Cada linha do arquivo representa um objeto,
Associao ou item de coleo. Para que estes arquivos sejam utilizados corretamente, preciso observar alguns
detalhes:
A primeira linha do arquivo CSV deve conter um cabealho que identifica as colunas corretamente
O cabealho deve ter obrigatoriamente uma coluna que identifica o tipo do objeto que est sendo importado ou
exportado. Esta coluna chama-se ObjectType. O valor desta coluna o nome da classe do objeto (XObject1,
DrawRect, InternalTag, AgSimple, etc.), com exceo das colees, que apresentam palavras-chave pr-definidas
(ITableBindRow, IAxis, etc.)
O cabealho das demais colunas deve ser o prprio nome da propriedade em questo
As colunas podem ser colocadas em qualquer ordem no arquivo; pode haver colunas a mais ou a menos, sem
prejuzo da operao de importao ou exportao. A nica coluna obrigatria ObjectType, porque sem ela
no possvel identificar o tipo de objeto que deve ser criado
E3 Studio 33
Arquivo CSV visualizado no Excel
2. Salve a planilha com a extenso .csv.
3. Feche o arquivo no Excel.
4. Para importar este arquivo no E3, selecione um objeto IODriver e importe o arquivo criado atravs da opo
Importar, selecionando o modelo adequado. O E3 cria a estrutura de acordo com o arquivo CSV.
2.6.2 Objetos
A importao ou a exportao de objetos no E3 pode ser feita a partir de qualquer tipo de objeto, exceto projetos e
bibliotecas. A operao a partir do objeto raiz feita sobre suas propriedades e seus objetos filhos. Para exportar
objetos, siga estes procedimentos:
1. Clique com o boto direito do mouse no objeto desejado e selecione a opo Exportar.
2. Na caixa de dilogo, selecione o arquivo CSV desejado e clique em Salvar.
34 E3 Studio
Exportao de Objetos
Na exportao, todas as propriedades, Associaes, colees e itens de colees do objeto selecionado e de seus
filhos so automaticamente exportadas. gerado um arquivo CSV com uma linha para cada objeto exportado, bem
como para cada Associao, coleo ou item de coleo existente nestes objetos. Para cada propriedade criada
uma coluna no arquivo, onde informado o valor da propriedade para cada objeto.
O objeto selecionado, chamado de objeto raiz, exportado com a coluna da propriedade Name em branco. Nos
demais casos, esta coluna contm a hierarquia com nomes separados por pontos. Exemplo de exportao a partir de
um objeto IODriver:
Hierarquia do objeto
Driver1
ObjectType;Name;Prop1;Prop2;Prop3
IODriver;;0;True;0
IOBlock;Bloco1;0;False;0
IOBlockElement;Bloco1.Elemento1;0;False;0
IOBlockElement;Bloco1.Elemento2;0;False;0
IOBlock;Bloco2;0;False;0
IOBlockElement;Bloco2.Elemento1;0;False;0
IOTag;Tag1,0,True,0
Se desejar, o usurio pode configurar a exportao de objetos atravs do uso de modelos, que so apresentados no
tpico Modelos. Utilizando um modelo possvel configurar se as Associaes, colees e itens de colees so ou
no exportados, se o objeto raiz exportado ou no e quais as propriedades de cada objeto devem ser exportadas,
entre outras configuraes. Para isto, siga estes procedimentos:
1. Clique com o boto direito do mouse no objeto desejado e selecione a opo Exportar.
2. Clique em Avanado para configurar ou selecionar um modelo.
3. Na caixa de dilogo, selecione o arquivo CSV desejado e clique em Salvar.
E3 Studio 35
Para importar objetos, siga estes procedimentos:
1. Clique com o boto direito do mouse no objeto desejado e selecione a opo Importar.
2. Na caixa de dilogo, selecione o arquivo CSV desejado e clique em Abrir.
Importao de Objetos
Na importao, para cada linha lida do arquivo CSV identificado o objeto a ser criado. Apenas o filho mais ao final
da hierarquia pode ser criado. O restante do caminho deve existir. Por exemplo, no objeto Pasta1.Pasta2.Tag,
apenas Tag deve ser criado. Pasta1 e Pasta2 devem existir previamente. Assim, permitido ter no arquivo apenas
pastas, sem filhos. O arquivo pode ter linhas como a seguir:
ObjectType;Name
IOFolder;Pasta1
As linhas em branco, as linhas onde no encontrado um identificador de tipo vlido, as colunas em branco e as
colunas que tenham nomes invlidos de propriedades so ignoradas, sem gerar erro.
2.6.3 Modelos
Os Modelos so arquivos INI utilizados para configurar a ferramenta de importao e exportao, informando, por
exemplo, qual separador deve ser utilizado no arquivo CSV, se as Associaes dos objetos devem ou no ser
exportadas, etc. Os arquivos INI tm o seguinte formato:
Linhas iniciadas por ponto e vrgula so comentrios, desconsiderados na interpretao do arquivo
O arquivo organizado em sees, e cada seo contm uma ou mais variveis. As sees so identificadas por
nomes entre colchetes. As variveis so as palavras antes do smbolo de igualdade. Uma seo no pode conter
duas variveis com o mesmo nome
Linhas em branco so ignoradas
36 E3 Studio
Var1 = TRUE
Var3 = FALSE
O formato um texto facilmente modificvel pelo usurio, sendo possvel gerar um modelo novo utilizando um editor
de textos comum. O mesmo modelo pode ser utilizado tanto para a importao como para a exportao de objetos.
Os modelos utilizados no E3 permitem que o usurio redefina valores para nomes das colunas do arquivo CSV, bem
como para os tipos de objetos. Alm disto, tambm permitem que o usurio agrupe mais de uma propriedade em
uma mesma coluna. Isto tudo feito atravs da definio de identificadores, que so palavras-chave utilizadas no
arquivo CSV e associadas propriedades ou classes de objetos no arquivo INI.
No E3, os modelos da ferramenta de importao e exportao esto definidos com as sees e variveis descritas na
tabela a seguir.
Sees definidas para os Modelos
SEO DESCRIO
Header (*) Define os identificadores permitidos para nomes de
colunas e tipos de dados. Nesta seo devem ser
definidas as variveis header e types.
(*) Seo obrigatria para a exportao
E3 Studio 37
SEO DESCRIO
separator Define o separador que utilizado para delimitar as
colunas no arquivo CSV. Caso esta varivel no seja
definida, utilizado o separador de listas configurado no
Windows
root Define se o objeto raiz exportado ou importado junto
com os objetos filhos. Caso esta varivel no seja definida,
o objeto raiz utilizado
link Define se as Associaes dos objetos so exportadas ou
importadas. Caso esta varivel no seja definida, as
Associaes so utilizadas
collection Define se as colees dos objetos so exportadas ou
importadas. Caso esta varivel no seja definida, as
colees so utilizadas
objectduplicated Define o que fazer quando um objeto pr-existente estiver
sendo importado. Os valores possveis para esta varivel
so:
0 - askalways: Sempre questiona o usurio sobre o que
deve ser feito
1 - changealways: Sempre altera as propriedades do
objeto existente
2 - ignorealways: Sempre ignora o objeto sendo
importado
3 - createalways: Sempre cria um objeto novo, auto-
incrementando o nome
Caso esta varivel no seja definida, assumido o valor
askalways. Esta opo no tem valor na exportao
bindduplicated Define o que fazer quando uma Associao pr-existente
estiver sendo importada. Os valores possveis para esta
varivel so:
0 - askalways: Sempre questiona o usurio sobre o que
deve ser feito
1 - changealways: Sempre substitui a Associao
existente pela nova
2 - ignorealways: Sempre ignora a Associao sendo
importada
Caso esta varivel no seja definida, assumido o valor
askalways. Esta opo no tem valor na exportao, nem
tampouco possui o valor createalways. Neste caso,
sempre modificado para askalways
collectionduplicated Define o que fazer quando uma coleo pr-existente
estiver sendo importada. Os valores possveis para esta
varivel so:
0 - askalways: Sempre questiona o usurio sobre o que
deve ser feito
1 - changealways: Sempre substitui a coleo existente
pela nova
2 - ignorealways: Sempre ignora a coleo sendo
importada
Caso esta varivel no seja definida, assumido o valor
askalways. Esta opo no tem valor na exportao, nem
tampouco possui o valor createalways. Neste caso,
sempre modificado para askalways
38 E3 Studio
SEO DESCRIO
itemduplicated Define o que fazer quando um item de coleo pr-
existente estiver sendo importado. Os valores possveis
para esta varivel so:
0 - askalways: Sempre questiona o usurio sobre o que
deve ser feito
1 - changealways: Sempre altera as propriedades do
item existente
2 - ignorealways: Sempre ignora o item sendo
importado
3 - createalways: Sempre cria um item novo, auto-
incrementando o nome
Caso esta varivel no seja definida, assumido o valor
askalways. Esta opo no tem valor na exportao
include Define quais classes de objetos devem ser importadas ou
exportadas. O filtro no recursivo, ou seja, se for
includa uma classe de um objeto que possa ter filhos,
estes filhos no so includos automaticamente. No pode
ser usada junto com a varivel exclude. Apenas o que
estiver definido nesta varivel exportado ou importado
exclude Define quais classes de objetos no devem ser
importadas ou exportadas. O filtro no recursivo, ou
seja, se for excluda uma classe de um objeto que possa
ter filhos, estes filhos no so excludos automaticamente.
No pode ser usada junto com a varivel include. Apenas
o que estiver definido nesta varivel desconsiderado na
importao ou na exportao
NOTA
O caractere de ponto e vrgula no pode ser utilizado como nome ou parte do nome da coluna, nem tampouco
como nome ou parte do nome do identificador de tipo. Esta limitao se deve ao fato de este caractere definir um
comentrio no arquivo INI. Desta forma, a varivel criada na seo Columns ou na seo Types para definir o
identificador que possui o ponto e vrgula no pode ser lida corretamente.
Exemplo:
[Header]
header = ObjectType,Name,DocString,N1/B1,N2/B2,N3/B3,N4/B4,Scan,AllowRead,AllowWrite
types = Tag,Bloco,Elemento
[Configuration]
separator = ','
root = true
link = true
collection = true
objectduplicated = askalways
bindduplicated = askalways
collectionduplicated = askalways
itemduplicated = askalways
[Types]
Tag = IOTag
Bloco = IOBlock
Elemento = IOBlockElement
[Columns]
N1/B1 = N1,B1
N2/B2 = N2,B2
N3/B3 = N3,B3
N4/B4 = N4,B4
[Filter]
exclude = IOFolder
E3 Studio 39
A Elipse Software fornece alguns modelos para importao e exportao de alguns tipos de objetos. Estes modelos
tambm podem ser utilizados como base para a criao de outros. Os modelos fornecidos esto na pasta Templates
da instalao do E3.
NOTA
Na importao, as colunas utilizadas so lidas diretamente do arquivo CSV. Neste caso especfico, no necessria a
varivel header no modelo. Porm, se alguma coluna for nomeada por um identificador, este deve estar definido na
seo Columns ou a coluna ignorada.
Aba Configuraes
As opes disponveis nesta aba esto descritas na tabela a seguir.
40 E3 Studio
Opes disponveis na aba Configuraes
OPO DESCRIO
Separador de colunas As opes disponveis so: Usar o separador de listas
do Windows (escolhe o caractere definido no Windows
como separador de listas para ser usado como
separador de colunas do arquivo CSV) ou Usar outro
caractere como separador (escolhe outro caractere
definido pelo usurio como separador de colunas)
Importao: Atravs desta aba, o usurio pode configurar as opes vlidas somente para a importao.
Aba Importao
E3 Studio 41
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Importao
OPO DESCRIO
Importao de objetos duplicados Especifica como o E3 deve lidar com a ocorrncia de
objetos duplicados na importao. As opes disponveis
so Questionar sobre o que fazer em cada caso,
Sempre sobrescrever o objeto existente, Sempre
ignorar o objeto duplicado ou Sempre criar um novo
objeto
Importao de itens de coleo duplicados Especifica como o E3 deve lidar com a ocorrncia de
itens de coleo duplicados na importao. As opes
disponveis so Questionar sobre o que fazer em cada
caso, Sempre sobrescrever o item existente, Sempre
ignorar o item duplicado ou Sempre criar um novo
item
Filtros: Atravs desta aba, o usurio pode escolher quais classes so utilizadas na importao ou na exportao, ou
quais classes no deseja utilizar
42 E3 Studio
Aba Filtros
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Filtros
OPO DESCRIO
No filtrar objetos Define a importao ou a exportao de todos os
objetos
Clicando em Alterar, abre-se uma janela para a escolha de classes, mostrada na figura a seguir.
E3 Studio 43
Janela Classes de Objetos
As classes que preenchem inicialmente a lista so as do objeto raiz e seus filhos, caso um novo modelo esteja sendo
criado. O usurio pode adicionar outras, clicando em , ou remover alguma classe, clicando em .
Identificadores: Atravs desta aba, o usurio define os identificadores para as classes de objetos escolhidas. O
estado inicial desta lista vazio
Aba Identificadores
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Identificadores
OPO DESCRIO
Nome da classe Indica o nome da classe selecionada na opo
44 E3 Studio
OPO DESCRIO
Identificador Permite ao usurio alterar o valor a ser utilizado na
coluna ObjectType do arquivo CSV. O valor inicial nesta
coluna sempre o nome da classe do objeto. Para cada
valor alterado aqui, criada uma entrada no arquivo INI
na seo Types. Os valores no so sensveis caixa
(isto , "AAA", "aaa" e "aAa" so o mesmo valor). Caso o
usurio defina valores iguais para mais de um tipo,
apenas o primeiro tipo considerado na importao, e
algum objeto pode ser criado com o tipo errado
Adicionar Adiciona classes de objetos
Propriedades: Atravs desta aba, o usurio escolhe quais propriedades dos objetos deseja utilizar na importao
ou na exportao. O valor inicial da lista ObjectType e as demais propriedades devem ser adicionadas
manualmente pelo usurio
Aba Propriedades
As opes disponveis nesta aba esto descritas na tabela a seguir.
E3 Studio 45
Opes disponveis na aba Propriedades
OPO DESCRIO
Nome da coluna Permite ao usurio alterar o valor a ser utilizado como
nome da coluna no cabealho do arquivo CSV. O valor
inicial desta coluna sempre o prprio nome da
propriedade do objeto. Para cada valor alterado nesta
coluna, criada uma entrada no arquivo INI na seo
Columns. Os nomes das colunas no so sensveis
caixa (isto , "AAA", "aaa" e "aAa" so o mesmo valor).
Caso o usurio defina nomes de colunas iguais para
mais de uma propriedade, apenas uma delas
identificada corretamente, e todas as colunas com o
mesmo nome so relacionadas mesma propriedade.
Neste caso, algum valor pode ser sobrescrito
Ao clicar em , abre-se uma janela para a seleo de propriedades, mostrada na figura a seguir.
Janela Propriedades
As opes disponveis nesta janela esto descritas na tabela a seguir.
46 E3 Studio
Opes disponveis na janela Propriedades
OPO DESCRIO
Classes de objetos Apresenta as classes de objetos que se enquadram no
filtro escolhido a partir do objeto raiz
Listar todas as classes de objetos do E3 Se esta opo for selecionada, a caixa de seleo de
objetos mostra todas as classes existentes no E3,
independente de filtro ou objeto raiz
As propriedades em negrito nesta lista j foram inseridas na lista que define as colunas do arquivo CSV. Um duplo-
clique sobre uma propriedade faz com que ela seja adicionada ou removida, dependendo se ela j estava ou no na
lista. Se a propriedade havia sido agrupada com outras, o duplo-clique remove apenas esta propriedade do
agrupamento, mantendo as outras propriedades agrupadas corretamente.
As propriedades do tipo TextFont possuem propriedades internas que configuram separadamente tipo, tamanho e
outras caractersticas da fonte. Elas so exportadas com o nome da propriedade principal (de acordo com o objeto),
seguido do nome da propriedade interna, separados por um ponto (por exemplo, TextFont.Bold). No configurador
de modelos, as propriedades internas aparecem separadas para o usurio, para que a escolha possa ser feita
isoladamente.
E3 Studio 47
3. Se a importao foi realizada com sucesso, os alarmes devem aparecer sem nenhuma mensagem de erro. Caso
os Tags correspondentes j tenham sido importados, todas as referncias devem aparecer na cor azul.
Para executar a importao dos Tags OPC no E3 3.0, siga estes passos:
1. No Organizer, insira um novo Driver de Comunicao OPC.
2. Renomeie o Driver de Comunicao OPC para o mesmo nome do Driver OPC utilizado na aplicao Elipse SCADA,
para que posteriormente as referncias para os Tags deste Driver OPC sejam importadas corretamente.
3. Clique com o boto direito do mouse no Driver OPC e selecione a opo Importar.
4. Na lista de tipos de arquivos, selecione a opo Arquivos do Elipse SCADA (*.e2f), e a seguir selecione o arquivo
exportado anteriormente, sem o sufixo _Alarms. No necessrio selecionar um modelo.
48 E3 Studio
Exportao de Drivers
3. Selecione o local e o nome do arquivo a ser gerado. Alm do arquivo com as configuraes dos Tags, gerado
um arquivo com o mesmo nome, seguido do sufixo _Alarms. Este arquivo utilizado posteriormente na
importao da configurao de alarmes no E3.
E3 Studio 49
Importao de Tags
50 E3 Studio
Exportao de Tags RAM e Demo
3. Selecione o local e o nome do arquivo a ser gerado. Alm do arquivo com as configuraes dos Tags, gerado
um arquivo com o mesmo nome seguido do sufixo _Alarms. Este arquivo utilizado posteriormente na
importao da configurao de alarmes no E3.
2.6.5.5 Telas
A exportao de Telas do Elipse SCADA parcial e suporta apenas um subconjunto dos objetos de Tela. Para
exportar uma Tela, siga estes passos:
1. No Organizer do Elipse SCADA, selecione o item Telas e clique na Tela desejada.
2. Clique em Exportar.
E3 Studio 51
Exportao de Telas
3. Selecione o local e o nome do arquivo a ser gerado.
4. No Organizer, insira uma nova Tela.
5. Clique com o boto direito do mouse na Tela e selecione a opo Importar.
6. Na lista de tipos de arquivos, selecione a opo Arquivos do Elipse SCADA (*.e2f), e a seguir selecione o arquivo
exportado anteriormente. No necessrio selecionar um modelo.
Se a importao foi realizada com sucesso, a Tela preenchida com os objetos, e nenhuma mensagem de erro
mostrada. Os arquivos de imagens utilizados pela Tela devem ser tratados conforme um dos casos a seguir:
Arquivos de imagens com caminhos relativos na aplicao Elipse SCADA: Estes arquivos devem ser inseridos
manualmente como Recursos no projeto do E3. possvel inserir vrios arquivos de uma vez, clicando com o
boto direito do mouse no item Recursos do Organizer e selecionando a opo Inserir recurso em
Arquivos de imagens com caminhos absolutos: Estes arquivos devem permanecer nos seus diretrios originais.
O E3 os procura no mesmo diretrio onde so encontrados pela aplicao do Elipse SCADA
NOTA
recomendado inserir todos os arquivos no projeto como Recursos, para que o Viewer possa executar o download
automaticamente pela rede. Isto evita a necessidade de instalar os arquivos manualmente nas mquinas cliente.
2.6.6 Associaes
Para a importao ou a exportao de Associaes no E3, deve ser selecionada a opo correspondente no modelo.
No h como excluir apenas um ou outro tipo de Associao. Ou todas so importadas ou exportadas ou nenhuma.
Cada Associao ocupa uma linha no arquivo CSV. A identificao das Associaes feita atravs das seguintes
palavras-chave:
AgSimple: Associaes Simples, Bidirecionais ou Reversas (estas devem ser diferenciadas pelas propriedades
Reverse e Bidirectional)
AnalogBind: Associaes Analgicas
52 E3 Studio
AnimationBind: Associaes Digitais
TableBind: Associaes por Tabela
A criao de linhas da tabela respeita o ndice informado pelo usurio. Se o ndice no for um nmero, mostrada
uma mensagem de erro (nome invlido). Se for um ndice inexistente (por exemplo, s existem duas linhas na tabela e
o usurio quer inserir a linha cinco), as linhas que faltam so criadas e ficam com os valores padro.
Todas as Associaes so importadas ou exportadas, independente da seleo de propriedades que o usurio tenha
feito. Se uma Associao para determinada propriedade j existir, o usurio questionado sobre o que fazer. Caso
contrrio, elas so criadas.
No nome do objeto deve ser informado o caminho completo, no formato Objeto.Collection.Name. Exemplo:
E3Chart1.Pens.Pena1
E3 Studio 53
Na coluna de tipo deve aparecer uma das seguintes palavras-chave:
IDispChartPen: Penas do E3Chart
ILegendColumn: Legendas do E3Chart
IAxis: Eixos do E3Chart
ITableBindRow: Linhas das Associaes por Tabela
54 E3 Studio
Lista de Propriedades ordenada
alfabeticamente
A Lista de Propriedades da figura a seguir mostra o objeto anterior com suas propriedades ordenadas por categoria.
NOTA
No caso de seleo mltipla de objetos, a Lista de Propriedades mostra apenas as propriedades comuns aos
objetos selecionados, com seus valores correspondendo ao ltimo objeto selecionado. O mesmo critrio utilizado
se a Lista de Propriedades est ordenada por categoria, ou seja, as categorias mostradas correspondem s do
ltimo objeto selecionado.
E3 Studio 55
O rodap da Lista de Propriedades mostra uma descrio rpida da propriedade selecionada. As opes disponveis
nesta janela esto descritas na tabela a seguir.
Opes disponveis na Lista de Propriedades
CONE OPO DESCRIO
Ordenar por categoria Mostra as propriedades do objeto
selecionado organizadas por
categorias
Pode-se configurar o valor de uma propriedade digitando diretamente na sua respectiva coluna Valor. direita do
nome da propriedade existe um cone que indica o seu estado atual: O cone indica que o valor da propriedade o
padro, ou seja, seu valor no foi modificado pelo usurio, e o cone indica que o valor da propriedade foi
modificado pelo usurio (o valor modificado aparece em negrito). Alm disto, clicar neste cone abre um menu
contextual com as opes descritas na tabela a seguir.
Opes disponveis no menu contextual de uma propriedade
OPO DESCRIO
Resetar Reverte o valor da propriedade selecionada para seu
valor padro, caso tenha sido modificado pelo usurio
NOTA
As opes do menu contextual de uma propriedade podem estar habilitadas ou desabilitadas, dependendo do tipo
de dados da propriedade.
2.8 Galeria
Coleo de objetos grficos que podem ser arrastados e inseridos nas Telas das aplicaes. Estes objetos so
arquivos do tipo Metafiles (WMF, Windows MetaFile).
56 E3 Studio
Galeria
2.9 AppBrowser
O AppBrowser uma ferramenta que auxilia o usurio a montar a aplicao informando uma expresso lgica, uma
Associao ou um valor para a propriedade sendo manipulada, de acordo com o objeto selecionado. Assim,
possvel minimizar erros durante a criao da aplicao.
AppBrowser
No quadro esquerda so mostrados os objetos do E3 que podem ser utilizados para compor o texto que o
resultado do uso do AppBrowser. De acordo com seu contexto de utilizao, alguns objetos no podem ser utilizados
e nem so mostrados aqui.
No quadro central so mostradas as propriedades e os mtodos do objeto selecionado, e no quadro direita o
texto de ajuda da propriedade ou do mtodo selecionado.
Mais abaixo mostrado o texto resultante do AppBrowser, ao lado das opes Colar e Cancelar. Clique em Colar
para aceitar o resultado e copiar o valor para o local desejado. Clique em Cancelar para ignor-lo.
E3 Studio 57
NOTAS
Ao selecionar Tags, o AppBrowser sempre aberto na ltima posio, e no na posio apontada pelo link atual.
O AppBrowser possui a funo Auto Complete: basta digitar o nome do objeto desejado para selecion-lo
automaticamente.
De acordo com o objeto selecionado, o quadro central mostra suas propriedades e seus mtodos.
58 E3 Studio
2.9.2 Acesso via Associao
Para acessar o AppBrowser a partir de uma Associao, basta abrir a Janela de Propriedades, selecionar a aba
Associaes, logo aps a propriedade desejada, e finalmente clicar em direita. O AppBrowser aberto e os
objetos so apresentados conforme a figura a seguir.
E3 Studio 59
As propriedades que permitem o uso do AppBrowser so as seguintes:
DBServer dos objetos Frmula, Histrico e Storage
DataSource do objeto Servidor de Alarmes
InitialScreen do objeto Viewer
SplitLink do objeto Quadro
2.10 Conectar A
A opo Conectar a utilizada para determinar a conexo do E3 Studio a um servidor. Esta opo permite configurar
em qual servidor de Domnio o E3 Studio deve se conectar, e permite tambm informar se o E3 Studio deve obter a
licena do servidor onde executa o Domnio ou se deve obter a licena em um outro servidor. Para utilizar este
recurso, clique no menu Arquivo - Conectar a para abrir a caixa de dilogo mostrada na figura a seguir.
Janela Conectar a
Opes disponveis na janela Conectar a
OPO DESCRIO
Conectar ao servidor local Habilita a conexo com o servidor local
Conectar a um servidor na rede Habilita a conexo com um servidor da rede. Para isto,
selecione o servidor usando a caixa de seleo
Pegar licena no servidor de Domnio atual Usa licena do servidor onde o Domnio executa
Usar licena de um servidor especfico Usa a licena de outro servidor, que no o servidor que
est executando o Domnio
Se a conexo com qualquer dos dois servidores (Domnio ou licena) cair, o E3 Studio desconectado do outro
servidor. A ltima configurao guardada no Registro do Windows e, da prxima vez em que o E3 Studio for aberto,
ele se conecta aos servidores de Domnio e de licena utilizados da ltima vez.
Se o servidor de licena no estiver disponvel, ou se no houver mais licenas disponveis, ento o E3 Studio
permanece em modo Demo. Um E3 Studio sem licena (modo Demo) s pode se conectar a um servidor de Domnio
que tambm esteja em modo Demo.
Se o servidor de licena for diferente do servidor de Domnio, o nome do servidor de licena mostrado no ttulo da
janela do E3 Studio: Licena no servidor local ou Licena em <Nome_Servidor>.
Se for especificado um servidor de licena, a janela de licenas do E3 Server no servidor de Domnio mostra o nome
do servidor que est emprestando a licena para o E3 Studio: SERVIDOR1 (licena emprestada de SERVIDOR2).
Neste caso a licena que est listada no servidor de Domnio no entra na contagem de licenas de E3 Studio em uso
naquele servidor.
Se o servidor de Domnio no possuir uma licena, e um E3 Studio se conectar a este servidor usando a licena de
outro, ento o servidor de Domnio passa temporariamente de modo Demo para modo Studio, voltando para modo
Demo assim que a sesso do E3 Studio for fechada.
60 E3 Studio
NOTA
Quando o E3 Studio estiver utilizando uma licena emprestada de outro servidor, ele deve forosamente permanecer
aberto enquanto o aplicativo estiver em execuo. Se ele for fechado enquanto o aplicativo estiver executando, a
licena de E3 Studio emprestada (que permite a execuo do aplicativo por seis horas) liberada, e o E3 Server
finaliza a execuo do aplicativo imediatamente (em no mximo 10 segundos).
DICA
Quando o usurio conectar a um servidor, importante que os aplicativos sejam abertos atravs de um caminho na
rede. Ao invs de usar C:\projetos\projeto.dom, utilize o caminho \\server\projetos\projetos.dom. Desta forma, o
E3 Studio e o E3 Server remoto podem acessar os arquivos utilizando o mesmo caminho.
E3 Studio 61
CAPTULO
Domnios
3
Um Domnio um conjunto de objetos e configuraes que definem um sistema de superviso. Corresponde ao
Aplicativo no Elipse SCADA.
O E3 um ambiente modular de desenvolvimento e execuo de sistemas de superviso, composto pelos mdulos
descritos nas sees a seguir.
3.1 E3 Server
O E3 Server o coordenador de todos os mdulos do E3. Ele sempre executa como servio, mesmo no modo Demo,
seja ele registrado como servio ou com o parmetro /regserver, e deve estar sempre em execuo. Pode tambm
ser iniciado quando um E3 Studio local for iniciado, ou atravs de um atalho para executar o Domnio (por exemplo,
e3admin -start app.dom). Ele responsvel por:
Verificar e gerenciar licenas de uso dos diferentes mdulos do E3
Iniciar, parar ou monitorar o processo de tempo de execuo (E3Run) do Domnio
Abrir, editar ou manipular arquivos DOM
Controlar o acesso de usurios aos objetos do Domnio
Monitorar outros servidores do Domnio e implementar o Hot-Standby
O E3 Server pode trabalhar com apenas um arquivo de Domnio por vez, e este chamado de Domnio aberto. Os
arquivos de Domnio s so manipulados pelo E3 Server.
3.1.1 Licenciamento
O E3 Server suporta dois modos de licenciamento: Licena Ativa e Demo. O modo de licenciamento definido na
inicializao do servidor. Se h um dispositivo de proteo vlido (do tipo Hardkey ou Softkey), o E3 Server entra em
modo Licena Ativa. Se nenhum dispositivo for localizado, entra em modo Demo.
Se houver a troca do dispositivo, o E3 Server compara as licenas deste novo dispositivo com as licenas do
dispositivo anterior e executa os seguintes ajustes:
Se as novas licenas forem exatamente iguais em limitaes s do dispositivo anterior, so aplicadas
imediatamente
Se as novas licenas forem menos limitadas do que as do dispositivo anterior, tambm so aplicadas
imediatamente
Se as novas licenas forem mais limitadas do que as do dispositivo anterior, o E3 Server aguarda por um minuto
para que o dispositivo anterior seja reconectado. Ao final deste perodo, se as licenas continuarem restritivas, o
servidor reiniciado e as novas licenas so aplicadas
NOTA
Para maiores informaes sobre licenciamento no E3, entre em contato com o setor comercial da Elipse Software.
3.2 E3Run
O E3Run o processo responsvel pela execuo dos objetos do servidor: Tags, Alarmes, Banco de Dados,
Histricos, etc., ou seja, todos os objetos exceto as Telas e o objeto Viewer.
A execuo do E3Run indicada no cone do E3 Admin na rea de Notificao do Windows, de acordo com a tabela
a seguir.
Opes disponveis para cones da rea de Notificao
OPO DESCRIO
Seta verde: Mostrada quando o Domnio est carregado
e executando
Quadrado cinza: O Domnio est carregado, mas no
executando
62 Domnios
OPO DESCRIO
Linha reta amarela (giratria): Mostrada quando o
Domnio est sendo iniciado ou parado. Ocorre nos
casos em que o Domnio demora a comear a execuo,
como um sinal de espera
Barras amarelas: Mostradas quando o Domnio est em
modo de espera
O E3Run sempre executa como servio, seja ele registrado como servio ou com o parmetro /regserver. Este
processo usa o protocolo REC para se conectar fila de banco de dados do E3 Server.
3.3 E3 Admin
O E3 Admin o mdulo responsvel por monitorar e comandar o E3 Server. simbolizado pelo cone na rea de
Notificao do Windows. Este mdulo iniciado quando o usurio loga no Windows, ou quando o servio do E3
Server iniciado.
O E3 Admin tambm responsvel por tratar as opes de controle do Domnio via linha de comando, das seguintes
maneiras: e3admin <nome_do_dominio> [opes] ou e3admin [opes] <nome_do_dominio>. As opes de linha
de comando so listadas a seguir:
-start ou /start: Inicia um Domnio informado pelo usurio. O uso desta opo no obrigatrio. Mesmo se no
for informada, o Domnio iniciado
-viewer ou /viewer: Executa o Viewer para a aplicao
-load: Semelhante opo -start, porm somente carrega o Domnio, sem execut-lo. No pode ser usada com
a opo -viewer
-stop: Para o Domnio em execuo, quando existir. Esta opo deve ser utilizada sozinha
-close: Para e fecha o Domnio em execuo, quando existir. Esta opo deve ser utilizada sozinha
-refresh: Fora a atualizao do Domnio sem a utilizao de um Viewer
-help: Mostra uma caixa de dilogo com as opes de linha de comando para o E3 Admin, como na figura a
seguir
Domnios 63
Mensagem de erro do E3 Admin
NOTA
O Windows deve ser reiniciado para que as configuraes do Controle de Conta de Usurio sejam aplicadas.
Caso existam restries no Domnio, as opes -load, -stop, -refresh e -close pedem o login do usurio do E3.
3.4 IOServer
O IOServer o processo responsvel pela execuo dos Drivers de Comunicao. Os IOServers so criados,
mantidos e monitorados pelo processo E3Run.
3.5 E3 Studio
O E3 Studio o ambiente de desenvolvimento e configurao de aplicativos. Permite abrir e editar arquivos .prj ou
.lib. O E3 Studio multi-usurio, isto , vrios E3 Studios podem modificar os mesmos arquivos ao mesmo tempo. O
E3 Studio utiliza a conexo REC para se comunicar com o E3 Server.
3.6 E3 Viewer
O E3 Viewer a interface com o usurio em tempo de execuo, pois mostra as Telas em execuo e permite a
operao do sistema. O E3 Viewer pode ser executado a partir de qualquer ponto da rede que tenha acesso ao E3
Server, sem a necessidade de copiar o aplicativo para os outros E3 Viewers, pois as Telas e os bitmaps so
carregados conforme a necessidade, em tempo de execuo.
3.7 Componentes
Um Domnio constitudo dos arquivos descritos nas sees seguintes.
64 Domnios
3.8 Criando um Domnio
Existem duas maneiras de se criar um Domnio no E3:
Atravs do menu Arquivo - Novo Domnio. Para isto, necessrio que ao menos um projeto ou uma biblioteca
esteja aberto. Ao selecionar esta opo, o E3 abre uma caixa de dilogo para a escolha do caminho e do nome do
novo Domnio
Uma vez que o Assistente tenha sido acessado, a tela inicial aberta. Para continuar, clique em Avanar.
Domnios 65
Tela inicial do Assistente de Aplicaes
NOTA
As telas Driver de Comunicao, Banco de Dados e Alarmes s so mostradas na criao de uma Aplicao
padro.
Uma Biblioteca de componentes do E3 um arquivo utilizado para guardar diversos componentes que podem ser
utilizados em aplicaes.
Uma Aplicao em branco um projeto criado sem nenhum objeto.
No item Nome da aplicao, especifique o nome do arquivo .prj ou .lib que est sendo criado (de acordo com o que
foi selecionado na opo anterior). O local onde a aplicao salva deve ser especificado no item Salvar a aplicao
na pasta. Caso seja necessrio, clique em Procurar.
66 Domnios
Tela Tipo de Aplicao
Caso a pasta informada no exista, o usurio avisado, e deve decidir se deseja cri-la.
NOTA
A opo Biblioteca de componentes do E3 discutida mais adiante, no captulo Bibliotecas.
3.8.1.2 Domnio
Nesta tela, possvel decidir a qual Domnio pertence o projeto ou a biblioteca que est sendo criado. A seleo da
opo Adicionar no Domnio ativo condicionada existncia de Domnios ativos no sistema. Clicando nesta opo,
o novo projeto faz parte do Domnio atual. A opo Criar um novo Domnio cria um novo Domnio, ao qual o
projeto ou biblioteca pertence. O nome deste novo Domnio indicado na opo Entre com o nome do Domnio.
Por fim, com a opo No adicionar em nenhum Domnio, o projeto ou biblioteca criado continua sem pertencer a
nenhum Domnio.
Domnios 67
Tela Domnio
Clique em Avanar para prosseguir.
68 Domnios
3.8.1.4 Driver de Comunicao
Nesta tela, o usurio pode decidir pela incluso de um objeto Driver de Comunicao no projeto sendo criado. Caso
positivo, possvel configurar o arquivo .dll que este Driver utiliza, na opo Arquivo do driver de comunicao. Para
procurar o arquivo, clique em .
Domnios 69
Clique em Avanar para prosseguir.
3.8.1.6 Alarmes
Nesta tela, o usurio pode decidir pela incluso de um objeto Servidor de Alarmes e de um objeto Configurao de
Alarmes no projeto sendo criado. A opo Desejo guardar os dados dos alarmes em disco habilita o
armazenamento de informaes relativas a alarmes em disco, desde que um objeto Banco de Dados tenha sido
inserido no projeto.
Tela Alarmes
Clique em Avanar para finalizar a criao da aplicao.
Aps, o Studio mostra a tela final do Assistente, com uma mensagem que indica o final do processo de criao da
aplicao.
70 Domnios
3.9 Configuraes
Atravs do menu do E3 Admin na rea de Notificaes do Windows, possvel executar, parar, atualizar ou fechar o
Domnio diretamente atravs das opes Executar, Parar, Atualizar e Fechar, respectivamente.
Alm disto, o Domnio tambm pode ser configurado para apresentar redundncia e utilizar Domnios Remotos, entre
outras aes. Estas configuraes so realizadas atravs da opo Domnio - Opes.
NOTA
Os menus Domnio - Opes e Domnio - Exportar usurios no esto disponveis no modo Demo, e as opes
de Executar e Parar no esto disponveis se o Domnio estiver em modo Hot-Standby ou for aberto em um
computador que no faz parte do Domnio.
Domnios 71
3.9.1 Aba Opes
Na aba Opes possvel habilitar a redundncia de servidores.
Aba Opes
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Opes
OPO DESCRIO
Hot-Standby Aciona o modo Hot-Standby. Se a opo for desabilitada,
o Domnio executado no servidor em que foi carregado,
sem suporte a Hot-Standby. Se a opo for habilitada,
possvel selecionar um servidor principal onde o Domnio
executado e, opcionalmente, um servidor em espera
Servidor principal Seleciona o nome do servidor principal para execuo do
Domnio. Para cadastrar e configurar os servidores, utilize
a aba Servidores
Servidor de backup Se habilitada, seleciona um servidor de backup para
execuo do Domnio. Este servidor permanece em
espera, com o aplicativo carregado no E3Run pronto para
ser executado caso o servidor principal falhe, ou caso o
servidor de backup seja ativado manualmente
72 Domnios
OPO DESCRIO
Endereos para PING de integridade da rede O algoritmo de Hot-Standby exige que seja declarada
uma terceira entidade de rede (as outras duas so os
servidores principal e o backup) para determinar se a rede
est funcionando. Se no for possvel acessar o endereo
de integridade nem o servidor de backup, o servidor
principal assume que a sua interface de rede est com
problemas e termina imediatamente a execuo do
Domnio. Este campo permite que vrios endereos de
rede sejam registrados. As opes para este campo so
as seguintes:
Os separadores permitidos para cada um dos
endereos so o espao, a vrgula, o ponto e vrgula, a
tabulao e a quebra de linha
Se pelo menos um dos endereos fornecidos neste
campo retornar sucesso, a rede considerada sem
falhas
Os nomes de servidores no so sensveis caixa
Nomes repetidos so descartados
Espaos em branco antes ou depois do endereo so
removidos
Ativar backup em caso de falha local Habilita a troca automtica de servidores quando uma
falha local reportada no servidor principal. Falhas locais
so detectadas e reportadas pelo prprio aplicativo
atravs do mtodo Application.ReportFailure. A troca de
servidores s executada se o servidor de backup estiver
sem falhas
Tempo para ativao do servidor reserva Permite indicar o tempo de ativao para o servidor de
backup. O valor padro 15 segundos. Este tempo afeta
diretamente o time-out do ping entre os servidores. Se for
muito abaixo (troca em um segundo, time-out de ping em
160 ms), podem ocorrer trocas espontneas de servidor,
causadas por pequenas falhas de rede
Perfil de pr-ativao do servidor reserva Apresenta os seguintes perfis de pr-ativao disponveis:
Mnimo: Ativa apenas os servios bsicos
Mximo: O E3 ativa o mximo de objetos quando est
em espera (Associaes, Drivers, scripts e Bancos de
Dados)
Definido pelo usurio: O usurio pode definir quais os
servios deseja ativar. Cada uma das opes pode ser
habilitada ou desabilitada individualmente
Pr-ativar os seguintes servios Permite ao usurio selecionar os servios que deseja
ativar (desde que a opo anterior tenha sido habilitada
como Definido pelo usurio):
Associaes (Links): O valor padro desabilitado. Se
habilitado, faz com que Associaes e propriedades do
tipo Link de XFolders e XObjects sejam avaliadas
durante a ativao em espera
Drivers de E/S (sem comunicao): O valor padro
desabilitado. Se habilitado, os IOServers so criados
durante a ativao em espera. NOTA: Esta opo
importante em aplicativos com vrios Drivers de
Comunicao
Domnios 73
OPO DESCRIO
Scripts: O valor padro desabilitado. Se habilitado, faz
com que todos os scripts de eventos de objetos e de
bibliotecas sejam compilados e ativados durante a
ativao em espera
Banco de Dados: O valor padro habilitado. Isto
significa que o Banco de Dados conectado durante a
ativao em espera. Se desabilitado, apenas evita que a
conexo com o Banco de Dados seja criada durante a
ativao em espera
Esta opo habilitada automaticamente quando o valor
da propriedade EnableSynchronization for igual a
Verdadeiro
NOTA
Quando o Domnio colocado em execuo, o E3 Server sempre seleciona o servidor ativo por ordem alfabtica,
independente de estar selecionado como principal ou backup. Este critrio de desempate utilizado sempre que
mais de um servidor se candidata a executar o Domnio. Para maiores informaes, veja o captulo Hot-Standby.
NOTA
A REDUNDNCIA NO EST DISPONVEL EM MODO DEMO. Quando o modo Hot-Standby estiver ligado,
necessrio que todos os servidores tenham uma cpia dos arquivos do Domnio (.dom, .prj e .lib) e a mesma rvore
de diretrios.
74 Domnios
Aba Segurana
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Segurana
OPO DESCRIO
O usurio no pode alterar a sua senha Impede que o usurio troque a senha em tempo de
execuo
A senha expira aps ... dias Determina o prazo de validade da senha do usurio.
Antes de terminar o prazo de validade da senha, o
sistema avisa quantos dias restam para expirar. Aps a
senha expirar, o usurio desabilitado
A senha deve conter no mnimo ... caracteres Determina a quantidade mnima de caracteres para a
senha do usurio
A senha deve conter letras e nmeros Determina que a senha do usurio deve conter letras e
nmeros
A senha deve conter no mnimo ... nmeros Determina a quantidade mnima de nmeros na senha
A senha deve conter no mnimo ... letras Determina a quantidade mnima de letras na senha
A senha deve conter letras maisculas e minsculas Determina que a senha do usurio deve conter letras
maisculas e minsculas
Bloquear a conta do usurio aps ... falhas de login Determina a quantidade mxima de falhas de login para
que a conta do usurio seja bloqueada
Desbloquear o usurio automaticamente aps ... Desbloqueia a conta do usurio depois de determinados
minutos minutos
Domnios 75
OPO DESCRIO
Avisar o usurio nos ltimos ... dias antes da senha Determina a data em que o sistema comea a enviar
expirar mensagens dirias ao usurio, avisando-o sobre a data
de expirao de sua senha. Aps esta data, se o usurio
no trocar sua senha, ele bloqueado e somente o
administrador pode desbloque-lo
Validar senhas sem diferenciar maisculas e Permite que as senhas sejam validadas sem diferenciar
minsculas maisculas de minsculas. Esta opo no
recomendada
Bloqueio de Senha
A conta de um usurio pode ser bloqueada nas seguintes condies:
Se a senha expirar (o tempo de expirao pode ser atributo global, de grupo ou de usurio)
Se o usurio digitar a senha errada um determinado nmero de vezes seguidas, isto , falhas de login
Uma vez bloqueada, a conta no permite login. Esta condio persiste at que um administrador desbloqueie a senha
manualmente, ou ento o time-out de bloqueio expire.
Permitir conexes de Viewer Full Quando selecionada, permite conexes do tipo Viewer
Full para o grupo
Limitar uso de licenas simultneas Quando selecionada, limita o uso de licenas do tipo
Viewer Full simultneas a um determinado nmero. Se a
opo anterior estiver selecionada, mas esta estiver
desmarcada, o uso de licenas simultneas ilimitado
Permitir conexes de Viewer Only Quando selecionada, permite conexes do tipo Viewer
Only para o grupo
Limitar uso de licenas simultneas Quando selecionado, limita o uso de licenas do tipo
Viewer Only simultneas a um determinado nmero. Se
a opo anterior estiver selecionada, mas esta estiver
desmarcada, o uso de licenas simultneas ilimitado
importante notar que estes limites so aplicados aps o limite do E3 Server, como configurado no dispositivo de
proteo. Por exemplo, se o dispositivo de proteo possuir dez licenas de Viewer e o grupo especificar cinco
conexes no mximo, apenas estas cinco so usadas. No entanto, se o dispositivo de proteo possuir cinco licenas
de Viewer e o grupo especificar dez conexes no mximo, utilizado o limite de cinco conexes do dispositivo. Ou
seja, o grupo de Viewer tem sempre uma limitao de licenas adicional a ser aplicada na conexo do Viewer.
A configurao de Grupos de Viewers deve ser realizada preferencialmente com o Domnio parado. Caso seja
realizada com o Domnio em execuo, ela no tem efeito at que todos os Viewers sejam desconectados.
NOTAS
No caso de conexes identificadas como E3AccessLayer e E3DataAccess, que por padro no consomem licenas
do E3 Server, o comportamento dos Grupos de Viewers o seguinte:
Se o Grupo de Viewers no permitir conexes do tipo Viewer Full nem do tipo Viewer Only, a conexo negada
Se o Grupo de Viewers permitir conexes do tipo Viewer Full, a conexo permitida e obedece ao tipo de
acesso requisitado. Por exemplo, para acessos do tipo Viewer Only a conexo apenas de leitura, e para acessos
do tipo Viewer Full a conexo de leitura e escrita
Se o Grupo de Viewers permitir apenas conexes do tipo Viewer Only, a conexo permitida e somente de
leitura, mesmo para acessos do tipo Viewer Full
Domnios 77
3.9.4 Aba Registro de Eventos
Os eventos dividem-se em duas categorias: Eventos Padro do Sistema e Eventos Manuais.
Eventos Padro do Sistema so os eventos gerados automaticamente pelo E3, e que podem ter o registro habilitado
ou desabilitado individualmente:
Login ou logout de usurio
Troca de senha de usurio
Falha de login de usurio
Alterao na base de dados de usurio
Bloqueio de conta de usurio
Incio ou trmino do Domnio
Alterao no Domnio (inserir, remover, habilitar ou desabilitar projetos e bibliotecas, alterar a configurao do
Domnio)
Atualizao do Domnio (quando o usurio aplica as alteraes realizadas em projetos, atravs do E3 Studio)
Troca manual de servidor Hot-Standby
Criao de usurio
Mudana de usurio
Remoo de usurio
Renomeao de usurio
Mudana em diretivas de usurio
Criao de grupo
Mudana de grupo
Remoo de grupo
Renomeao de grupo
Mudana em diretivas de grupo
Eventos Manuais so eventos definidos pelo aplicativo. Estes eventos so gerados em scripts de usurio, atravs da
chamada do mtodo Application.TrackEvent. Estes eventos podem ser gerados tanto no Viewer quanto no Servidor
(E3Run).
O Viewer apenas um gerador de eventos manuais. Basta utilizar o mtodo Application.TrackEvent e o evento
enviado para o E3 Server.
O diagrama a seguir mostra como os diferentes processos do E3 geram e tratam os eventos do sistema.
78 Domnios
Diagrama de processos
Cada E3 Server mantm uma lista interna dos eventos que devem ser registrados no Banco de Dados. Estes eventos
podem vir de trs fontes:
Eventos gerados nos Viewers (usando o mtodo Application.TrackEvent)
Eventos gerados internamente no E3 Server
Eventos gerados no E3 Server Standby
O E3 Server Standby, de tempos em tempos, envia a lista de eventos para o E3 Server Hot, pois apenas este tem
condies de gravar eventos no Banco de Dados. Os eventos so colocados na fila de eventos do Hot, juntamente
com os demais eventos do sistema, isto , o servidor Hot centraliza a gravao de eventos.
Se houver uma troca de servidor, os eventos que no haviam sido gravados so passados automaticamente para o
novo servidor Hot.
O E3Run grava no Banco de Dados os registros enviados pelo E3 Server Hot. O E3 Server informa o nome do
Servidor de Dados e da tabela onde os dados so gravados.
Para configurar o registro de eventos do E3, clique com o boto direito do mouse no cone do E3 Admin na rea de
Notificao do Windows, selecione a opo Domnio - Opes, e clique na aba Registro de Eventos. A janela da
figura a seguir mostrada.
Domnios 79
Aba Registro de Eventos
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Registro de Eventos
OPO DESCRIO
Registrar os eventos do sistema em uma tabela no Habilita o registro de eventos no E3. Ao selecionar esta
Banco de Dados do aplicativo opo, a opo Nome da tabela deve ser
obrigatoriamente preenchida
Nome da tabela Indique o nome da tabela onde so gravados os eventos.
A tabela informada criada automaticamente pelo E3Run,
e tem os seguintes campos:
E3TimeStamp (Data/Hora): O campo E3TimeStamp
configurado pelo E3Run e contm a data e hora em que
o E3Run conseguiu enviar o evento para o Banco de
Dados
EventTime (Data/Hora): O campo EventTime a data
e hora em que realmente ocorreu o evento, a data e
hora atual do servidor (Hot ou Standby) quando o
evento foi criado, ou ento o parmetro dtTimeStamp
especificado para o mtodo Application.TrackEvent
EventMessage (String): Mensagem do evento (mximo
de 200 caracteres)
EventComment (String): Comentrio sobre o evento
(mximo de 200 caracteres)
80 Domnios
OPO DESCRIO
Selecionar automaticamente um Banco de Dados no Habilite esta opo para deixar que o E3Run selecione um
aplicativo objeto Servidor de Dados para gravar os dados. Se o
aplicativo possui apenas um Servidor de Dados, este
objeto usado. Se possuir mais de um, recomendado
selecionar a opo Usar este Banco de Dados
Usar este Banco de Dados Habilite esta opo para especificar o Servidor de Dados
onde so gravados os eventos. Se o nome do Servidor de
Dados foi informado incorretamente, os eventos
permanecem armazenados na fila de eventos do E3 Server
(em memria), at que seja indicado um Servidor de
Dados vlido
Marque abaixo os eventos que devem ser registrados Lista os eventos disponveis no sistema para serem
registrados
Se o E3Run tiver que escolher entre vrios Servidores de Dados, normalmente utilizado o primeiro Banco de Dados
ativado na execuo do Domnio. Se durante a execuo do Domnio, o usurio desabilitar o projeto que contm o
Servidor de Dados que estava sendo usado para gravar os eventos, o E3Run automaticamente seleciona outro
Servidor de Dados que esteja disponvel no aplicativo, e continua com este Servidor de Dados at que o Servidor de
Dados anterior seja reativado. Isto implica que, se houver mais de um Servidor de Dados no projeto, possvel que
alguns eventos sejam gravados em um Servidor de Dados e outros eventos em outro Servidor de Dados (por isto,
recomendado indicar um Servidor de Dados especfico, quando houver mais de um Servidor de Dados no projeto).
Quando um evento selecionado na lista e a tecla F2 pressionada, abre-se uma caixa de dilogo para edio do
evento. A janela mostrada na figura a seguir mostrada.
Edio de eventos
Desmarque a opo Usar mensagem padro para alterar a mensagem do evento. Clique em para inserir uma
macro dentro da mensagem. Apenas as macros permitidas para aquele evento so mostradas.
Domnios 81
Visualizao da macro disponvel para o evento
As macros sempre tm o formato %MACRO%. As seguintes macros podem ser usadas:
%%: Insere um sinal de % (porcentagem) na mensagem
%NAME%: Insere o nome do usurio ou grupo que foi afetado por este evento
%NEWNAME%: Insere o novo nome de um usurio ou grupo que foi renomeado por este evento
%USER%: Insere o nome do usurio que gerou o evento (ou "Annimo", se no houver nenhum usurio logado)
%MACHINE%: Insere o nome do computador onde o evento foi gerado
%SESSION%: Insere o nome do programa onde o usurio estava logado (Viewer, Studio ou E3 Server)
%CAUSE%: Informao adicional sobre o evento
Se o usurio Admin escrever uma senha errada enquanto executa o login no Viewer que est executando na mquina
CLIENT004, gerado o seguinte evento:
"Falhou login do usurio Admin no computador CLIENT004 (usando um Viewer): login ou senha
incorretos"
82 Domnios
3.9.4.3 Troca de Senha
A senha do usurio %USER% foi alterada
Gerado sempre que a senha de um usurio for trocada (utilizando o mtodo ChangePassword no Viewer), onde:
%USER% contm o nome de login do usurio que teve a senha trocada
Domnios 83
3.9.4.10 Domnio Modificado
Domnio modificado pelo usurio %USER% no %SESSION% na mquina %MACHINE%: %CAUSE%
Gerado sempre que o arquivo do Domnio (.dom) modificado, onde:
%USER% contm o nome do usurio que alterou o Domnio
%SESSION% contm "Studio" ou "E3 Server"
%MACHINE% contm o nome do computador onde foi gerado o comando de modificar o Domnio
%CAUSE% pode ser:
Aplicadas alteraes na janela do computador de edio do Domnio
Adicionado projeto "nomedoprojeto" (habilitado)
Adicionado projeto "nomedoprojeto" (desabilitado)
Removido projeto "nomedoprojeto"
Desabilitado projeto "nomedoprojeto"
84 Domnios
3.9.4.16 Diretivas de Usurio
Os direitos do usurio '%NAME%' foram modificados por '%USER%'
Gerado sempre que os direitos de um usurio so modificados, onde:
%NAME%: Nome do usurio cujos direitos foram modificados
%USER%: Nome do usurio que procedeu a modificao nos direitos do usurio
Domnios 85
Aba Projetos
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Projetos
OPO DESCRIO
Nome Esta opo lista os nomes dos projetos no sistema
86 Domnios
Aba Servidores
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Servidores
OPO DESCRIO
Nome Lista com os nomes dos servidores no sistema
Domnios 87
OPO DESCRIO
Em manuteno (execuo desabilitada) Esta opo permite desabilitar o servidor e no utiliz-lo
na execuo do Domnio. Quando a opo habilitada, o
cone indica que o servidor no utilizado. Do
contrrio, o cone indica que o servidor pode ser
utilizado
88 Domnios
OPO DESCRIO
Arquivo de Domnio Determina o nome ou o caminho na rede onde est o
arquivo .dom do Domnio Remoto
Servidor Principal Identifica o servidor principal na rede
possvel que uma configurao de Domnio Remoto possibilite a conexo ao prprio Domnio local. A isto se d o
nome de Alias local ou conexo Loopback.
Este alias criado segundo a configurao normal de Domnios Remotos. Basta que o nome dos servidores (principal
ou backup) seja localhost* ou o mesmo da mquina onde o Domnio est executando para que tudo funcione
localmente. Neste caso, para que a configurao funcione no E3 Studio, no campo Arquivo de Domnio, basta digitar
diretamente o caminho local do arquivo DOM (por exemplo, c:\caminho\arquivo.dom).
NOTAS
A mudana dos aliases locais com o Domnio executando NO suportada. O que acontece que, se o Domnio
estiver executando, Links j resolvidos como locais continuam sempre locais, mesmo que o alias seja reconfigurado
para conectar em uma mquina remota realmente. Para contornar isto, reinicie o Domnio
As conexes do tipo loopback no aparecem na janela Licenas (ou Estatsticas) do E3 Admin e nem necessitam
de licena de Domnios Remotos para funcionar
* Para que o nome localhost funcione, necessrio que ele esteja configurado para apontar para o endereo IP
127.0.0.1 (que a configurao padro do Windows)
Para maiores informaes sobre as configuraes da aba Domnios Remotos, veja o tpico Configurao da
Conexo
Domnios 89
Aba Propriedades
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Propriedades
OPO DESCRIO
Pool Habilitado Habilita ou desabilita o pool de processos IOServer.
NOTA: Certifique-se que os Drivers em uso na aplicao
suportam o recurso de pool de processos (os Drivers
devem ter sido compilados com o IOKit verso 2.0.6 ou
superior). Os Drivers que no suportam este recurso
devem ser configurados com a propriedade
DisableIOServerPool em Verdadeiro. O valor padro
desta opo Falso
Esta configurao pode ser alterada com o Domnio em execuo, porm somente afeta os Drivers iniciados aps a
alterao, ou nas situaes em que o Domnio atualizado:
Ao clicar em Executar Aplicativo no E3 Studio
Ao selecionar a opo Domnio - Atualizar, no menu do E3 Admin na rea de Notificaes do Windows
Ao gerar um evento que force o E3Run a receber a configurao do Domnio
90 Domnios
NOTA
Para maiores informaes, veja o tpico Pool de Processos IOServer no captulo Drivers.
3.10.2 Atalhos
Esta opo permite executar aplicativos presentes na instalao do E3 diretamente pelo menu contextual do cone do
E3 Admin, na rea de Notificao do Windows. Os seguintes aplicativos podem ser executados:
Log Viewer
E3 Studio
E3 Tweak
E3 Viewer
O item Log Viewer abre o aplicativo Elipse Event Log Viewer j com o arquivo correspondente sesso ativa de
logs do E3. Para maiores informaes sobre este aplicativo, consulte o Manual do Usurio do Elipse Event Log,
disponvel no menu Iniciar - Programas - Elipse Software - Elipse Event Log.
Domnios 91
Se j h um Domnio executando localmente, o item E3 Viewer deste menu abre um Viewer para o Domnio local. Do
contrrio, ou se a tecla SHIFT estiver pressionada, abre-se a janela inicial do Viewer, onde possvel selecionar o
servidor e outras opes, como descrito no tpico E3 Viewer e E3 WebViewer - Execuo do E3 Viewer - Execuo
Atrves do Menu Iniciar.
3.10.3 Licenas
possvel visualizar as diversas licenas disponveis atravs do E3 Admin. Para isto, clique com o boto direito do
mouse no cone do E3 Admin na rea de Notificaes do Windows e selecione a opo Licenas. A janela da figura a
seguir mostrada.
92 Domnios
OPO DESCRIO
Pontos E/S Indica o nmero de pontos de comunicao
Para maiores informaes sobre as limitaes do modo Demo do E3, veja o tpico Limitaes do Modo
Demonstrao.
NOTA
Os usurios logados e identificados como E3DataAccess e E3AccessLayer, na coluna Programa da lista Usurios
Logados, no consomem licenas de Viewer de um E3 Server.
3.10.4 Estatsticas
A janela E3 Admin - Estatsticas de Comunicao mostra os dados em tempo real sobre o trfego de informaes
na rede. A lista atualizada automaticamente a cada segundo. Para isto, clique com o boto direito do mouse no
cone do E3 Admin na rea de Notificaes do Windows e selecione a opo Estatsticas.
3.10.5 Monitor
A janela E3 Admin - Monitor mostra informaes em tempo real sobre o estado dos servidores do Domnio. Para
isto, clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do Windows e selecione a
Domnios 93
opo Monitor.
3.10.6 Inicializao
Esta opo permite controlar o Domnio a ser iniciado automaticamente. O Domnio configurado s executado se o
E3 Server no estiver em modo Demo. Para isto, clique com o boto direito do mouse no cone do E3 Admin na rea
de Notificaes do Windows e selecione a opo Inicializao. A janela da figura a seguir mostrada.
94 Domnios
Janela E3 Admin - Inicializao
As opes disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na janela E3 Admin - Inicializao
OPO DESCRIO
O Domnio carregado Ao iniciar, executa automaticamente o Domnio
previamente carregado
O Domnio configurado Ao iniciar, executa automaticamente o Domnio
configurado pelo usurio
Nenhum Domnio No inicia nenhum Domnio
3.10.7 Impressora
Esta opo mostra a lista das impressoras encontradas local ou remotamente, e permite que o usurio seleciona uma
para ser usada pelo E3 Server. Para isto, clique com o boto direito do mouse no cone do E3 Admin na rea de
Notificaes do Windows e selecione a opo Impressora. A janela da figura a seguir mostrada.
96 Domnios
1. Informe um apelido para o Domnio Remoto no campo Nome do Domnio. Este campo no sensvel a
maisculas ou minsculas. Este nome usado na aplicao para referenciar os objetos a serem acessados no
Domnio Remoto.
2. Especifique o caminho do arquivo .dom do Domnio Remoto. Este caminho deve ser um compartilhamento na
rede que permita acessar este arquivo .dom.
3. Informe o nome do servidor principal, que deve ser o servidor contendo o Domnio Remoto especificado no
caminho do arquivo .dom. Esta configurao utilizada para encontrar os objetos do Domnio Remoto em tempo
de execuo.
O item Servidores e opes de conexo contm a opo Avanado, que permite realizar configuraes especficas
da conexo entre os Domnios, atravs da janela mostrada na figura a seguir.
Domnios 97
OPO DESCRIO
Utilizar heartbeat na conexo Esta opo permite que, atravs de um mecanismo do
protocolo REC, o Domnio Remoto Cliente verifique se o
Servidor est mantendo a conexo ativa, esperando que
sejam enviadas mensagens de heartbeat peridicas,
mesmo que no haja nenhuma outra comunicao a ser
feita. Se for excedido o dobro do tempo de heartbeat
configurado, sem que o Cliente receba uma mensagem
qualquer do computador Servidor, considera-se que o
Servidor falhou ou est fora da rede, sendo forada uma
desconexo imediata
Perodo de heartbeat (ms) O valor, em milissegundos, do perodo de heartbeat. O
valor padro desta opo 2000 ms
Utilizar criao assncrona de links Se esta opo estiver selecionada, os Links so criados
em paralelo entre os diversos Domnios e o resultado da
operao vem assincronamente, medida que cada
Servidor responder. A vantagem desta opo no
trancar o tratamento de Links geral do E3 Server. Apenas
operaes daquele mesmo Domnio podem ficar
trancadas, caso a criao de Links demore muito (o que
pode ocorrer em redes lentas). NOTA: Esta opo no
est disponvel para verses anteriores 3.2, e as
aplicaes desenvolvidas em verses anteriores falham
com o cdigo de erro 8004F108 (verso incompatvel do
REC). O valor padro desta opo desmarcada, que
corresponde ao comportamento das verses anteriores
verso 3.2
NOTA
Desmarcar simultaneamente as opes Verificar PING e Utilizar heartbeat na conexo torna a deteco de queda
da conexo extremamente lenta, caso o Servidor falhe. Recomenda-se que as duas opes estejam sempre
selecionadas.
No E3 Studio, o caminho completo do compartilhamento usado para que seja possvel determinar os objetos
existentes no Domnio Remoto. O nome do arquivo .dom (sem o caminho) usado para verificar se a conexo remota
est sendo realizada com o Domnio correto, em tempo de execuo. Assim, se o nome do Domnio carregado no E3
Server remoto no for o correto, a conexo no completada e os objetos remotos no ficam acessveis.
Outra possibilidade manter uma cpia do Domnio Remoto na mquina Cliente, e digitar o caminho desta cpia no
campo Arquivo de Domnio. Desta forma, o E3 Studio vai utilizar a cpia local para determinar quais objetos existem,
permitindo o trabalho offline. A cpia deve obrigatoriamente ter o mesmo nome do Domnio Remoto para que a
conexo funcione, no sendo necessrio possuir a mesma hierarquia de diretrios.
Alm disto, para que a conexo entre os Domnios possa ocorrer, todos os E3 Servers envolvidos devem executar a
mesma verso do E3. No possvel, por exemplo, conectar-se a um Domnio que esteja rodando a verso 2.5 do E3.
Para que um E3 Server aceite receber conexes de outros Domnios, isto , para que ele seja um servidor de
Domnios Remotos, no necessria nenhuma configurao especfica.
Aps a correta configurao destes itens, necessrio apenas executar os E3 Servers para que as conexes remotas
sejam estabelecidas.
NOTA
Para maiores informaes sobre a configurao de Domnios Remotos, veja o tpico Configuraes de Domnio -
Domnios Remotos.
3.11.2 Licenas
Tanto o E3 Server executando o Domnio Cliente, quanto o que executa o Domnio Servidor, devem ter licenas
especficas para Domnios Remotos.
98 Domnios
Quando esta licena existe, o E3 Server Servidor passa a aceitar um nmero ilimitado de conexes externas de outros
Domnios. Da mesma forma, no caso do E3 Server Cliente, possvel estabelecer um nmero ilimitado de conexes.
Para maiores informaes sobre as limitaes do modo Demo do E3, veja o tpico Limitaes do Modo
Demonstrao.
Domnios 99
Permisses de usurio
Com isto, pode ser necessrio que a conexo com o Domnio Remoto especifique um determinado usurio para
poder ter acesso completo aos objetos do Domnio. Este usurio deve ser especificado no campo Usurio no
Domnio atravs da opo Utilizar a seguinte conta, na aba Domnios Remotos da configurao do Domnio Cliente.
Ali devem ser especificados o login e senha de um usurio existente no Domnio sendo acessado remotamente.
Alm do acesso em modo Somente Leitura, possvel bloquear completamente o acesso remoto, o que exige que a
conexo com o Domnio Remoto especifique um determinado usurio para poder ganhar acesso aos objetos
remotos. Isto feito atravs da permisso Acesso remoto ao Domnio, tambm do item de segurana Domnio.
NOTA
A permisso Acesso remoto ao Domnio sempre tem precedncia sobre a permisso Acesso remoto de escrita ao
Domnio. Isto significa que, quando a primeira permisso for negada, a segunda no efetivada mesmo quando
explicitamente permitida. No havendo nenhuma permisso de acesso configurada, qualquer Domnio pode se
conectar remotamente a outro, utilizando um usurio annimo.
3.11.5 Hot-Standby
A conexo remota ao Domnio suporta Domnios com Hot-Standby nativamente. Para isto, basta apenas especificar os
nomes dos dois servidores (principal e backup) nos itens respectivos da rea Identificao dos servidores na rede,
na aba Domnios Remotos. importante ressaltar que, para o correto funcionamento do Hot-Standby, estes nomes
devem ser os mesmos especificados pelo Domnio Remoto acessado. Uma vez que haja esta configurao em tempo
de execuo, o E3 Server sempre tenta conectar-se aos dois servidores, direcionando o acesso de todos os
comandos Application.GetObject e Links para o primeiro servidor que possa ser acessado e que indique estar
executando o Domnio. Caso os nomes dos servidores sejam modificados quando o Domnio Cliente estiver em
execuo, este se desconecta e reinicia a conexo com os novos servidores.
100 Domnios
E3 Studio. Assim, a porta de conexo do REC e as possveis configuraes de firewall associadas tambm se aplicam
aos Domnios Remotos.
Com a conexo estabelecida, espera-se que haja um Domnio executando. Neste processo, a conexo refeita
sempre que houver algum problema. Aps ser encontrado o Domnio executando, verifica-se o nome correto do
Domnio, bem como o login do usurio (se necessrio).
Assim como acontece com as conexes REC do E3 Studio e do E3 Viewer, as estatsticas de comunicao das
conexes de Domnios Remotos podem ser visualizadas na janela de Estatsticas do E3 Server, acessveis atravs do
cone do E3 Admin na rea de Notificaes do Windows.
3.11.7 Desconexo
O Domnio Cliente pode no conseguir estabelecer a conexo com o Domnio Servidor por uma srie de motivos.
Entre eles esto:
O computador do Cliente ou do Servidor est fora da rede
O Servidor no est executando o E3 Server
O E3 Server do Servidor no est com o Domnio correto, ou o Domnio no foi iniciado
O Domnio Servidor no aceita o usurio especificado pelo Domnio Cliente
O E3 Server do Cliente ou do Servidor no possui licena de Domnio Remoto
O E3 Server do Servidor de uma verso antiga (2.5 ou inferior)
Existe um firewall bloqueando a porta utilizada pelo REC, ou o Cliente e o Servidor esto usando portas diferentes
O apelido do Domnio no existe na configurao de Domnio Remoto
Quando uma destas situaes ocorrer, todos os Links do Cliente referenciando o Domnio so desconectados, assim
como todos os mtodos Application.GetObject referenciando o Domnio Remoto falham, ou seja, causam erros de
script. Quando o problema for resolvido, os Links devem conectar-se automaticamente. J os comandos de
Application.GetObject devem ser executados novamente.
Domnios 101
CAPTULO
Drivers
4
O E3 permite a comunicao com equipamentos de aquisio de dados, controladores, CLPs (Controladores Lgicos
Programveis), UTRs (Unidades Terminais Remotas), ou qualquer outro tipo de equipamento, atravs de Drivers de
Comunicao prprios ou Servidores OPC, de acordo com o tipo do equipamento ou tipo de comunicao necessria.
NOTAS
Os objetos de Drivers (Driver de Comunicao, Pasta de Comunicao, Tag de Comunicao, Bloco de
Comunicao, Elemento de Bloco, Driver de Comunicao OPC, Grupo de Tags OPC, Pasta OPC, Tag de
Comunicao OPC, Bloco de Comunicao OPC, Elemento de Bloco OPC, Driver de Comunicao OPC UA,
Assinatura OPC UA, Pasta OPC UA, Tag de Comunicao OPC UA, Bloco de Comunicao OPC UA e Elemento de
Bloco OPC UA) podem ser configurados para funcionarem como reas de Alarme.
Todas as opes do editor dos objetos de Drivers que esto disponveis via menu contextual (atravs do clique
com o boto direito do mouse) tambm esto disponveis utilizando a combinao de teclas SHIFT + F10, que
corresponde tecla de aplicao ou de menu .
A janela de propriedades dos objetos de Drivers no editor de objetos pode ser aberta utilizando as combinaes
de teclas ALT + ENTER, CTRL + ALT + ENTER ou ALT + duplo-clique do mouse.
102 Drivers
Janela Localizar Driver
Se for selecionado um Driver vlido, o Studio exibe sua janela prpria de configurao. Logo em seguida, abre-se a
janela de importao de Tags (se disponvel).
Ao inserir um Driver em uma aplicao do E3 Studio, abre-se o Editor do objeto, conforme a figura a seguir.
Drivers 103
CONE OPO DESCRIO
Ativar/desativar comunicao Ativa ou desativa a comunicao do
Driver
Contagem de tags Apresenta o nmero total de Tags de
Comunicao no Driver
4.1.1 Configurao
Para determinar o Driver de Comunicao a ser usado, clique na propriedade DriverLocation ou clique com o boto
direito do mouse no Driver e selecione a opo Procurar DLL. Uma caixa de dilogo para selecionar o arquivo .dll
que contm o Driver exibida, conforme a figura a seguir.
Selecionando um Driver
Para maiores informaes sobre a configurao individual de cada Driver, consulte os respectivos arquivos de ajuda
que acompanham os Drivers, onde constam instrues sobre a configurao dos parmetros [P] e demais
propriedades, acessveis pela janela de configurao do Driver.
4.1.2 Funcionamento
O IOServer o mdulo do E3 responsvel pela comunicao com um equipamento. no processo do IOServer que
carregada a DLL do Driver e efetuada a comunicao com o equipamento.
Os Tags de Comunicao possibilitam a leitura ou escrita de um conjunto de valores, utilizando o Driver de
Comunicao onde eles esto inseridos. Podem ser utilizados tambm os Blocos de Comunicao para a leitura
simultnea de mais de uma varivel. Para acessar cada valor do Bloco utilize o Elemento de Bloco, que pode ser
includo dentro do objeto. Estes objetos so discutidos nos tpicos seguintes.
104 Drivers
Por padro, o E3 cria um IOServer para cada Driver de Comunicao em tempo de execuo. Baseado no tempo de
varredura (propriedade Scan) de cada Tag, o Driver requisita periodicamente o valor de cada um. Sempre que o valor
ou a qualidade do Tag for alterado, seu valor repassado para o Driver de Comunicao.
A verificao do tempo de ciclo de cada varivel feita de forma sequencial. Caso o ciclo de uma varivel esteja
vencido, o IOServer prossegue com o questionamento de seu valor, passando para a prxima varivel at que a
verificao de toda a planilha esteja completa, para ento retornar ao topo para uma nova varredura.
Pode-se reservar um tempo de ciclo menor para as variveis com necessidade de atualizao mais veloz, e um tempo
de ciclo maior para as variveis sem tanta prioridade de atualizao. Deve-se ressaltar, entretanto, que a performance
da comunicao depende de uma srie de fatores, incluindo o tipo de equipamento, o tipo de interface da
comunicao utilizada, velocidade (baud rate), taxa de erros, etc.
Sempre que o E3 enviar uma solicitao de atribuio de valores para uma ou mais variveis, esta solicitao
executada com prioridade em relao varredura dos Tags.
No caso de falha de um IOServer, o E3 automaticamente realiza uma reinicializao daquele mdulo, de forma a
normalizar seu funcionamento. Por outro lado, o IOServer interrompe seu funcionamento caso no exista nenhum E3
Runtime (Principal ou Standby) para receber seu dados.
Atravs da propriedade ShareServer, possvel compartilhar o mesmo IOServer entre vrios Drivers de Comunicao.
O primeiro Driver a ser executado o responsvel por iniciar os procedimentos de comunicao, como abrir uma
porta serial ou iniciar uma interface de comunicao. Os prximos Drivers de Comunicao compartilhados utilizam o
mesmo IOServer aberto pelo primeiro, o que permite o compartilhamento das interfaces de comunicao utilizadas
pelo Driver.
Isto pode ser vantajoso, j que muitos dos dispositivos de comunicao como modems, portas seriais e outras
interfaces, permitem apenas uma conexo, o que impediria a utilizao simultnea por mais de um Driver. Com o
compartilhamento pode-se reutilizar a mesma conexo para mais de um objeto. Deve-se ressaltar que as
configuraes dos Drivers compartilhados devem ser as mesmas para que o compartilhamento de Drivers funcione
corretamente.
Quando o Domnio est em execuo, tem-se acesso interface de execuo do Driver de Comunicao, denominada
Gerenciador de Drivers.
Drivers 105
Gerenciador de Drivers
As opes disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na janela Gerenciador de Drivers
OPO DESCRIO
Nome Informa o nome do Driver
106 Drivers
De posse da estampa de tempo, o E3 utiliza esta informao tanto para a verificao e gravao de alarmes quanto
para a gerao de arquivos histricos.
No caso dos Tags serem Elementos de Bloco, informada a mesma estampa de tempo para todos os Elementos do
Bloco, j que foram consultados no mesmo instante de tempo. No caso do Driver suportar leituras de variveis tanto
como Bloco quanto como Tag de Comunicao, caso os Elementos possam representar eventos distintos, deve-se
preferir o uso de Tags de Comunicao.
Para obter mais informaes sobre quais equipamentos possuem esta caracterstica, entre em contato com o
fabricante. Para saber quais Drivers ou tipos de variveis dentro dos equipamentos utilizam a estampa de tempo,
consulte a ajuda dos Drivers ou diretamente o suporte tcnico da Elipse Software.
Drivers 107
O tempo de varredura ou scan de Tags reportados por eventos geralmente pode ser configurado com um valor bem
baixo, pois o consumo de CPU, caso no existam valores a retornar, geralmente desprezvel.
A propriedade TimeStamp destes Tags em geral contm um valor fornecido pelo prprio equipamento.
NOTA
Os Tags reportados por eventos devem ser configurados com a propriedade EnableDeadband desabilitada. Isto
evita que eventos com valores muito prximos sejam desprezados pela aplicao.
Desta forma, garante-se que cada valor reportado a evento que chegar seja gravado sequencialmente no Histrico
associado.
108 Drivers
DRIVERS POR PROCESSO NMERO MXIMO DE PROCESSOS COMPORTAMENTO DO POOL
N M medida que os Drivers do aplicativo
forem ativados, o E3 os adiciona a um
processo IOServer do Pool que ainda
no tenha atingido o nmero mximo
N de Drivers executando dentro dele.
Se todos os processos do Pool
estiverem no limite mximo, o
comportamento depende da
quantidade de processos no Pool, e se
o nmero de processos do Pool for
menor que o mximo M, ento um
novo processo adicionado ao Pool,
caso contrrio o Driver adicionado
no processo que tiver menos Drivers
executando. NOTA: Neste modo, o
nmero mximo de Drivers por
processo (N) pode ser ultrapassado
caso o nmero total de Drivers do
aplicativo exceda N * M
NOTAS
Ao agrupar Drivers em um mesmo processo IOServer, perde-se o isolamento entre estes Drivers. Desta forma, se
ocorrer uma falha em um destes Drivers, o IOServer fechado e todos os Drivers que executavam naquele
IOServer tm que ser reiniciados.
Existe um limite no nmero de Drivers que podem executar em um processo IOServer. Este limite depende de
diversas variveis, tais como o sistema operacional em uso, a quantidade de memria, threads e recursos que cada
Driver especfico est ocupando. Em linhas gerais, no se deve adicionar mais do que 100 Drivers em um nico
IOServer, sob pena de exceder os limites do sistema operacional.
Drivers 109
Inserindo uma nova Pasta
110 Drivers
Inserindo um Tag de Comunicao
2. A janela da figura a seguir mostrada, perguntando quantos Tags devem ser criados no Driver, e qual seu nome.
Este nome auto-incrementado e, se a opo for deixada em branco, os Tags so criados com o nome padro.
Drivers 111
Comunicao so configurados atravs de uma srie de parmetros B (B1 a B4) que variam de acordo com o Driver
de Comunicao a ser utilizado, alm da propriedade Size, que define o nmero de Elementos ou ndices disponveis
no Bloco. Para utilizar este recurso, siga estes procedimentos:
1. Clique com o boto direito do mouse no Driver e selecione a opo Inserir - Bloco de Comunicao.
Inserindo Blocos de
Comunicao
3. A caixa de dilogo da figura a seguir mostrada, para determinar o nmero de Elementos de Bloco neste objeto.
Nesta opo possvel indicar o mapeamento de todos os Elementos de Bloco ou somente em um determinado
intervalo de Elementos.
112 Drivers
Configurando o Bloco de Comunicao
4. Informe o tamanho do Bloco e a opo de mapeamento.
5. Clique em OK.
6. Caso necessite, configure as propriedades do objeto.
Algumas das propriedades do Bloco de Comunicao podem ser configuradas atravs da Lista de Propriedades, sem
a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia e Scripts do
E3.
Drivers 113
Inserindo um Elemento de Bloco de Comunicao
Caso o equipamento sendo utilizado para coletar os dados informe valores de Elementos que precisam ser
convertidos, pode-se utilizar as escalas dos Elementos, que so basicamente uma especificao de uma converso
linear entre duas bases diferentes.
Para isto, deve-se habilitar a propriedade EnableScaling do Elemento e informar os parmetros DeviceLow e
DeviceHigh (atravs das respectivas propriedades), que so os limites inferior e superior do dado vindo do
equipamento, alm dos parmetros EULow e EUHigh (atravs das respectivas propriedades) que so os limites inferior
e superior do dado j em unidades de engenharia.
Algumas das propriedades do Elemento de Bloco podem ser configuradas atravs da Lista de Propriedades, sem a
necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia e Scripts do
E3.
NOTA
O Servidor OPC no E3 um mdulo adicional a partir da verso 3.0, e necessita de licena especfica no dispositivo
de proteo. Entre em contato com a Elipse Software para maiores informaes.
4.2.1 Caractersticas
Para usar o Servidor OPC do E3 no necessria nenhuma configurao extra, bastando executar o Domnio para que
qualquer cliente OPC possa se comunicar com o E3. Para conectar-se ao servidor OPC do E3 de um cliente qualquer,
basta selecionar o servidor identificado como Elipse.OPCSvr.1.
114 Drivers
O Servidor OPC permite que qualquer cliente importe facilmente toda a definio de Tags existentes no Domnio
(funo Browse). Naturalmente, os Tags fornecidos so apenas os objetos que fazem parte do servidor, ou seja, itens
de Tela (Viewer) no so acessveis pelo Servidor OPC.
Sendo baseado na mesma tecnologia de associaes usada nas associaes internas entre objetos, o Servidor OPC
do E3 permite que clientes usem Tags que sejam expresses matemticas, e com o recurso de conexo e desconexo
transparente durante a execuo.
4.2.3 Desconexo
Para os clientes OPC que suportam o mecanismo de desligamento (shutdown), sempre enviado um aviso quando o
Domnio parado ou entra em modo Standby. Aps o aviso, todos os clientes so desconectados.
Drivers 115
Editor do Driver de Comunicao OPC
As opes disponveis neste Editor esto descritas na tabela a seguir.
Opes disponveis no Editor do Driver OPC
CONE OPO DESCRIO
Adicionar Adiciona um Grupo ao Driver, um
Tag, um Bloco ou uma Pasta ao
Grupo, ou um Elemento ao Bloco
Remover Remove o item selecionado no Editor
4.3.1 Configurao
A identificao dos outros objetos pertencentes ao Driver OPC pode ser inserida manualmente, ou ento ser trazida
automaticamente do Servidor OPC. Para isto, abra a janela de propriedades do Driver, clicando com o boto direito
do mouse no objeto e selecionando a aba OPC Driver.
Tentar apenas enumerador padro (servio OPCENUM) O E3 tenta procurar as especificaes do Driver apenas
pelo enumerador padro OPC (OPCENUM)
Clicando em OK, o sistema mostra os dados do Driver, indicando os caminhos e o nome do servidor. Para ativar a
comunicao do Driver OPC, clique em Ativar Comunicao.
Drivers 117
Ativar comunicao do Driver OPC
Quando a comunicao ativada, so habilitadas as opes Informaes sobre o servidor e Importar tags, alm da
opo Desativar Comunicao. Para utilizar estas opes, clique com o boto direito do mouse no Driver OPC e
selecione a opo desejada.
118 Drivers
Opes habilitadas quando o Driver OPC est ativo
A opo Informaes sobre o servidor mostra uma janela com as configuraes do Driver.
Drivers 119
Mensagem referente importao de Tags OPC
As opes disponveis nesta caixa de dilogo so as seguintes:
Sim: O E3, ao executar a localizao dos Tags OPC, tenta automaticamente detectar quais Tags so do tipo Bloco
e, neste caso, qual o nmero de Elementos. Para isto, o E3 precisa ler o valor de cada um, o que dependendo do
servidor e do nmero de Tags, pode ser demorado
No: O E3 no l os valores dos Tags OPC ao realizar a operao de busca. Esta operao mais rpida, porm
no cria automaticamente Tags OPC de tipo Bloco e seus Elementos
Cancelar: Cancela a importao
120 Drivers
OPO DESCRIO
Tipo de acesso Filtra os Tags a partir do tipo de acesso especificado no
campo, que pode ser Leitura, Escrita ou Leitura e
Escrita
Mostrar apenas itens com IDs no encontrados no Filtra os Tags para que a aplicao mostre apenas os
projeto itens com IDs no encontrados no projeto
Para executar a importao, selecione o Tag desejado e arraste-o para o Driver ou Grupo OPC desejado. Para
desativar a comunicao do Driver OPC, clique em Desativar Comunicao.
Algumas das propriedades do Driver OPC podem ser configuradas atravs da Lista de Propriedades, sem a
necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia e Scripts do
E3.
4.3.1.1 Funcionamento
A comunicao do cliente OPC do E3 com um servidor OPC feita por um processo separado. Este processo, quando
o Driver OPC ativado pelo Studio, executa na conta do usurio atual do Windows. Em tempo de execuo, por outro
lado, este processo executado na conta SYSTEM. Alguns servidores OPC podem ser sensveis conta em que esto
executando e, por este motivo, pode ser necessrio reconfigurar o processo para que seja executado por um usurio
especfico. Para isto, siga estes procedimentos:
1. V ao menu Iniciar - Painel de Controle - Ferramentas Administrativas - Servios de Componente (Start -
Control Panel - Administrative Tools - Component Services), ou digite dcomcnfg no prompt de comando do
Windows.
2. Expanda o item Config DCOM (DCOM Config) em Servios de componente - Computadores - Meu computador
(Component Services - Computers - My Computer), clique com o boto direito do mouse no item E3OpcClient e
selecione a opo Propriedades (Properties).
3. Selecione a aba Identidade (Identity), selecione o item Este usurio (This user) e preencha as informaes da
conta.
4. Clique em OK e reinicie o computador para que as modificaes sejam aplicadas.
Drivers 121
Inserindo um Grupo de Tags OPC
Algumas das propriedades do Grupo de Tags OPC podem ser configuradas atravs da Lista de Propriedades, sem a
necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia e Scripts do
E3.
122 Drivers
Inserindo uma Pasta OPC
Drivers 123
Inserindo um Tag de Comunicao OPC
2. Abre-se uma janela perguntando quantos Tags devem ser criados no Grupo, e qual seu nome. Este nome
autoincrementado e, se esta opo for deixada em branco, os Tags so criados com o nome padro.
124 Drivers
Inserindo um Bloco de Comunicao OPC
2. Abre-se uma janela perguntando quantos Blocos devem ser criados no Grupo, e qual seu nome. Este nome
autoincrementado e, se esta opo for deixada em branco, os Blocos so criados com o nome padro.
Inserindo Blocos de
Comunicao OPC
3. mostrada uma caixa de dilogo para determinar o nmero de Elementos de Bloco neste objeto. Nesta opo
possvel indicar o mapeamento de todos os Elementos de Bloco ou somente de um determinado intervalo de
Elementos.
Drivers 125
Configurando o Bloco de Comunicao
4. Informe o tamanho do Bloco e a opo de mapeamento.
5. Clique em OK.
6. Caso necessite, configure as propriedades do objeto.
Algumas das propriedades do Bloco de Comunicao OPC podem ser configuradas atravs da Lista de Propriedades,
sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia e Scripts do
E3.
Tabela 5 12 77 55 1 3 42 20 8 89
ndice 0 1 2 3 4 5 6 7 8 9
NOTA
O E3 pode criar automaticamente os Elementos de Bloco OPC. Para maiores detalhes, veja a opo Importar Tags,
no tpico Configurao.
126 Drivers
Inserindo um Elemento de Bloco OPC
Algumas das propriedades do Elemento de Bloco OPC podem ser configuradas atravs da Lista de Propriedades, sem
a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia e Scripts do
E3.
Drivers 127
Inserindo um Driver de Comunicao OPC UA em modo Domnio
Algumas das propriedades do Driver de Comunicao OPC UA podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a
na Lista de Propriedades e execute os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia e
Scripts do E3.
4.4.1 Configurao
A configurao do objeto Driver de Comunicao OPC UA semelhante configurao do Driver de Comunicao
OPC. Para configur-lo, clique com o boto direito do mouse no objeto e selecione o item Selecionar servidor.
128 Drivers
Opo Selecionar servidor
A janela a seguir mostrada, permitindo selecionar um servidor OPC UA na mquina local ou na rede.
Drivers 129
Para cada servidor OPC UA, tanto locais quanto em rede, so enumerados os pontos de conexo (endpoints), que
podem utilizar diferentes protocolos e modos de segurana. Alm disto, para cada ponto de conexo o servidor
tambm pode suportar diferentes formas de identificao e autenticao de usurios.
Atualmente, o E3 permite a conexo apenas pelo modo TCP Binrio. Para este modo, o E3 suporta os modos de
segurana definidos pelo padro OPC UA, em diversas combinaes de polticas de segurana. Para a autenticao, o
E3 suporta apenas os modos Annimo e Usurio e Senha.
NOTA
A janela Servidores OPC UA lista todos os protocolos e modos de segurana, para informao do usurio.
Entretanto, somente os modos compatveis com o E3 podem ser selecionados.
130 Drivers
Inserindo uma Assinatura OPC UA
Algumas das propriedades do objeto Assinatura OPC UA podem ser configuradas atravs da Lista de Propriedades,
sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia e Scripts do
E3.
Drivers 131
Inserindo uma Pasta OPC UA
132 Drivers
Inserindo um Tag de Comunicao OPC UA
2. Abre-se uma janela perguntando quantos Tags devem ser criados na Assinatura, e qual seu nome. Este nome
autoincrementado e, se esta opo deixada em branco, os Tags so criados com o nome padro.
Configurando a quantidade de
Tags
Algumas das propriedades do Tag OPC UA podem ser configuradas atravs da Lista de Propriedades, sem a
necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia e Scripts do
E3.
Drivers 133
NOTA
Na verso atual, o E3 s permite que vetores de uma dimenso (arrays) sejam mapeados para Blocos de
Comunicao, embora o padro OPC UA suporte matrizes n-dimensionais como tipos de dados.
Configurando a quantidade de
Blocos
3. Abre-se uma caixa de dilogo para determinar o nmero de Elementos de Bloco neste objeto. Nesta opo
possvel indicar o mapeamento de todos os Elementos de Bloco ou somente de um determinado intervalo de
Elementos.
134 Drivers
Configurando o Bloco de Comunicao OPC
UA
4. Informe o tamanho do Bloco e a opo de mapeamento.
5. Clique em OK.
6. Caso necessite, configure as propriedades do objeto.
Algumas das propriedades do Bloco de Comunicao OPC UA podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a
na Lista de Propriedades e execute os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia e
Scripts do E3.
Drivers 135
Inserindo um Elemento de Bloco OPC UA
Algumas das propriedades do Elemento de Bloco OPC UA podem ser configuradas atravs da Lista de Propriedades,
sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia e Scripts do
E3.
136 Drivers
Aba Campos
As opes disponveis na aba Campos esto descritas na tabela a seguir.
Opes disponveis na aba Campos
OPO DESCRIO
Dados Brutos A Consulta retorna os dados como so armazenados no
servidor, semelhante consulta
CompressedDataStartEndTime do objeto Storage.
Neste modo, apenas um Tag pode ser consultado por
vez, retornando tambm a qualidade do valor
Dados Processados A Consulta retorna dados agregados dentro de um
intervalo de tempo, semelhante s consultas
SampledData e CalculatedData do objeto Storage.
Neste modo, vrios Tags podem ser consultados por
vez, mas no retornam a qualidade do valor. Diversas
funes de agregao podem ser utilizadas, como por
exemplo mdias, mximos, interpolaes, etc. Funes
diferentes podem ser usadas para cada Tag e um
mesmo Tag pode aparecer vrias vezes na Consulta,
com funes de agregao diferentes. O E3 apenas lista
as funes padro, sem buscar funes especficas do
servidor ou filtrar funes no suportadas pelo servidor.
A Consulta pode falhar caso seja selecionada uma
funo no suportada pelo servidor OPC UA
Adiciona um ou mais Tags do servidor OPC UA
Remove o Tag selecionado da Consulta
Fora a atualizao dos Identificadores de Ns OPC UA
(NodeIds)
Drivers 137
OPO DESCRIO
Id Tipo de Identificador de N OPC UA (NodeId) no
servidor
Colunas Caminho do Tag no servidor OPC UA
4.4.8 Certificados
Durante a instalao do E3, instalado um certificado relativo instncia do cliente OPC UA do E3. Este certificado
necessrio sempre que for utilizada uma conexo com o servidor cujo modo de segurana (propriedade
SecurityMode) no seja igual a None (ou seja, uma conexo OPC UA segura).
Este certificado pode ser encontrado na pasta CertificateStore/certs da instalao do E3, em um arquivo chamado
Elipse E3 UA Client [xxx].der, onde xxx um cdigo gerado aleatoriamente.
Se este certificado apagado, um novo gerado automaticamente sempre que o Driver OPC UA tentar estabelecer
uma conexo com um servidor.
NOTAS
Apagar o certificado pode significar ter que atualizar os servidores OPC UA com o novo certificado, ou ento a
conexo segura com o cliente do E3 pode ser negada.
Este certificado corresponde instncia do cliente, e no ao cliente OPC UA do E3, ou seja, ele NO pode ser
copiado de uma mquina para outra. Cada instalao tem um certificado nico.
O cliente OPC UA do E3 aceita qualquer certificado vlido de servidor, ou seja, no necessria nenhuma
configurao para que o cliente do E3 aceite uma determinada instncia de servidor OPC UA.
138 Drivers
Tipos suportados plenamente: SByte, Byte, Int16, UInt16, Int32, UInt32, Int64, UInt64, Float, Double, Boolean,
String, DateTime e ByteString
Tipos suportados com limitaes: DataValue (ignora a estampa de tempo e a qualidade), LocalizedText
(ignora a configurao regional), QualifiedName (ignora o NamespaceIndex), StatusCode (convertido para SCode
ou HRESULT), Guid (convertido para texto), ArrayQualifiedName, ArrayLocalizedText, Structure,
ArrayStructure, ArrayDataValue, Unknown e ArrayUnknown (no permitem a escrita na verso atual do E3)
Tipos suportados convertidos para vetores de uma dimenso de tamanho fixo: Estes tipos de dados so
retornados como vetores de Variants, em que cada um dos campos um item do vetor. Se o campo for outro
objeto, o Variant contm outro vetor, e assim por diante. Os tipos suportados so
ServerDiagnosticsSummaryDataType, SubscriptionDiagnosticsDataType,
SessionSecurityDiagnosticsDataType, SessionDiagnosticsDataType, ApplicationDescription, Argument,
BuildInfo, ServiceCounterDataType, ExpandedNodeId, NodeId, ServerStatusDataType, EUInformation, Range,
TimeZoneDataType, StatusResult, ComplexNumberType, DoubleComplexNumberType, XVType,
RedundantServerDataType, SamplingIntervalDiagnosticsDataType, EnumValueType, NetworkGroupDataType
e EndpointUrlListDataType
NOTA
Estruturas definidas por servidores especficos, no compatveis com o padro OPC UA, no so lidas pelo E3.
Nos campos da consulta, o texto dos caminhos dos Tags do servidor segue o padro OPC UA de caminhos relativos.
Os componentes deste caminho so os seguintes:
/ (barra): Indica uma referncia hierrquica qualquer
. (ponto): Indica uma referncia de agregao qualquer
[ns:]browse-name: A String que segue uma barra ou ponto especifica o nome de browse de um item. Este nome
pode ser prefixado com seu ndice de Namespace. Se for omitido, assumido o ndice 0 (zero)
& (e comercial, caractere de escape): Insere um caractere reservado no local. Por exemplo, a expresso "&/
Nome" substituda por "/Nome". Os caracteres reservados so os seguintes:
/ (barra)
. (ponto)
< (menor que)
> (maior que)
: (dois pontos)
# (sinal numrico)
! (ponto de exclamao)
& (e comercial)
O E3 no suporta Identificadores de Ns OPC UA (NodeIds) que no sejam do servidor onde executado o browse
dos Tags (servidores Gateway). Estes Tags, portanto, no so mostrados na janela de seleo de servidores. Alm
disto, os caminhos so sempre hierrquicos e apenas os tipos de referncia barra (/) e ponto (.) so suportados (o
tipo <browse-name> no suportado).
Drivers 139
4.5 Qualidade
Os campos de qualidade representam o estado da qualidade do valor do item. formado de uma palavra de 16 bits,
sendo que os primeiros oito bits so definidos na forma de trs campos de bits: Qualidade, Substatus e Limite.
Os outros oito bits (de maior ordem) esto disponveis para uso de cada fabricante. Se estes bits forem utilizados, os
bits de qualidade padro ainda so utilizados para indicar quais dedues pode-se fazer sobre os dados retornados.
Assim, de responsabilidade do cliente interpretar o campo de informaes especficas de qualidade, para garantir
que o servidor que est provendo esta informao usa as mesmas regras do cliente.
Opes disponveis no campo Qualidade
QUALIDADE CAMPO QUALIDADE DESCRIO
0 - 63 Ruim O valor no til pelas razes
indicadas no campo Substatus
Um servidor que no suporta informao de qualidade retorna 192 (Bom) sempre. Tambm aceitvel que um
servidor retorne simplesmente 0 ou 192 (Ruim ou Bom) e sempre retorne 0 (zero) para o Substatus e para o Limite.
Erro de H algum 4 5 6 7
Configurao problema de
configurao
especfico no
servidor. Por
exemplo, o item
em questo pode
ter sido apagado
No Conectado A entrada deveria 8 9 10 11
estar logicamente
conectada a algo,
mas no est. Esta
qualidade pode
refletir que no h
valor disponvel
neste momento,
pois o valor pode
no ter sido
fornecido pela
fonte de dados
Falha de Uma falha de 12 13 14 15
Dispositivo dispositivo foi
detectada
140 Drivers
SUBSTATUS DESCRIO LIMITE
SEM LIMITE BAIXO ALTO CONSTANTE
Falha de Sensor Uma falha de 16 17 18 19
sensor foi
detectada (o
campo Limite
pode conter
informao
adicional)
ltimo valor Comunicao em 20 21 22 23
conhecido falha. Entretanto, o
ltimo valor
conhecido est
disponvel. Note
que a idade do
valor pode ser
determinada pela
propriedade
TimeStamp
Falha de A comunicao 24 25 26 27
Comunicao falhou. No h
ltimo valor
conhecido
disponvel
Fora de Servio O Bloco est fora 28 29 30 31
de scan ou
trancado
N/A No utilizado 32 - 63
Drivers 141
SUBSTATUS DESCRIO LIMITE
SEM LIMITE BAIXO ALTO CONSTANTE
ltimo valor O dispositivo que 68 69 70 71
utilizvel estava
providenciando o
valor parou de
faz-lo. O valor
retornado deve
ser considerado
velho. Note que
isto difere de um
valor Ruim com o
Substatus 5
(ltimo valor
conhecido).
Aquele estado
associado com
uma falha
detectvel de
comunicao em
um valor buscado.
Este erro
associado com a
falha de alguma
fonte externa que
iria inserir algo no
valor dentro de
um perodo
aceitvel. Note
que a idade do
valor pode ser
determinada na
propriedade
TimeStamp
No utilizado No utilizado 72 - 79
142 Drivers
SUBSTATUS DESCRIO LIMITE
SEM LIMITE BAIXO ALTO CONSTANTE
Unidade de O valor retornado 84 85 86 87
engenharia est fora dos
excedida limites definidos
para este
parmetro. Note
que neste caso o
valor do campo
Limite indica
quais limites
foram excedidos,
mas no
necessariamente
implica que o
valor no possa ir
mais alm da faixa
especificada
Subnormal O valor derivado 88 89 90 91
de mltiplas
fontes e h um
nmero menor do
que o requerido
de fontes boas
No utilizado No utilizado 92 - 127
NOTA
Servidores que no suportam o Substatus devem retornar 0 (zero).
NOTA
Servidores que no suportam o Substatus devem retornar 0 (zero).
Drivers 143
ESPECIFICAO DESCRIO
Limite Inferior O valor est limitado em algum valor inferior
NOTA
Servidores que no suportam o campo Limite devem retornar 0 (zero).
144 Drivers
CAPTULO
Quadros
5
O objeto Quadro utilizado para organizar e estruturar a interface do projeto, criando visualizaes compostas para
o usurio dentro da janela principal do Viewer ou do navegador. Muitas vezes, uma aplicao requer apenas uma Tela
principal, que a porta de entrada para a aplicao. A partir da, o usurio pode navegar por outras Telas, que
ocupam o lugar da primeira, formando uma nica visualizao do processo. Porm, possvel suportar mais de uma
visualizao em um mesmo documento ou projeto. Isto se torna til no caso de uma aplicao que utilize uma Tela
que nunca muda, ou que muda pouco (como, por exemplo, um menu), e outra parte que a navegao das Telas
propriamente ditas. Para utilizar este recurso, execute os procedimentos a seguir.
1. Clique com o boto direito do mouse no nome do projeto no modo Explorer e selecione a opo Inserir -
Quadro. No modo Domnio, clique com o boto direito do mouse no item Visualizao - Viewer e Quadros,
selecione a opo Inserir Quadro em e logo aps o nome do projeto desejado.
Quadros 145
CONE DESCRIO
dockRemaining: Este Divisor ocupa o espao restante
aps o posicionamento de seu Divisor Irmo
Cada Divisor corresponde visualizao de uma Tela ou Quadro de seu processo ou a uma URL (Uniform Resource
Locator). Para utilizar este recurso, execute os procedimentos a seguir.
1. Clique com o boto direito do mouse no Quadro aberto e selecione uma das opes: Dividir Horizontalmente
ou Dividir Verticalmente, conforme o tipo de Diviso desejada.
146 Quadros
Divisores do Quadro
6. Para configurar os Divisores do Quadro, clique com o boto direito do mouse no Divisor desejado no Organizer e
selecione a opo Propriedades.
Configuraes do Quadro
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Quadro
OPO DESCRIO
Tela ou Quadro Determina o caminho da Tela ou Quadro que o Divisor
abre. S habilitado se o Divisor no tiver nenhum filho.
Este campo equivale propriedade SplitLink
Posicionamento Determina a posio do Divisor no Quadro. Este campo
equivale propriedade SplitDockPosition
Quadros 147
OPO DESCRIO
Valor Determina o valor que atribudo ao Quadro. S tem
efeito visual se for modificada no Divisor Principal. Este
campo equivale propriedade SplitValue
NOTAS
Todas as opes do Quadro que esto disponveis via menu contextual (atravs do clique com o boto direito do
mouse) tambm esto disponveis utilizando a combinao de teclas SHIFT + F10, que corresponde tecla de
aplicao ou de menu .
A janela de propriedades de um Quadro pode ser aberta utilizando as combinaes de teclas ALT + ENTER, CTRL
+ ALT + ENTER ou ALT + duplo-clique do mouse.
Algumas das propriedades do Quadro ou Divisor podem ser configuradas atravs da Lista de Propriedades, sem a
necessidade da criao de scripts para isto. Caso haja a necessidade de configurar alguma propriedade, localize-a na
Lista de Propriedades e faa os devidos ajustes. Para maiores informaes, consulte o Manual de Referncia e
Scripts do E3.
148 Quadros
CAPTULO
Viewer
6
O objeto Viewer disponibiliza a visualizao da aplicao. Permite visualizar Telas do projeto em modo de execuo e
a operao do sistema. O Viewer pode ser executado a partir de qualquer ponto da rede que tenha acesso ao E3
Server. No necessrio copiar o aplicativo para os outros Viewers, pois as Telas e bitmaps so baixados conforme a
necessidade em tempo de execuo. S pode existir um objeto Viewer em um Domnio.
NOTA
A qualidade grfica das Telas pode ser modificada, em tempo de execuo, utilizando-se o menu contextual do
Viewer e selecionando uma das opes do menu Qualidade (todas as telas). Para maiores informaes, veja a
propriedade RenderQuality do Viewer no Manual de Referncia e Scripts do E3.
6.1 Configurao
Atravs da janela de propriedades do Viewer, possvel especificar configuraes do Viewer, Erros de comunicao,
criar associaes ou scripts.
NOTA
A janela de propriedades do Viewer pode ser aberta utilizando as combinaes de teclas ALT + ENTER, CTRL + ALT
+ ENTER ou ALT + duplo-clique do mouse.
Viewer 149
Aba Visualizador
Cada campo da aba Visualizador possui uma propriedade correspondente. As opes disponveis nesta aba esto
descritas na tabela a seguir.
Opes disponveis na aba Visualizador
OPO DESCRIO
Ttulo Determina o ttulo do Viewer. Este campo equivale
propriedade Caption do objeto Viewer
Tela ou Quadro Inicial Determina a Tela ou Quadro que o Viewer inicia. Clicando
em , o Studio abre uma janela de configurao, pela
qual abre o AppBrowser, onde especificada a Tela inicial
de visualizao. Este campo equivale propriedade
InitialScreen do objeto Viewer
Exibir o menu do Zoom ao clicar com o boto direito Habilita a exibio do menu Zoom com o boto direito
do mouse do mouse, em tempo de execuo. Este campo equivale
propriedade EnableZoomMenu do objeto Viewer
Manter Telas carregadas na memria Habilita o Viewer a manter as Telas carregadas em
memria. Este campo equivale propriedade
CacheEnable do objeto Viewer
Verificar inatividade aps ... minutos Define o tempo mximo de espera, em minutos, por um
evento de mouse ou de teclado para o perodo de
inatividade. Este campo equivale propriedade
EnableInactivity do objeto Viewer
150 Viewer
OPO DESCRIO
Nmero de retentativas para confirmao de usurio Estabelece o nmero de vezes que a caixa de dilogo de
ou senha login exibida alm da primeira vez. Este campo equivale
propriedade LoginRetries do objeto Viewer
Aba Configurao
Cada campo da aba Configurao possui uma propriedade correspondente. As opes disponveis nesta aba esto
descritas na tabela a seguir.
Opes disponveis na aba Configurao
OPO DESCRIO
Iniciar Maximizada / Minimizada / Janelada Determina o estilo da janela do Viewer. Este campo
equivale propriedade WindowStyle e possui as
seguintes opes:
0 - Maximized: A Tela inicia maximizada
1 - Windowed: Estilo janelada, isto , pode ser
configurada a altura e a largura da Tela
2 - Minimized: A Tela inicia minimizada
Desabilitar troca de janelas Desabilita a troca de janelas. Este campo equivale
propriedade DisableTaskSwitching do objeto Viewer.
Esta opo pode ser modificada em tempo de execuo
usando o mtodo SetDisableTaskSwitching
Barra de ttulo Habilita a barra de ttulo. Este campo equivale
propriedade TitleBar do objeto Viewer
Viewer 151
OPO DESCRIO
Boto de fechar Habilita o boto de fechar. Este campo equivale
propriedade CloseButton do objeto Viewer
Boto de minimizar Habilita o boto de minimizar. Este campo equivale
propriedade MinimizeButton do objeto Viewer
Boto de maximizar Habilita o boto de maximizar. Este campo equivale
propriedade MaximizeButton do objeto Viewer
Borda Habilita uma borda na janela do Viewer. Este campo
equivale propriedade WindowBorder do objeto Viewer
Opo de redimensionar Indica se a janela pode ser redimensionada. Esta opo s
tem validade se a opo Borda estiver marcada. Este
campo equivale propriedade WindowResizable do
objeto Viewer
Opo de mover Indica se a janela pode ser movida. Este campo equivale
propriedade WindowMovable do objeto Viewer
Configuraes avanadas
As opes disponveis nesta janela esto descritas na tabela a seguir.
152 Viewer
Opes disponveis na janela Configuraes avanadas
OPO DESCRIO
Resoluo da Tela em pixels Permite escolher entre a resoluo atual do computador
ou uma resoluo escolhida pelo usurio, em pixels
Desconto na resoluo da Tela em pixels Permite escolher o desconto aplicado na resoluo da
Tela entre a configurao atual do computador ou uma
resoluo escolhida pelo usurio, em pixels
Resoluo do monitor em pontos por polegada (DPI) Permite escolher entre a resoluo atual do computador
ou um resoluo escolhida pelo usurio, em pontos por
polegada (DPI)
Cor de fundo Contm a cor que deve ser usada no Setpoint. Equivale a
uma alterao da propriedade ForegroundColor do
Setpoint, mas esta alterao no executada
efetivamente. O valor da propriedade do Setpoint no
alterado
Viewer 153
O prprio objeto Viewer pode acessar seus filhos (Associaes ou scripts)
importante salientar que a Associao para o Viewer deve levar o nome real do Viewer (por exemplo, "Viewer1") e
no simplesmente "Application". Em scripts, ainda vale o uso de Application, que uma propriedade de todos os
objetos que retornam o Viewer.
Objeto _top
2. Para configurar as propriedades do objeto _top, clique com o boto direito do mouse e selecione a opo
Propriedades.
3. Este objeto possui as mesmas funcionalidades do objeto Divisor do Quadro, e tais informaes podem ser
encontradas nos captulos Telas e Quadros.
154 Viewer
Inserindo Pasta do Viewer
NOTA
Uma aplicao que contenha Pastas do Viewer no pode ser aberta em verses do E3 anteriores verso 3.1.
Viewer 155
CAPTULO
Telas e Objetos de Tela
7
Telas so janelas para monitoramento de processos. Em cada Tela so inseridos objetos que compem a interface
do operador com o sistema, chamados Objetos de Tela. Cada aplicao pode ter um nmero ilimitado de Telas e de
objetos de Tela.
7.1 Tela
A Tela o objeto bsico de interface com o usurio, e pode conter vrios tipos de objetos. Os grficos inseridos na
Tela podem ser apagados, copiados, movidos, redimensionados, agrupados ou configurados.
Para inserir uma Tela no projeto, clique com o boto direito do mouse no nome do projeto no modo Explorer e
selecione a opo Inserir - Tela. No modo Domnio, clique com o boto direito do mouse no item Visualizao -
Telas, selecione a opo Inserir Tela em e logo aps o nome do projeto desejado.
Configurar como Tela inicial do Divisor Habilita a Tela como Tela Inicial do Divisor onde aberta
As opes Largura e Altura esto inicialmente preenchidas com o tamanho que a Tela deve ter para poder ser
exibida no Divisor escolhido, sem que aparea uma barra de rolagem. Se algum dos valores for negativo, isto indica
que o Divisor no est visvel em tempo de execuo, em funo da configurao do Viewer e do tamanho dos outros
Divisores.
O E3 Studio fornece um editor dos objetos que podem ser inseridos em uma Tela. Esto disponveis os seguintes
objetos: Linha, Retngulo, Retngulo Arredondado, Elipse, Arco de Elipse, Desenho Livre, Polgono, Polgono de
Curvas, Figura (Imagem), Texto, Display, SetPoint, Escala e MSForms. Os MSForms so discutidos no captulo ActiveX e
os demais objetos citados so apresentados neste captulo.
Tela
Pode-se configurar as propriedades da Tela para determinar tamanho, cor e outros aspectos do comportamento e da
aparncia, alm de vrios tipos de eventos. Estes objetos utilizam como padro para o tamanho e coordenadas as
unidades Himetric, dadas em 1/100 mm, e no em pixels.
Todas das propriedades da Tela podem ser configuradas atravs da Lista de Propriedades, sem a necessidade de se
criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de Propriedades e faa os
devidos ajustes.
As primitivas do editor grfico disponveis no Studio so listadas nos prximos tpicos. Elas podem ser rotacionadas
ou redimensionadas livremente, exceto pelo objeto Figura. Aps ter sido criado, cada objeto permanece selecionado
para facilitar a edio de suas propriedades, caso seja necessrio.
7.2.2 Conector
Este objeto utilizado para conectar dois ou mais objetos de Tela atravs de uma linha. Os objetos de Tela que
podem ser conectados so o Retngulo, o Retngulo Arredondado, a Elipse, o Arco de Elipse, o Desenho Livre, o
Polgono e o Polgono de Curvas. Ao clicar em na barra de ferramentas Tela, os objetos anteriormente citados
mostram seus pontos de conexo, como na figura a seguir.
Utilizar como "Ponto ncora" do objeto Marca este Ponto de Conexo como o ponto ncora do
objeto. Este ponto ncora pode ser alterado quando o
XControl for inserido em uma Tela. Veja tambm o
tpico Ponto ncora para maiores informaes
Para editar ou excluir um ponto criado, clique com o boto direito do mouse no ponto e selecione a opo Excluir
Ponto de Conexo ou Editar Ponto de Conexo, conforme a figura a seguir. Um ponto de conexo tambm pode
ser excludo clicando-se nele com a tecla CTRL pressionada.
7.2.4 Display
Permite criar um objeto que utilizado para mostrar os valores dos Tags em tempo de execuo. Para utilizar este
objeto, siga estes procedimentos:
7.2.5 Elipse
Permite o desenho de crculos e elipses. Para utilizar este objeto, siga estes procedimentos:
1. Selecione a Elipse na barra de ferramentas Tela.
2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o mouse diagonalmente at o desenho
atingir o tamanho e a posio desejados.
7.2.6 Escala
Permite a criao de um objeto que desenha rguas ou escalas de valores. Para utilizar este objeto, siga estes
procedimentos:
1. Selecione a Escala na barra de ferramentas Tela.
2. Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse diagonalmente at seu vrtice final.
7.2.7 Figura
Permite mostrar imagens que estejam armazenadas em arquivos, que podem ou no pertencer aplicao. A Figura
pode ser redimensionada livremente, porm a rotao e a animao s so efetivas quando esta for um metafile
convertido para smbolo. Os seguintes formatos de arquivo so suportados: Bitmap (.bmp), Graphics Interchange
Format (.gif), Joint Photographic Experts Group (.jpg), ICO File Format (.ico), Windows Metafile (.wmf), Enhanced Metafile
(.emf), Portable Network Graphics (.png) e Tagged Image File Format (.tif). Para utilizar este objeto, siga estes
procedimentos:
1. Selecione a Figura na barra de ferramentas Tela.
2. Clique na Tela para criar o vrtice de origem do retngulo e arraste o mouse diagonalmente at seu vrtice final.
3. O Studio abre uma caixa de dilogo para seleo do arquivo de imagem, conforme a figura a seguir.
7.2.9 Polgono
Permite o desenho de polgonos com lados retos. Para utilizar este objeto, siga estes procedimentos:
1. Selecione o Polgono na barra de ferramentas Tela.
2. Clique na Tela para estabelecer o vrtice inicial do desenho e arraste o mouse em qualquer direo tantas vezes
quantas forem necessrias para completar o desenho desejado.
3. Quando desejar trocar a direo do desenho, clique uma vez com o mouse. Quando desejar finaliz-lo, clique
duas vezes com o mouse.
7.2.11 Retngulo
Permite o desenho de retngulos, criados a partir de dois vrtices. Para utilizar este objeto, siga estes procedimentos:
1. Selecione o Retngulo na barra de ferramentas Tela.
2. Clique na Tela para criar o vrtice de origem do Retngulo e arraste o mouse diagonalmente at seu vrtice final,
at o desenho atingir o tamanho e a posio desejados.
7.2.13 SetPoint
Permite criar um objeto que funciona como uma caixa de edio onde so inseridos contedos a serem atribudos a
Tags associados. Para utilizar este objeto, siga estes procedimentos:
1. Selecione o SetPoint na barra de ferramentas Tela.
2. Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse diagonalmente at seu vrtice final.
3. Clique com o boto direito do mouse no objeto para abrir a Janela de Propriedades. Na aba Item, selecione o
Tag a ser associado propriedade Value do SetPoint.
7.2.14 Texto
Permite a criao de um texto a ser exibido na Tela. Para utilizar este objeto, siga estes procedimentos:
1. Selecione o Texto na barra de ferramentas Tela.
2. Digite o texto desejado e pressione a tecla ENTER.
3. Caso queira alterar ou digitar contedos neste objeto, utilize a propriedade Value.
NOTA
Todas as opes da Tela e dos objetos de Tela que esto disponveis via menu contextual (atravs do clique com
o boto direito do mouse) tambm esto disponveis utilizando a combinao de teclas SHIFT + F10, que
corresponde tecla de aplicao ou de menu .
A janela de propriedades da Tela e dos objetos de Tela pode ser aberta utilizando as combinaes de teclas ALT
+ ENTER, CTRL + ALT + ENTER ou ALT + duplo-clique do mouse.
NOTA
possvel ajustar os objetos dentro de um grupo ao pixel mais prximo (efeito Snap to Pixel), utilizando-se a
combinao de teclas CTRL + BARRA DE ESPAO. Neste caso, o efeito aplicado a cada um dos objetos dentro
do grupo, podendo ser desfeito utilizando-se a combinao de teclas CTRL + Z.
Para sair do modo de edio de um grupo de objetos de Tela, clique duas vezes na rea da Tela fora do grupo.
7.3.2 Alinhamento
Permite alinhar os objetos de Tela entre si ou em relao Tela. As opes de alinhamento disponveis esto descritas
na tabela a seguir.
Opes de alinhamento para objetos de Tela
CONE OPO DESCRIO
Alinhar Esquerda Alinha dois ou mais objetos entre si,
tendo como referncia a coordenada
esquerda do ltimo objeto
selecionado
Alinhar Direita Alinha dois ou mais objetos entre si,
tendo como referncia a coordenada
direita do ltimo objeto
selecionado
Alinhamento Superior Alinha dois ou mais objetos entre si,
tendo como referncia a coordenada
superior do ltimo objeto
selecionado
Alinhamento Inferior Alinha dois ou mais objetos entre si,
tendo como referncia a coordenada
inferior do ltimo objeto selecionado
Alinhamento Central Horizontal Alinha dois ou mais objetos
horizontalmente entre si, tendo como
referncia o ltimo objeto
selecionado
NOTAS
As opes Espelhar Horizontalmente e Espelhar Verticalmente tm o seguinte comportamento:
Para selees mltiplas, cada um dos objetos espelhado individualmente
O estado dos botes se altera (pressionado ou no) conforme os objetos tenham sido refletidos verticalmente
ou horizontalmente, mas somente se o estado de reflexo igual para todos os objetos selecionados
Os botes ficam desabilitados se a Tela estiver selecionada ou se no h nenhum objeto selecionado
Os objetos de Tela podem ser ajustados ao pixel mais prximo (efeito Snap to Pixel), utilizando-se a combinao
de teclas CTRL + BARRA DE ESPAO.
7.3.3 Animao
Recurso que aplica movimento a um objeto em tempo de execuo, e que est disponvel na barra de ferramentas
Tela. Os tipos de movimentos disponveis so os seguintes:
Animao com Translao : O objeto que recebe este recurso faz movimentos lineares de acordo com as
configuraes das propriedades no objeto. Para habilitar esta opo, siga estes procedimentos:
1. Selecione o objeto na Tela e clique em Animar com Translao .
2. Com o cursor do mouse, habilite as configuraes da orientao do objeto.
NOTA
Para objetos de Tela do tipo Figura que utilizem o formato de arquivo Bitmap (arquivos com extenso .bmp), o
recurso de animao no est disponvel.
7.3.5 Camadas
O E3 oferece uma arquitetura de Telas com at 32 camadas para insero de objetos. Cada objeto pode pertencer a
uma ou mais camadas, e a Tela ativa tanto em tempo de configurao (no E3 Studio) quanto em tempo de execuo
(no E3 Viewer) pode estar com nenhuma, uma, vrias ou todas as camadas ativas. Isto permite criar sistemas com
vrias formas de monitoramento, como por exemplo a visualizao de um processo apenas com o sistema eltrico,
apenas o hidrulico ou ambos. possvel tambm controlar o aparecimento de camadas de acordo com um
determinado nvel de zoom. A configurao das camadas feita clicando-se em Camadas na barra de ferramentas
Tela. As opes disponveis esto descritas na tabela a seguir.
Opes disponveis para a configurao de Camadas
OPO DESCRIO
Camada Habilita a visualizao da camada configurada na
propriedade Layer da Tela
Edio de Camadas
A janela Edio de Camadas tem as seguintes opes: Adicionar Camada , para a criao de uma nova camada;
Remover Camada , para a excluso da camada selecionada; e Editar Camada , para a edio da camada
selecionada. Ao clicar em ou , a janela da figura a seguir aberta.
7.3.7 Desenho
Permite aplicar ou editar informaes relativas s cores de fundo e frente da Tela e objetos de Tela e borda dos
objetos de Tela.
Opes de desenho
Para utilizar este recurso, siga estes procedimentos:
1. Insira ou selecione o objeto (Tela ou objeto de Tela) cujas cores ou bordas deseja editar.
2. Altere suas propriedades de acordo com as opes disponveis na barra de ferramentas Desenho.
Efeitos de preenchimento
As opes disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na janela Preenchimento
OPO DESCRIO
Estilos Mostra todos os estilos de preenchimento disponveis para
o objeto selecionado
Cor da frente Mostra a cor da frente previamente selecionada para o
objeto. Permite tambm a seleo de uma nova cor de
frente (o mesmo que clicar em )
Cor do fundo Mostra a cor de fundo previamente selecionada para o
objeto. Permite tambm a seleo de uma nova cor de
fundo (o mesmo que clicar em )
Amostra Mostra como o efeito escolhido aplicado com as cores
de fundo e de frente do objeto
Opaco ou Transparente Ao selecionar a opo Transparente, os preenchimentos
com efeito hachurado no mostram a cor de fundo do
objeto selecionado, somente a cor de frente, criando um
efeito de transparncia no objeto. Ao selecionar a opo
Opaco, este efeito no acontece. NOTA: A opo
Transparente est desabilitada para a Tela
7.3.9 Mover
Permite mover o contedo de uma Tela que contenha barras de rolagem no Studio ou no Viewer, em tempo de
execuo. Para utilizar este recurso no Studio, siga estes procedimentos:
1. Selecione a opo Mover na barra de ferramentas Tela.
2. Clique na Tela desejada para arrast-la. O ponteiro do mouse muda para o cone .
NOTAS
Tanto no Studio quanto no Viewer, a opo Mover est sempre disponvel ao utilizar o boto do meio do mouse.
No Viewer, ou seja, em tempo de execuo, clicar em objetos de Tela como Botes, Displays e SetPoints, entre
outros, impede o uso da opo Mover, visto que os objetos de Tela capturam o comportamento do cursor do
mouse. Nestes casos, deve-se utilizar as opes disponveis para a opo Mover (boto do meio do mouse ou
menu contextual) somente nas reas de Tela.
NOTA
A ordem de tabulao equivalente ordem de sobreposio dos objetos, descrita no tpico Sobreposio de
Objetos.
7.3.12 Rotacionar
Permite rotacionar um objeto de Tela tendo como origem seu centro ou qualquer outro ponto na Tela. Para utilizar
este recurso, siga estes procedimentos:
1. Selecione um objeto na Tela e clique em Rotacionar na barra de ferramentas Tela.
2. Clique em um de seus vrtices de rotao (em verde) e arraste o objeto at a posio desejada.
3. Caso seja necessrio, altere o centro de rotao do objeto (marcado por um crculo verde).
NOTA
Para objetos de Tela do tipo Figura que utilizem o formato de arquivo Bitmap (arquivos com extenso .bmp), o
recurso de rotao no est disponvel.
No caso de alterao no centro de rotao de um objeto de Tela, o menu contextual do objeto passa a exibir a
opo Redefinir Centro de Rotao, que permite desfazer a alterao e retornar o centro de rotao do objeto
ao seu padro.
7.3.14 Sombreamento
Permite aplicar ou editar o efeito de sombra em um objeto de Tela.
Opes da sombra
Para utilizar este recurso, siga estes procedimentos:
1. Insira ou selecione o objeto ao qual deseja aplicar a sombra.
2. Altere suas propriedades atravs da barra de ferramentas Sombra, de acordo com as opes mostradas na
tabela a seguir.
Opes disponveis na barra de ferramentas Sombra
OPO DESCRIO
Habilita ou desabilita o efeito de sombra no objeto
7.3.15 Travar
Ao selecionar esta opo, o E3 Studio no permite que o objeto seja movido, evitando movimentos indesejados.
Depois de travado, o mouse exibe um cursor com um cadeado ao ser deslocado sobre a rea do objeto.
Para habilitar esta opo, clique com o boto direito do mouse no objeto desejado e selecione a opo Travar .
Objeto travado
Para desabilitar esta opo, clique novamente com o boto direito do mouse no objeto e selecione a opo
Destravar .
7.3.16 Zoom
Na edio da Tela, pode-se escolher livremente o nvel de zoom desejado e mais confortvel para a edio. O zoom
est disponvel atravs do menu contextual Zoom, e possui nveis que vo de 10% a 800%, alm das opes Toda
Largura, Toda Altura, Toda Pgina e Preencher, conforme a figura a seguir.
Menu Zoom
Alm do menu Zoom, possvel modificar o nvel de zoom atravs do teclado e mouse, utilizando as seguintes
combinaes:
CTRL + SINAL DE MAIS (+): Aumenta o zoom
CTRL + SINAL DE MENOS (-): Diminui o zoom
NOTA
Ao utilizar as opes de CTRL + Roda do mouse (para cima ou para baixo), o foco do zoom sempre relativo
posio do ponteiro do mouse.
Cores
A opo Outra permite que o usurio selecione uma cor de qualquer parte da tela, dentro ou fora do E3 Studio.
Clique em e aps na cor desejada para que ela seja capturada para a janela de cores.
Para personalizar uma cor, pode-se combinar duas metodologias: RGB (componentes de vermelho, verde e azul) ou
HSL (componentes de matiz, saturao e luminosidade).
Cor personalizada
A escala RGB descreve uma cor atravs da mistura de trs cores bsicas, a saber:
Cada um destes elementos de cor podem ter um grau de intensidade que varia entre 0 (zero) e 255.
A escala HSL descreve uma cor atravs da mistura de trs componentes bsicos, a saber:
Hue (matiz): Especifica a gradao da cor dentro do espectro de luz visvel
Saturation (saturao): Indica a intensidade de um determinado matiz. Um matiz com alta saturao tem uma cor
mais intensa, enquanto um matiz com baixa saturao produz uma cor mais acinzentada
Lightness (luminosidade): Indica a quantidade de luz aplicada cor. Quanto maior a luminosidade, mais clara a
cor. Do mesmo modo, quanto menor a luminosidade, mais escura a cor
Estes elementos tambm podem ter seu grau de intensidade configurado entre 0 (zero) e 255. Assim, basta especificar
o valor para cada um dos itens, conforme a tonalidade da cor desejada, ou selecionar a cor desejada diretamente
com o ponteiro do mouse sobre as escalas da janela.
O valor numrico de cada cor obtido atravs da seguinte frmula:
Red * 256 ^ 0 + Green * 256 ^ 1 + Blue * 256 ^ 2
Ou seja:
Red * 1 + Green * 256 + Blue * 65536
Sendo que as variveis Red, Green e Blue podem assumir valores entre 0 (zero) e 255. Por exemplo:
Preto (0, 0, 0): 0 * 1 + 0 * 256 + 0 * 65536 = 0
Branco (255, 255, 255): 255 * 1 + 255 * 256 + 255 * 65536 = 16777215
Vermelho (255, 0, 0): 255 * 1 + 0 * 256 + 0 * 65536 = 255
Verde (0, 255, 0): 0 * 1 + 255 * 256 + 0 * 65536 = 65280
Azul (0, 0, 255): 0 * 1 + 0 * 256 + 255 * 65536 = 16711680
NOTA
Os valores armazenados nas propriedades dos objetos que se referem a cores so os valores numricos, calculados
atravs da frmula descrita anteriormente. A ferramenta Procurar e Substituir utiliza este valor armazenado no
processo de pesquisa, e no os valores formatados como RGB mostrados na Lista de Propriedades.
Os objetos que suportam formatao devem ter o tipo de dados na propriedade Value alterado de acordo com o
tipo de formatao desejada.
\m\d\y mdy
Tambm possvel criar formatadores que contenham apenas texto, que podem ser combinados com o uso de
diferentes campos, como no exemplo a seguir.
-1 "Positivo";"Negativo";"Zero","Texto" Negativo
0 "Positivo";"Negativo";"Zero","Texto" Zero
Alm disto, os seguintes caracteres podem ser mostrados diretamente sem o uso de aspas ou barra: $ - + / () : ! ^ &
' (aspas simples esquerda) ' (aspas simples direita) ~ { } = < >
NOTA
Para mostrar a barra invertida ou aspas duplas no dado formatado, use \" ou \\. Quando entre aspas, todo o texto
copiado diretamente; logo, "\a" mostrado simplesmente como \a.
Os formatadores numricos aceitam trs tipos bsicos de caracteres para definir o nmero de dgitos apresentados,
conforme a tabela a seguir.
Formatadores Numricos
OPO DESCRIO
0 (zero) Coloca o dgito significativo ou 0 (zero), quando no
houver
O ponto decimal define que se deseja apresentar tambm a parte fracionria de um nmero. A vrgula tem como
funo indicar que o valor deve ser dividido por mil (para cada vrgula), aps os dgitos do formatador.
Independente da configurao local do Windows, o ponto e a vrgula sempre devem ser utilizados no texto do
formatador para indicar o separador de milhar e de decimal, mas a sada formatada de acordo com a configurao
regional do sistema. A tabela a seguir descreve as opes disponveis.
Opes disponveis
DADO FORMATADOR SADA FORMATADA
12000 #, 12
987 B 1111011011
NOTA
Os valores armazenados nas propriedades dos objetos que se referem a datas so os valores numricos, calculados
atravs da frmula anterior. A ferramenta Procurar e Substituir utiliza este valor armazenado no processo de
pesquisa, e no os valores formatados como data e hora mostrados na Lista de Propriedades.
Aba Associaes
As opes disponveis na aba Associaes esto descritas na tabela a seguir.
Opes disponveis na aba Associaes
OPO DESCRIO
Propriedades Lista as propriedades do objeto que podem ser
associadas
Ao especificar a fonte da Associao, o seu texto aparece em azul, caso esta corresponda a uma expresso vlida. Se
a expresso contiver erros, como no caso de caminhos de objetos que no existam (ou pertenam a projetos que no
estejam carregados), o texto aparece em vermelho. Nestes casos, a opo de Verificar Domnio informa os locais
que necessitam de correo ou reviso. Os tipos de Associaes disponveis so explicados nos tpicos a seguir.
O campo Fonte pode conter uma referncia a um objeto de contexto existente na hierarquia superior do objeto onde
se est criando a Associao. O formato de uma referncia deste tipo @(Contexto)[.Caminho], onde Contexto o
nome do contexto (os valores possveis podem ser vistos na descrio do mtodo Context, no Manual de Referncia
e Scripts do E3) e Caminho pode ser o caminho de um objeto existente na hierarquia inferior do objeto de contexto,
ou uma propriedade deste mesmo objeto. Os nomes dos contextos no so sensveis a maisculas e minsculas.
Associaes 177
8.1 Simples
Na Associao Simples, o valor do campo Fonte copiado para a propriedade toda vez que o primeiro
modificado.
Associao Simples
Para utilizar este recurso, siga estes procedimentos:
1. Selecione o objeto para a Associao.
2. Clique com o boto direito do mouse no objeto e selecione a opo Propriedades.
3. Clique na aba Associaes e selecione a propriedade para criar a Associao. O Studio indica vrios tipos de
Associaes.
4. No campo Fonte, selecione a Associao e clique em para indicar a propriedade a referenciar, ou escreva a
expresso neste campo.
8.2 Bidirecional
A Associao Bidirecional semelhante Associao Simples. Porm, caso haja uma variao na propriedade, seu
valor copiado para a fonte, gerando assim uma Associao de duas direes.
Associao Bidirecional
Para utilizar este recurso, siga estes procedimentos:
1. Selecione o objeto para a Associao.
2. Clique com o boto direito do mouse no objeto e selecione a opo Propriedades.
178 Associaes
3. Clique na aba Associaes e selecione a propriedade para criar a Associao. O Studio indica vrios tipos de
Associaes.
4. No campo Fonte, selecione a Associao e clique em para indicar a propriedade a referenciar, ou escreva a
expresso neste campo.
8.3 Digital
J na Associao Digital podemos estabelecer que, caso a varivel ou expresso do campo Fonte represente um
valor digital (Booleano), seus estados Verdadeiro e Falso so mapeados para certos valores no destino, incluindo a
opo Pisca (alternncia de valores).
Associao Digital
As opes disponveis nesta Associao esto descritas na tabela a seguir.
Opes disponveis para a Associao Digital
OPO DESCRIO
Ligado Especifica o valor assumido pela propriedade quando a
expresso da fonte Verdadeira
Associaes 179
4. No campo Fonte, selecione a Associao e clique em para indicar a propriedade a referenciar, ou escreva a
expresso neste campo.
8.4 Analgica
A Associao Analgica permite estabelecer uma escala de converses entre a varivel fonte e destino. Atravs dos
valores especificados, feita uma escala linear entre os valores da propriedade e os valores da fonte.
Associao Analgica
As opes disponveis nesta Associao esto descritas na tabela a seguir.
Opes disponveis para a Associao Analgica
OPO DESCRIO
Valor na Fonte Determina os valores mnimo e mximo atingidos na
fonte
180 Associaes
Associao por Tabela
As opes disponveis nesta Associao esto descritas na tabela a seguir.
Opes disponveis para a Associao por Tabela
OPO DESCRIO
Inserir Insere uma nova linha na tabela
8.6 Reversa
Na Associao Reversa, toda vez que o valor da propriedade modificado, este copiado para a fonte, funcionando
assim de maneira inversa Associao Simples. Para utilizar este recurso, siga estes procedimentos:
1. Abra a janela de propriedades do objeto e selecione a opo Associaes.
2. Selecione a propriedade para criar a Associao e clique no item Conexo Reversa.
3. No campo Fonte, selecione a Associao e clique em para indicar a propriedade a referenciar, ou escreva a
expresso neste campo.
Associaes 181
Associao Reversa
8.7 Mltipla
Na Associao Mltipla, cada linha da Associao permite buscar o valor de uma fonte diferente. A fonte ativa
selecionada de acordo com o valor fonte principal da Associao.
Cada linha possui o intervalo (propriedades Min e Max) e a fonte para aquele intervalo (propriedade Source, que
uma Associao normal). Para utilizar este recurso, siga estes procedimentos:
1. Abra a janela de propriedades do objeto e selecione a aba Associaes.
2. Selecione a propriedade para criar a Associao e clique no item Conexo Mltipla.
3. Defina a fonte principal da Associao na coluna Fonte.
Associao Mltipla
As opes disponveis nesta Associao esto descritas na tabela a seguir.
Opes disponveis para a Associao Mltipla
OPO DESCRIO
Inserir Insere uma nova linha na tabela
182 Associaes
OPO DESCRIO
Mx Especifica o valor mximo da fonte para uma linha da
tabela
Fonte Especifica a fonte que associada com a propriedade
quando o valor da fonte principal estiver entre os
limites Mn e Mx
Edio de Associaes
A caixa de dilogo anterior mostra uma lista das Associaes, propriedades do tipo Link e eventos do usurio
relacionados aos objetos selecionados e seus filhos. De acordo com o tipo de linha, as informaes mostradas nas
colunas esto descritas na tabela a seguir.
Opes disponveis na janela Editar Associaes
OPO DESCRIO
Nome do Objeto Determina o nome do objeto
Associaes 183
OPO DESCRIO
Propriedade / Evento Determina a propriedade do objeto que possui a
Associao
Conexo Determina o tipo de Associao (Simples, Bidirecional,
Digital, Analgica, Por Tabela, Reversa ou Mltipla)
Fonte Determina a fonte da Associao
Clicar em Remover permite a remoo da Associao selecionada. A opo Mostrar janela de propriedades das
associaes determina se os minidialogs das Associaes so mostrados quando a linha estiver selecionada. Se esta
janela estiver visvel, permitida a edio das propriedades das Associaes. Seu valor padro habilitado.
NOTA
Na janela Editar Associaes, o usurio pode manter a Associao com a fonte vazia. Para isto, selecione a coluna
Fonte e pressione a tecla DELETE.
184 Associaes
Para editar as propriedades dos eventos do usurio, necessrio selecionar a linha que contm o evento e, na
coluna Conexo, clicar na opo Editar.
Sempre que a propriedade for uma condio Indica que o evento do tipo etOnEvent ou
verdadeira etWhileEvent
Sempre que a propriedade alterar o seu valor Indica que o evento do tipo etOnValueChangeEvent,
isto , o evento ocorre sempre que a expresso
geradora mudar o valor
Tratar a desconexo como mudana de valor Se houver alguma desconexo, esta tratada como uma
mudana de valor
A janela de edio de Associaes permite utilizar o recurso de copiar e colar entre as Associaes das propriedades.
A opo Copiar Associao copia a Associao da linha selecionada e a opo Colar Associao cola a Associao
na linha selecionada, substituindo a Associao anterior.
Associaes 185
Opo de copiar ou colar uma Associao
186 Associaes
CAPTULO
Bibliotecas
9
O E3 possui ferramentas que permitem transformar qualquer objeto ou conjunto de objetos da aplicao em uma
biblioteca do usurio. As Bibliotecas podem ser formadas por objetos frequentemente utilizados, e
subsequentemente reaproveitados em outra aplicao.
O E3 fornece dois tipos de bibliotecas para o usurio: a Galeria, uma biblioteca de smbolos grficos vetoriais, que
podem ser livremente utilizados nas aplicaes; e uma ferramenta de bibliotecas do usurio chamada de ElipseX. O
uso de bibliotecas no E3 altamente recomendvel na maioria dos casos, devido ao ganho de produtividade que elas
trazem s aplicaes. Algumas das vantagens dos ElipseX so as seguintes:
Reutilizao de cdigos
Minimizao de testes durante o desenvolvimento
Criao de interfaces padro para os objetos desenvolvidos
Diminuio do tempo de desenvolvimento de novos projetos
Proteo do contedo do projeto
Hierarquizao de objetos
Bibliotecas no Organizer
9.1 Galeria
A Galeria pode ser acessada clicando-se em Galeria na barra de ferramentas Padro. Neste item est disponvel
uma srie de elementos grficos vetoriais, divididos em categorias, que podem ser arrastados para as Telas ou ento
para os ElipseX. Esto disponveis os seguintes tipos de smbolos: Botes 3-D, Smbolos 3-D ISA, Ar Condicionado,
Arquitetura, Setas, Controles e Equipamentos ASHRAE, Dutos ASHRAE, Canos ASHRAE, Formas Bsicas, Ventiladores,
Aquecedores, Prdios, Processos Qumicos, Computadores, Teclas de Computadores, Contineres, Controladores,
Esteiras, Dutos, Eltrica, Acabamentos, Tubos Flexveis, Medidores de Vazo, Alimentos, Aquecimento, HVAC, cones e
Bitmaps, Miscelnea Industrial, Smbolos Internacionais, Smbolos ISA, Laboratrio, Maquinaria, Mapas e Bandeiras,
Manuseio de Materiais, Minerao, Canos, Smbolos 1, Smbolos 2, Misturadores, Motores, Natureza, Interface de
Operao, Painis, Canos, Acessrios Industriais, Energia, Resfriamento de Processos, Aquecimento de Processos,
Papel e Celulose, Bombas, Segurana, Balanas, Canos Segmentados, Sensores, Cortes em Tanques, Tanques, Texturas,
Vlvulas, Veculos, gua e Resduos e Fios e Cabos.
Para utilizar este recurso, siga estes procedimentos:
1. Clique em Galeria na barra de ferramentas Padro.
2. Selecionando esta aba, tem-se acesso aos conjuntos de smbolos, que esto agrupados em categorias. Selecione
a categoria atravs da lista na parte superior da janela.
3. Para inserir um objeto da biblioteca de smbolos em uma Tela, clique no objeto desejado e arraste-o para a Tela.
4. Depois de inserido, o objeto pode ser livremente editado e trabalhado de acordo com as caractersticas descritas
para os objetos de imagem. Por exemplo, pode-se mudar a cor de preenchimento diretamente atravs das
Bibliotecas 187
propriedades OverrideFillMode, OverrideFillColor e OverrideLineColor, sem a necessidade de transformar o
objeto em um objeto grfico do E3.
Galeria
188 Bibliotecas
5. Clique em Concluir.
Dentro de uma biblioteca ElipseX, pode-se inserir trs tipos de objetos: os XControls, os XFolders e os XObjects.
Os seguintes itens podem ser inseridos em um XControl: Primitivas de Desenho (Retas, Retngulos, Crculos, etc.),
Objetos Grficos Vetoriais, incluindo objetos da biblioteca de smbolos (WMF, EMF, etc.), Objetos Grficos no-
Vetoriais (BMP, JPEG, GIF,etc.), Controles ActiveX do E3 (E3Chart, E3Browser, E3Alarm, Controles ActiveX de terceiros) e
outros XControls.
Um XFolder um objeto que permite inserir objetos filhos em suas instncias. Desta forma, possvel organizer ou
criar hierarquias de objetos em uma aplicao. Pode-se inserir em um XFolder itens como Pastas de Dados, Tags de
Comunicao, Filtros de Alarmes e instncias de XFolders, entre outros.
J os XObjects podem conter quaisquer tipos de objetos no-grficos, executados no E3 Server, como Drivers de
Comunicao, Servidores de Dados, Bancos de Dados, Frmulas, Configuraes de Alarmes, Servidores de Alarmes e
Objetos COM, entre outros.
NOTA
A janela de propriedades dos ElipseX no editor de objetos pode ser aberta utilizando as combinaes de teclas ALT
+ ENTER, CTRL + ALT + ENTER ou ALT + duplo-clique do mouse.
Dentro de um mesmo arquivo .lib pode existir qualquer nmero de componentes ElipseX, sejam eles XControls,
XFolders ou XObjects. Pode-se tambm ter vrias bibliotecas diferentes dentro do mesmo Domnio.
Note que para cada ElipseX criado em uma biblioteca so criadas internamente duas interfaces, uma para declarar as
propriedades do objeto, e outra para declarar os eventos do objeto. Estas interfaces tm seus nomes gerados
automaticamente, acrescentando o prefixo "D" a este nome (a interface de eventos adiciona o sufixo "Events" ao nome
automtico). Se, por exemplo, o objeto se chama "XObject1", sua interface de propriedades tem o nome "DXObject1"
e a interface de eventos, "DXObject1Events". Uma tentativa de usar estes nomes em outras classes na mesma
biblioteca gera um cdigo de erro 8002802D, que corresponde a Name already exists in the library.
9.2.1 XControls
O XControl define uma interface grfica com o usurio, que pode ser composta de quaisquer objetos do E3, e tem o
propsito de ser multiplicada facilmente por um projeto. Pode-se criar um XControl clicando com o boto direito do
mouse no item Bibliotecas de Objetos - XControls no modo Domnio, selecione a opo Inserir XControl em e
logo aps o nome da biblioteca desejada.
Bibliotecas 189
Aba Propriedades de um XControl
Ao inserir um XControl aberto o Editor deste objeto, composta por trs abas. Alm da aba Scripts, presente em
todos os objetos, existe a aba Design, que equivale a uma Tela, onde podem ser inseridos os objetos grficos
descritos anteriormente, e a aba Propriedades, onde podem ser inseridas variveis, que so as propriedades do
XControl. Estas propriedades so exportadas pelo objeto e podem ser associadas a um Tag ou outra propriedade
qualquer quando o objeto estiver sendo usado na aplicao.
As variveis a serem exportadas podem ser inseridas pressionando-se a tecla INSERT do teclado ou clicando em e
excludos atravs da tecla DELETE do teclado ou clicando em . As opes disponveis na aba Propriedades esto
descritas na tabela a seguir.
Opes disponveis na aba Propriedades
OPO DESCRIO
Nome Determina o nome da varivel do XControl
190 Bibliotecas
OPO DESCRIO
Texto de ajuda Texto de declarao e documentao da varivel. Esta
opo corresponde propriedade HelpString de um
objeto Definio de Propriedade
NOTA
interessante observar que XFolders e XObjects podem ser declarados como tipos de dados.
A edio do objeto grfico pode ser realizada da mesma forma como a edio de uma Tela, possuindo os mesmos
recursos grficos e opes.
Pode-se inserir os XControls em qualquer Tela, ou ainda dentro de outro XControl clicando com o boto direito do
mouse na Tela ou XControl de destino, selecionando a opo Inserir, como mostrado a seguir. A partir de um
XControl em desenvolvimento (dentro da biblioteca), possvel inserir outro XControl dentro dele, clicando com o
boto direito do mouse no XControl de destino e selecionando a opo Inserir.
9.2.2 XFolders
Um XFolder um objeto do servidor que permite organizar ou criar uma hierarquia de objetos nas instncias criadas.
Os objetos que podem ser inseridos em uma instncia de XFolder so os seguintes:
Pastas de Dados
Tags de Comunicao
Consultas
Filtros de Alarmes
Instncias de XFolders e XObjects
Alarmes
Bibliotecas 191
NOTA
No permitido inserir objetos na definio de um XFolder, somente em suas instncias.
Para criar um XFolder, clique com o boto direito do mouse no item Bibliotecas de Objetos - XFolders no modo
Domnio, selecione a opo Inserir XFolder em e logo aps o nome da biblioteca desejada.
192 Bibliotecas
OPO DESCRIO
Retentiva Determina se a propriedade retentiva ou no. Esta
opo corresponde propriedade Retentive de um
objeto Definio de Propriedade
Valor inicial Determina o valor inicial da varivel. Esta opo
corresponde propriedade DefaultValue de um objeto
Definio de Propriedade
Pode-se inserir XFolders em qualquer Servidor de Dados, clicando com o boto direito do mouse no Servidor de
Dados no modo Domnio, selecionado a opo Inserir e logo aps o nome do XFolder desejado, conforme
mostrado na figura a seguir. No modo Explorer, clique com o boto direito do mouse no Servidor de Dados do
projeto, selecione a opo Inserir e logo aps o nome do XFolder desejado.
9.2.3 XObjects
Alm dos XControls e XFolders, pode-se criar uma biblioteca de dados, denominada XObject. Com ela, pode-se
definir uma estrutura de dados, que executada no servidor. Tal estrutura pode realizar clculos, Associaes,
comunicaes, verificao de alarmes, registro histrico, etc., que independam de que alguma interface grfica
(Viewer) esteja aberta ou sendo executada naquele momento. Para criar um XObject, clique com o boto direito do
mouse no item Bibliotecas de Objetos - XObjects no modo Domnio, selecione a opo Inserir XObject em e logo
aps o nome da biblioteca desejada.
Bibliotecas 193
XObjects
Ao inserir um XObject, aberto o Editor deste objeto, onde podem ser inseridas variveis. Estas variveis so as
propriedades a serem exportadas pelo objeto, que podem ser associadas a um Tag ou outra propriedade qualquer
de uma aplicao quando o objeto estiver sendo usado em uma aplicao.
As variveis a serem exportadas podem ser inseridas pressionando-se a tecla INSERT do teclado ou clicando em e
excludas atravs da tecla DELETE ou clicando em . As opes disponveis na aba Propriedades esto descritas na
tabela a seguir.
Opes disponveis na aba Propriedades
OPO DESCRIO
Nome Determina o nome da varivel do XObject
194 Bibliotecas
OPO DESCRIO
Texto de ajuda Texto de declarao e documentao da varivel. Esta
opo corresponde propriedade HelpString de um
objeto Definio de Propriedade
Apenas propriedades de tipos simples (Variant, String, Date, Double, etc.) podem ser retentivas (o Editor do objeto
desmarca automaticamente a coluna Retentiva se o tipo de uma propriedade for alterado para um tipo de
objeto), e apenas propriedades de XFolders e de XObjects podem ser retentivas.
NOTA
O uso de propriedades retentivas nos ElipseX pode aumentar o tempo de incio do aplicativo, e tambm aumentar o
consumo de memria pelo processo E3Run. Os tempos variam dependendo do nmero de instncias de XFolders e
de XObjects, do nmero de propriedades retentivas em cada XFolder ou XObject e da quantidade destas
propriedades que possuem o seu valor alterado (se a propriedade nunca alterada, o seu valor retentivo
permanece zerado).
Podem ser inseridos em um XObject quaisquer mdulos do E3 que sejam executados no servidor, a saber:
Driver de Comunicao e Driver de Comunicao OPC
Servidor de alarmes e alarmes
Servidor de Banco de Dados
Frmulas
Servidor de Dados
Histricos
Isto permite que se possa definir como uma biblioteca um sistema complexo de gerenciamento, que pode ser
facilmente replicado quantas vezes forem necessrias em um aplicativo.
IMPORTANTE
Veja que XControls, XFolders e XObjects s podem se relacionar com o mundo externo atravs das propriedades
(ou ainda atravs do mouse e teclado, no caso dos XControls). Isto significa que no se pode acessar dados internos
de um XControl, XFolder ou XControl seno de dentro do prprio objeto.
Pode-se inserir XObjects em qualquer Servidor de Dados, clicando com o boto direito do mouse no Servidor de
Dados no modo Domnio, selecionado a opo Inserir e logo aps o nome do XObject desejado, conforme
mostrado na figura a seguir. No modo Explorer, clique com o boto direito do mouse no Servidor de Dados do
projeto, selecione a opo Inserir e logo aps o nome do XObject desejado.
Bibliotecas 195
Inserindo um XObject no modo Domnio
Note que mesmo se os arquivos de biblioteca possurem vrios XControls, XFolders e XObjects, ao tentar inserir uma
instncia (cpia), o E3 Studio exibe para as Telas somente os XControls, e para os Servidores de Dados somente os
XFolders e XObjects disponveis.
NOTA
Deve-se cuidar para no apagar uma propriedade de um XControl, XFolder ou XObject que possua uma Associao.
Estas propriedades, uma vez apagadas, no aparecem mais na lista de propriedades do objeto, e por isto no
podem ser editadas. Quando for executada a operao Verificar Domnio, executada uma procura por estas
propriedades e o usurio consultado se deseja remover esta Associao ou no.
Propriedade invlida
Pode-se optar por no remover e ento criar novamente o objeto que foi apagado com a propriedade que se deseja
editar, remover apenas a propriedade que est sendo mostrada, remover todas as propriedades ou no remover
nenhuma propriedade.
196 Bibliotecas
9.3 Quando Criar um ElipseX
O uso de Bibliotecas altamente recomendvel devido ao ganho de produtividade que trazem. Algumas das
vantagens dos ElipseX so as seguintes:
Reutilizao de cdigo
Minimizao de testes durante o desenvolvimento
Criao de interface padro para os objetos desenvolvidos
Diminuio do tempo de desenvolvimento de novos projetos
Proteo do contedo do projeto
Hierarquizao de objetos
Logo, o uso de biblioteca recomendado para a maioria das aplicaes. Entretanto, existem alguns critrios para
indicar a necessidade da construo de objetos no E3:
Repetio no uso: Se um mesmo equipamento ou processo usado mais de uma vez no mesmo projeto
Procedimentos do conhecimento do usurio: Frequentemente, um processo criado por determinada empresa
deve ser protegido de cpia ou alterao. Isto comum no caso de integradores de servios ou fabricantes de
mquinas
Uso de controladores: Um controlador de processo, cujo mapeamento de memria fixo, pode ser
implementado com todas as funcionalidades disponveis. A flexibilidade disponvel para a construo e uso dos
objetos no E3 permite que sejam utilizadas posteriormente apenas as variveis de interesse, desprezando-se as
demais
NOTA
Para exemplos de criao de ElipseX e maiores informaes sobre estes objetos, consulte o Manual de Referncia e
Scripts do E3.
Bibliotecas 197
CAPTULO
ActiveX
10
Os objetos ActiveX so componentes de software baseados na tecnologia COM (Component Object Model) que
podem ser inseridos em uma aplicao para realizar diversas tarefas. Estes objetos so desenvolvidos em ambientes
de programao tais como C/C++, Delphi e Visual Basic, entre outros.
Alguns objetos ActiveX so automaticamente registrados quando o E3 instalado: E3Alarm, E3Browser e E3Chart
(desenvolvidos pela Elipse Software), Microsoft Forms (desenvolvidos pela Microsoft) e Relatrio (ActiveReports,
desenvolvido pela Data Dynamics). Os objetos E3Alarm, E3Browser, E3Chart e Relatrio possuem captulos
especficos mais adiante neste Manual. Os objetos Microsoft Forms so descritos em outro tpico deste captulo.
NOTA
Para objetos ActiveX no instalados previamente pelo E3, necessrio que estes objetos sejam instalados em todos
os computadores onde a aplicao vai executar, especialmente em Viewers Remotos.
Alm destes, pode-se inserir qualquer outro objeto ActiveX. Para registrar um objeto ActiveX no E3, siga estes
procedimentos:
1. Selecione o menu Ferramentas - Gerenciar ActiveX. A janela da figura a seguir mostrada.
198 ActiveX
OPO DESCRIO
Remover Remove o controle selecionado da lista Controles
registrados no E3, movendo-o de volta para a lista
Controles registrados no Windows. Os controles com o
cone no podem ser removidos, somente os que
tiverem o cone
2. Clique em Procurar para abrir uma caixa de dilogo e localizar o arquivo que contm o ActiveX.
Os objetos ActiveX podem ser de dois tipos: Grficos (utilizados nas Telas da aplicao) e No-Grficos (realizam
algum tipo de manipulao de dados).
Os objetos grficos podem ser inseridos na aplicao de trs formas diferentes:
Atravs da barra de ferramentas Objetos, selecionando o objeto desejado
Atravs do clique com o boto direito do mouse no objeto Tela, no Organizer, selecionando a opo Inserir
Atravs do clique com o boto direito do mouse na Tela, selecionando a opo Inserir
ActiveX 199
Inserindo um objeto grfico na Tela
Os objetos no-grficos podem ser usados na aplicao atravs de scripts e so criados pelo mtodo CreateObject,
padro do VBScript.
200 ActiveX
10.1.7 Editor de Texto
Possibilita ao usurio inserir e editar textos. inserido na Tela ao selecionar o cone .
10.1.8 Lista
Exibe uma lista de itens dentre os quais o usurio pode escolher um ou mais. inserido na Tela ao selecionar o cone
.
10.1.10 Texto
Exibe mensagens de texto que no podem ser editadas pelo usurio, como descries de controles ou legendas.
inserido na Tela ao selecionar o cone .
ActiveX 201
Em scripts, o KeyPad pode ser acionado utilizando-se o mtodo GetKeyPad do objeto Application. Demais
informaes sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de
Referncia e Scripts do E3, em seu captulo respectivo.
202 ActiveX
CAPTULO
Servidor de Dados
11
Os Servidores de Dados so os objetos responsveis por abrigar a execuo das variveis do sistema como Tags
Internos, Tags Demo, Tags Timer, e instncias de XFolders e XObjects. Para utilizar este recurso, siga este
procedimento:
1. Clique com o boto direito do mouse no projeto no Organizer e selecione a opo Inserir - Servidor de Dados.
NOTA
Os objetos do Servidor de Dados (Pasta de Dados, Tag Contador, Tag Demo, Tag Interno e Tag Timer) podem ser
configurados para funcionarem como reas de Alarme.
Todas as opes do editor de objetos do Servidor de Dados que esto disponveis via menu contextual (atravs
do clique com o boto direito do mouse) tambm esto disponveis utilizando a combinao de teclas SHIFT +
F10, que corresponde tecla de aplicao ou de menu .
A janela de propriedades dos objetos do Servidor de Dados no editor de objetos pode ser aberta utilizando as
combinaes de teclas ALT + ENTER, CTRL + ALT + ENTER ou ALT + duplo-clique do mouse.
Aba Geral
As opes disponveis nesta aba esto descritas na tabela a seguir.
NOTAS
Caso seja selecionada a opo Escolher uma impressora disponvel, mas no seja selecionada nenhuma
impressora na Lista de Seleo correspondente, o objeto Impressora de Linha no permite a impresso e sua
propriedade PrinterStatus configurada com o valor 0 (zero, psUnknown).
A impressora padro do Windows para o usurio atualmente logado pode ser diferente da impressora padro
utilizada pelo E3 Server. Veja o tpico Impressora para maiores informaes.
O objeto Impressora de Linha pode ser inserido em uma Tela, no Viewer, em uma Pasta do Viewer ou em uma
Pasta de Dados.
Para a impresso, utilize o mtodo Write, passando como argumento a String desejada. Este objeto possui a
propriedade MaxPendingLines, que controla o nmero mximo de linhas pendentes para impresso. Caso a
chamada do mtodo Write ultrapasse o valor configurado nesta propriedade, este mtodo retorna um erro de script
e a String excedente descartada.
NOTA
O objeto Banco de Dados pode ser configurado para funcionar como rea de Alarme.
12.1 Access
Gera uma base de dados no formato MDB (Microsoft Access Database), padro para banco de dados no E3. Para
utilizar este recurso, siga estes procedimentos:
1. Clique com o boto direito do mouse no nome do projeto no Explorer e selecione a opo Inserir - Banco de
Dados. No modo Domnio, clique com o boto direito do mouse no item Objetos de Servidor - Banco de
Dados, selecione a opo Inserir Banco de Dados em e logo aps o nome do projeto desejado. O objeto
criado no projeto, e sua janela de edio de scripts aberta.
2. Para configur-lo, selecione a aba Configuraes da Janela de Propriedades.
12.2 Oracle
A utilizao do Oracle como servidor de Banco de Dados do E3 s possvel atravs da instalao de um servidor ou
cliente Oracle na mquina onde executado o E3 Server. Nesta instalao devem estar presentes, obrigatoriamente, o
suporte a OCI (Oracle Call Interface) e o OLEDB Provider para Oracle, necessrios para a comunicao do E3 com o
Oracle. Para instalar o Oracle, consulte a documentao prpria do produto.
Ao inserir o Banco de Dados na aplicao, so habilitadas as opes referentes ao tipo de Servidor de Banco de
Dados. O Servidor de Banco de Dados o responsvel pelo gerenciamento e armazenamento das informaes dos
objetos que utilizam este servio.
Depois da criao da conexo, possvel executar um comando SQL diretamente na conexo, como mostrado a
seguir:
DBConnection.Execute _
"UPDATE Tabela SET nome = 'Joo' WHERE id = 10"
possvel tambm a visualizao de todos os registros desejados, retornados na forma de um Recordset (consulta),
como mostrado a seguir:
Set Recordset = CreateObject("ADODB.Recordset")
Recordset.Source = "Tabela"
Recordset.ActiveConnection = DbConnection
Recordset.CursorType = 1 ' adOpenKeyset
Recordset.LockType = 3 ' adLockOptimistic
Recordset.Open
A partir deste momento, possvel navegar pela tabela utilizando-se os comandos MoveNext e MovePrevious, bem
como uma srie de outros comandos fornecidos pelo ADO. possvel tambm utilizar uma consulta SQL para
manipular partes especficas da tabela, atravs da propriedade Source.
O uso deste tipo de acesso deve ser restrito a casos onde no exista outra soluo. O E3 disponibiliza recursos que
visam minimizar o uso destes acessos via script. Entretanto, eventualmente o uso deste recurso pode ser necessrio.
Nas permisses, a expresso Permisso completa significa que o usurio tem permisses para:
Criar ou remover tabelas existentes
Criar ndices e chaves
Inserir e excluir dados nas tabelas criadas
Realizar consultas sobre as tabelas resultantes
O usurio no precisa ser um Administrador para possuir Permisso completa em qualquer objeto.
220 Alarmes
Caso haja necessidade, novas reas podem ser inseridas dentro de outras. Para inserir este objeto, siga este
procedimento:
1. Clique com o boto direito do mouse no objeto Configurao de Alarmes ou no objeto rea do projeto no modo
Explorer e selecione a opo Inserir - rea. No modo Domnio, clique com o boto direito do mouse no objeto
Configurao de Alarmes e selecione o item Inserir - rea.
Alarmes 221
Aba rea de Alarmes
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba rea de Alarmes
OPO DESCRIO
Funcionar como rea de alarmes Habilita ou desabilita o comportamento de rea de
Alarme para o objeto de Servidor. Esta opo
corresponde propriedade IsAlarmArea
NOTAS
O objeto Filtro de Alarmes pode ser inserido em uma Tela, no Viewer, em uma Pasta do Viewer ou em uma Pasta
de Dados.
No possvel reconhecer alarmes utilizando o objeto Filtro de Alarmes.
222 Alarmes
Para inserir este objeto em uma Tela, por exemplo, siga este procedimento:
1. Clique com o boto direito do mouse em uma Tela e selecione a opo Inserir - Standard - Filtro de Alarmes.
13.2.1 Configurao
Para configurar um Filtro de Alarmes, clique com o boto direito do mouse no objeto e selecione a opo
Propriedades.
Alarmes 223
13.2.1.1 Aba Conexes
A aba Conexes permite gerenciar as conexes do Filtro de Alarmes com Servidores de Alarmes locais ou remotos.
Aba Conexes
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Conexes
OPO DESCRIO
Adiciona uma nova Conexo ao Filtro de Alarmes. Esta
opo corresponde ao mtodo Add da Coleo de
Conexes
Remove a Conexo selecionada. Esta opo corresponde
ao mtodo Remove da Coleo de Conexes. NOTA: A
Conexo criada automaticamente com o objeto no pode
ser removida
Nome conexo Nome desta Conexo. Pressione a tecla F2 para editar
este nome. Esta opo corresponde propriedade
ConnectionName do objeto Conexo na Coleo de
Conexes
Nome servidor Nome amigvel para identificar o Domnio do Servidor
de Alarmes selecionado. Esta opo corresponde
propriedade DomainName do objeto Conexo na
Coleo de Conexes
Servidor de Alarmes Nome do Servidor de Alarmes, que tanto pode estar em
um Domnio local quanto em um Domnio Remoto. Esta
opo corresponde propriedade AlarmServer do
objeto Conexo na Coleo de Conexes. Clique em
para selecionar um Servidor de Alarmes utilizando o
AppBrowser
Filtro conexo Nome de um Filtro que contm a configurao do filtro
de alarmes, definido na aba Filtros. Esta opo
corresponde propriedade FilterConnection do objeto
Conexo na Coleo de Conexes
224 Alarmes
13.2.1.2 Aba Filtros
A aba Filtros permite gerenciar os filtros do Filtro de Alarmes.
Aba Filtros
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Filtros
OPO DESCRIO
Filtros Caixa de seleo com os Filtros atualmente disponveis
Ao clicar em Configurar, a janela da figura a seguir aberta para configurao do Filtro selecionado.
Alarmes 225
Propriedades do Filtro selecionado
As opes disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na janela de propriedades de um Filtro
OPO DESCRIO
Nome Nome deste Filtro. Esta opo corresponde
propriedade FilterName
Filtrar por rea de Alarme Determina o filtro por rea de Alarme. Caso deseje
utilizar algum filtro, especifique-o neste campo, seno
deixe-o em branco. Esta opo equivale propriedade
AreaFilter
Filtro de rea Simples Se a opo Filtrar por rea de Alarme no estiver em
branco, esta opo habilitada e, se estiver selecionada,
a filtragem por rea baseada apenas na coincidncia
da parte inicial do nome. Caso contrrio, considera o
nome completo da rea. Esta opo equivale
propriedade SimpleAreaFilter
Utilizar filtro customizado Permite informar um filtro personalizado para os
alarmes. Esta opo corresponde propriedade
CustomFilter
Filtrar por tipo Habilita o tipo de filtro que aplicado no alarme
(Apenas alarmes, Apenas eventos ou Alarmes e
Eventos). Esta opo equivale propriedade FilterType
Filtrar por severidade Habilita ou desabilita a visualizao do grau da
severidade (Alta, Mdia ou Baixa). Esta opo equivale
s propriedades ShowHightPriority (Alta),
ShowMediumPriority (Mdia) e ShowLowPriority
(Baixa)
226 Alarmes
Aba Ordenao
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Ordenao
OPO DESCRIO
Pelo campo Ordena os alarmes conforme o campo especificado. Esta
opo equivale propriedade PrimarySortField. A
ordenao padro feita atravs do campo InTime, de
maneira descendente
Depois por Ordena os alarmes a partir do item especificado na
opo Pelo campo. O prximo item ordenado a partir
da especificao indicada nos campos Depois por. Estas
opes equivalem s propriedades SecondarySortField,
ThirdSortField e FourthSortField, respectivamente
Ascendente Ordena os campos do alarme de forma ascendente.
Estas opes equivalem s propriedades
PrimarySortAscending, SecondarySortAscending,
ThirdSortAscending e FourthSortAscending em
Verdadeiro, respectivamente.
Descendente Ordena os campos do alarme de forma descendente.
Estas opes equivalem s propriedades
PrimarySortAscending, SecondarySortAscending,
ThirdSortAscending e FourthSortAscending em Falso,
respectivamente
NOTA
O objeto Fonte de Alarme pode ser criado dentro de qualquer objeto do Servidor.
Alarmes 227
objeto desejado no item Objetos de Servidor e selecione a opo Inserir - Alarme (Analgico, Banda Morta,
Taxa de Variao, Digital ou Discreto).
Fontes de Alarmes
Ao abrir a janela de Propriedades de qualquer Fonte de Alarme e selecionar a aba Fonte, a janela mostrada na figura
a seguir aberta.
228 Alarmes
Aba Fonte
Para tratar o alarme como evento, ou para que o alarme possa ser reconhecido duplamente (tanto quando estiver
ativo como quando passar para inativo), clique na caixa de seleo correspondente. Todas as Fontes de Alarme
possuem as seguintes propriedades gerais:
Texto da Mensagem: Esta mensagem armazenada no campo Mensagem do evento de alarme enquanto ele
estiver ativo, ou seja, pode ser visualizada no E3Alarm (sumrio de alarmes), armazenada no Banco de dados, etc.
O limite do texto da mensagem de 200 caracteres
Severidade: Indica a gravidade do alarme ocorrido (Baixa, Mdia ou Alta). O campo Severidade utilizado para
realizao de filtros e ordenao nas mensagens
Pede Ack: Indica se o alarme deve ser reconhecido pelo operador para ser retirado da lista de alarmes no
E3Alarm, ou se reconhecido automaticamente quando a varivel deixa uma condio de alarme
Volta ao normal: Esta mensagem armazenada no campo Mensagem do evento de alarme enquanto este
estiver inativo, ou seja, pode ser visualizada no E3Alarm (sumrio de alarmes), armazenada em um Banco de
Dados, etc.
H vrios tipos de Fontes de Alarme que podem ser inseridas em objetos do Servidor. As opes disponveis esto
descritas nos prximos tpicos.
Alarmes 229
Aba Analgico
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Analgico
OPO DESCRIO
Habilitao (LoLo, Lo, Hi, HiHi) Habilita a verificao do tipo de alarme selecionado
230 Alarmes
Banda morta
Este tipo de alarme interessante quando a referncia (SetPoint) varivel, e tambm quando se deseja evitar uma
quantidade desnecessria de alarmes para pequenas oscilaes da varivel monitorada.
Alarmes 231
OPO DESCRIO
Espera (ms) Especifica o tempo de espera, em milissegundos.
Quando o valor for igual a 0 (zero, padro), no
aplicada nenhuma espera
Volta ao normal Permite especificar o texto a ser mostrado para o
usurio quando o alarme no estiver em condio ativa
232 Alarmes
Aba Digital
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Digital
OPO DESCRIO
Alarme Digital Habilita o alarme digital
Alarmes 233
13.3.5 Alarme Discreto
Permite monitorar uma varivel pela especificao de mltiplas sub-condies.
Aba Discreto
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Discreto
OPO DESCRIO
Adiciona uma nova Sub-condio no alarme
Remove a Sub-condio selecionada
Mapear todas as subcondies Permite mapear e sincronizar as Sub-condies do
Alarme a partir de semnticas presentes no objeto fonte.
Este recurso atualmente s suportado pelos objetos de
servidor do Elipse Power, portanto este boto
permanece desabilitado por padro no Elipse E3
Nome Nome da Sub-condio
234 Alarmes
todos os Viewers conectados, bem como enviar estes eventos para um banco de dados, se necessrio.
Uma aplicao s pode ter um objeto deste tipo, e sua presena obrigatria para que a verificao de alarmes
ocorra. Para inserir um Servidor de Alarmes, siga este procedimento:
1. Clique com o boto direito do mouse no projeto no modo Explorer e selecione a opo Inserir - Servidor de
Alarmes. No modo Domnio, clique com o boto direito do mouse no item Objetos de Servidor - Alarmes,
selecione a opo Inserir Servidor de Alarmes em e logo aps o nome do projeto desejado.
Alarmes 235
Aba Configurao
Cada campo da aba Configurao possui uma propriedade correspondente. As opes disponveis nesta aba esto
descritas na tabela a seguir.
Opes disponveis na aba Configurao
OPO DESCRIO
Armazenar alarmes em banco de dados Habilita ou desabilita o armazenamento dos dados dos
alarmes em um banco de dados. Este campo equivale
propriedade Logging
Servidor de Banco de Dados Define o servidor de Banco de Dados que armazena os
dados do alarme. Este campo equivale propriedade
DataSource
Nome da tabela Define o nome da tabela de alarmes. Este campo
equivale propriedade TableName
Descartar dados da tabela principal Habilita ou desabilita o descarte de dados da tabela
principal. O dado considerado antigo de acordo com o
que for definido na opo Descartar dados mais
antigos que. Este campo equivale propriedade
EnableDiscard
Descartar dados mais antigos que Determina o intervalo de tempo (minutos, horas, dias ou
meses) durante o qual os dados so mantidos na tabela
principal. Se um dado da tabela for mais antigo que o
intervalo de tempo desta opo, ele descartado. Este
campo equivale propriedade DiscardInterval e o
campo de seleo da unidade de tempo do intervalo
equivale propriedade DiscardTimeUnit
Realizar o descarte a cada Executa a verificao dos alarmes, conforme o perodo
especificado no campo (em minutos, horas, dias ou
meses). Este campo equivale propriedade
VerificationInterval e o campo de seleo da unidade
de tempo do intervalo equivale propriedade
VerificationUnit
236 Alarmes
OPO DESCRIO
Mover para a tabela de backup os dados descartados Habilita ou desabilita o armazenamento dos dados
descartados na tabela secundria (tabela de backup).
Este campo equivale propriedade EnableBackupTable
Descartar do backup dados mais antigos que Determina o intervalo mximo de tempo (minutos, horas,
dias ou meses) dos dados na tabela de backup at serem
descartados, independente do tempo que os dados
permanecem na tabela principal. Por exemplo, para
manter os dados por 24 meses na tabela principal e mais
seis meses na tabela de backup, o valor desta opo
deve ser de 30 meses. Este intervalo deve ser sempre
maior que o configurado no item Descartar dados mais
antigos que da tabela principal. Este campo equivale
propriedade BackupDiscardInterval e o campo de
seleo da unidade de tempo do intervalo equivale
propriedade BackupDiscardTimeUnit
Os campos disponveis no Servidor de Alarmes para gerao da tabela de alarmes esto descritos na tabela a seguir.
Campos disponveis para tabelas dos Campos dos alarmes
OPO DESCRIO
Acked Informa se o alarme foi reconhecido ou no. Este campo
pode assumir os valores 0: No reconhecido ou 1:
Reconhecido
AckRequired Determina o reconhecimento automtico do alarme. Este
campo apresenta os valores 0: Reconhecimento
automtico ou 1: Reconhecimento manual
AckTime Registra a data e hora do E3 no momento em que o
alarme reconhecido, ou zero (30/12/1899) enquanto o
alarme no for reconhecido. No caso de alarmes que no
pedem reconhecimento, o campo assume a data e hora
do E3 no momento em que o alarme se torna ativo
AckTimeDbl Semelhante ao campo anterior. usado para facilitar a
gravao de dados do tipo Double no caso de bancos de
dados Oracle ou SQL Server
ActorID Nome do operador que reconheceu o alarme. Pode ser:
O usurio logado no Viewer, quando o reconhecimento
feito no E3Alarm (ou "Sem usurio", se no h usurio
logado)
"System", quando o reconhecimento automtico, ou
seja, para alarmes que no pedem reconhecimento
Um nome passado por script (por exemplo, usando
AckArea, AckAllAlarms ou LogTrackingEvent do
Servidor de Alarmes, ou Ack da Fonte de Alarmes)
O limite deste campo, quando armazenado no Banco de
Dados, de 50 caracteres
AlarmSourceName Registra o nome da Fonte de Alarme. O limite deste
campo, quando armazenado no Banco de Dados, de
100 caracteres
Alarmes 237
OPO DESCRIO
Area Para eventos de alarme, o nome da rea qual a Fonte
de Alarmes pertence. Para outros eventos (por exemplo,
usando o mtodo LogTrackingEvent do Servidor de
Alarmes), pode ser um texto definido pelo usurio. O
limite deste campo, quando armazenado no Banco de
Dados, de 100 caracteres
238 Alarmes
OPO DESCRIO
EventTime Data e hora do valor da Fonte de Alarme no momento do
evento
EventTimeDbl Semelhante ao campo anterior. usado para facilitar a
gravao de dados do tipo Double no caso de bancos de
dados Oracle ou SQL Server
Alarmes 239
OPO DESCRIO
Severity o valor de severidade configurado na Fonte de Alarme.
Este campo pode assumir os valores 0: Alta, 1: Mdia ou
2: Baixa. Ele pode tambm assumir outro valor definido
pelo usurio se for um evento, como por exemplo quando
estiver usando o mtodo LogTrackingEvent
Source Para eventos de alarme, informa a expresso utilizada
para avaliar as condies de alarme. O limite deste
campo, quando armazenado no Banco de Dados, de
100 caracteres
SubConditionName Nome da sub-condio, se for um evento de alarme. Este
campo pode assumir os seguintes valores:
BM: Alarme de Banda Morta
DIG: Alarme Digital
TV: Alarme Taxa de Variao
LOLO: Alarme Analgico na faixa Muito Baixo
LO: Alarme Analgico na faixa Baixo
HI: Alarme Analgico na faixa Alto
HIHI: Alarme Analgico na faixa Muito Alto
Se o evento no for um alarme (por exemplo, ao utilizar o
mtodo LogTrackingEvent do Servidor de Alarmes), este
campo igual a uma String vazia. O limite deste campo,
quando armazenado no Banco de Dados, de 100
caracteres
Unbound Indica se este alarme no est vinculado a uma Fonte de
Alarme
Campos do Usurio So os campos definidos pelo usurio. Estes campos so
configurados na aba Campos do usurio, no Servidor de
Alarmes
NOTAS
necessrio que haja um Servidor de Alarmes no Domnio para que seja possvel o monitoramento de alarmes.
Os campos EventTimeMS, InTimeMS, OutTimeMS e AckTimeMS contm os valores em milissegundos dos
campos EventTime, InTime, OutTime e AckTime, respectivamente. Estes campos so usados quando for
necessrio registrar o tempo, em milissegundos, dos eventos em um servidor de bancos de dados Oracle.
Observe que estes campos no esto disponveis no E3Alarm, pois neste objeto possvel visualizar os
milissegundos atravs da formatao das colunas de data e hora.
Depois de definidas todas as configuraes, a aplicao inicializa a insero e gravao das informaes na tabela
dos alarmes, conforme as especificaes dos campos. Ao clicar em Gerar tabela, o Studio gera a tabela de dados
dos alarmes conforme as especificaes, e informa se a tabela foi gerada com sucesso.
240 Alarmes
Tabela de campos
Os campos gerados na tabela so explicados no tpico Configuraes da Tabela do captulo Histrico.
Atravs da janela de configurao do Servidor de Alarmes, pode-se especificar o Servidor de Banco de Dados
utilizado para a gravao dos alarmes. O Servidor de Banco de Dados (objeto DBServer) um mdulo do E3 que
deve ser inserido na aplicao.
Alarmes 241
OPO DESCRIO
Propagar? Fora a atualizao imediata de todos os alarmes que
herdam o valor deste Campo do Usurio, sempre que
este receber um valor forado ou se a Associao for
alterada
Adiciona um Campo do Usurio ao final da listagem
Remove o ltimo Campo do Usurio da listagem
Campos do Usurio s podem ser includos ou excludos ao final da listagem. A excluso de Campos de Usurio nesta
listagem se reflete em todas as reas e Fontes de Alarmes relacionadas a este Servidor de Alarmes, mas apenas se os
Campos removidos no tenham sido configurados com um valor forado ou uma Associao. Do contrrio, estes
Campos continuam aparecendo nas reas e Fontes de Alarme. A figura a seguir mostra um Alarme Analgico com os
Campos do Usurio herdados do Servidor de Alarmes.
242 Alarmes
CAPTULO
E3Alarm
14
O E3Alarm serve para monitoramento dos alarmes ativos ou no reconhecidos em uma aplicao. Atravs deste
objeto, possvel verificar o estado dos alarmes, bem como reconhec-los manualmente.
E3Alarm
Para utilizar este objeto, siga este procedimento:
1. Clique com o boto direito do mouse em uma Tela ou na rea de trabalho e selecione a opo Inserir - E3Alarm,
ou ento clique em E3Alarm na barra de ferramentas Objetos.
14.1 Configuraes
Para configurar o E3Alarm, clique com o boto direito do mouse no objeto e selecione a opo Propriedades.
E3Alarm 243
14.1.1 Aba Conexes
A aba Conexes permite configurar uma ou mais conexes a Servidores de Alarmes locais ou remotos.
Aba Conexes
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Conexes
OPO DESCRIO
Adiciona uma nova Conexo ao E3Alarm. Esta opo
corresponde ao mtodo Add da Coleo de Conexes
Remove a Conexo selecionada. Esta opo corresponde
ao mtodo Remove da Coleo de Conexes. NOTA: A
Conexo criada automaticamente com o E3Alarm no
pode ser removida
possvel acessar um Servidor de Alarmes remoto simplesmente preenchendo a propriedade AlarmServer do objeto
Conexo na Coleo de Conexes do E3Alarm com os dados do Domnio e do Servidor de Alarmes remotos, no
formato DOMINIO:SERVIDOR, onde SERVIDOR o nome do Servidor de Alarmes remoto e DOMINIO o nome do
Domnio Remoto que o contm. Para configurar o Domnio Remoto, veja o tpico Domnios Remotos no captulo
sobre Domnios.
244 E3Alarm
14.1.2 Aba Filtros
A aba Filtros permite gerenciar os filtros do E3Alarm.
Aba Filtros
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Filtros
OPO DESCRIO
Filtros Caixa de seleo com os Filtros atualmente disponveis
Ao clicar em Configurar, a janela da figura a seguir aberta para configurao do Filtro selecionado.
E3Alarm 245
Propriedades do Filtro selecionado
As opes disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na janela de propriedades de um Filtro
OPO DESCRIO
Nome Nome deste Filtro. Esta opo corresponde
propriedade FilterName
Filtrar por rea de Alarme Determina o filtro por rea de Alarme. Caso deseje
utilizar algum filtro, especifique-o neste campo, seno
deixe-o em branco. Esta opo equivale propriedade
AreaFilter
Filtro de rea Simples Se a opo Filtrar por rea de Alarme no estiver em
branco, esta opo habilitada e, se estiver selecionada,
a filtragem por rea baseada apenas na coincidncia
da parte inicial do nome. Caso contrrio, considera o
nome completo da rea. Esta opo equivale
propriedade SimpleAreaFilter
Utilizar filtro customizado Permite informar um filtro personalizado para os
alarmes. Esta opo corresponde propriedade
CustomFilter
Filtrar por tipo Habilita o tipo de filtro que aplicado no alarme
(Apenas alarmes, Apenas eventos ou Alarmes e
Eventos). Esta opo equivale propriedade FilterType
Filtrar por severidade Habilita ou desabilita a visualizao do grau da
severidade (Alta, Mdia ou Baixa). Esta opo equivale
s propriedades ShowHightPriority (Alta),
ShowMediumPriority (Mdia) e ShowLowPriority
(Baixa)
246 E3Alarm
Aba Colunas
A lista Campos disponveis mostra todos os campos da Fonte de Alarme. Clicando em Adicionar, pode-se
acrescentar campos individualmente no E3Alarm. Clicando em Propriedades, possvel configurar as propriedades do
campo do alarme.
Propriedades da coluna
As opes disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na janela Propriedades da coluna
OPO DESCRIO
Largura (pixels) Determina a largura da coluna, em pixels. A largura
padro das colunas do E3Alarm de 80 pixels
Formatador Determina o formatador utilizado na coluna do E3Alarm. O
formatador utilizado o padro do E3 (veja o tpico
Formatao de Valores), com exceo do campo
Severidade e dos campos Condio Ativa, Pede Ack,
Reconhecido e Habilitado, cujos exemplos de formatao
podem ser vistos nas tabelas a seguir
Renomear para Renomeia o ttulo da coluna
E3Alarm 247
OPO DESCRIO
NOTA: Se o alarme puder ser reconhecido, o formato do
cursor do mouse muda para , em tempo de execuo,
quando estiver sobre uma linha de alarme no
reconhecido
Esta coluna nunca pisca Habilita ou desabilita o piscar da coluna
Falso "AAA" No
Verdadeiro ; Sim
Falso ; No
Aba Ordenao
Cada campo da aba Ordenao possui uma propriedade correspondente. As propriedades disponveis esto
descritas na tabela a seguir.
248 E3Alarm
Opes disponveis na aba Ordenao
OPO DESCRIO
Pelo campo Ordena os alarmes conforme o campo especificado. Este
campo equivale propriedade PrimarySortField
NOTAS
A ordenao padro realizada atravs do campo InTime, de maneira descendente.
Caso a propriedade BannerMode esteja configurada para Verdadeiro, o alarme mostrado depende da
configurao realizada nesta aba.
Aba Cores
Clique em para selecionar a cor do tipo de alarme selecionado. A janela da figura a seguir mostrada.
E3Alarm 249
Cores do alarme selecionado
As opes disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na janela Cores
OPO DESCRIO
Cor de fundo Determina a cor de fundo do alarme. Esta opo
corresponde propriedade BackgroundColor do objeto
Cor do Alarme
Pisca apenas texto Quando selecionada, a cor do texto varia entre as cores
escolhidas para o texto e para o fundo. Esta opo
corresponde propriedade BlinkMode do objeto Cor
do Alarme configurada com o valor 2 (dois)
possvel tambm selecionar as cores por severidade, para cada tipo de alarme.
Cada um dos itens da listagem Configure as cores dos alarmes corresponde a uma propriedade do E3Alarm que
retorna um objeto Cor do Alarme, conforme a tabela a seguir.
Propriedades correspondentes s configuraes de cores dos alarmes
ITEM PROPRIEDADE
Alarme Ativo ColorActiveAlarm
As propriedades descritas na tabela anterior so indexadas, ou seja, na sua utilizao possvel especificar um ndice
que indica qual severidade pode ser configurada. Os valores possveis para os ndices destas propriedades so os
seguintes:
0: Severidade alta
1: Severidade mdia
2: Severidade baixa
-1: Configurao global do alarme (configura os valores que so utilizados caso a severidade no os
sobrescreva)
E3Alarm 251
NOTA
As propriedades ColorActiveAlarm, ColorAckedAlarm, ColorNAckAlarm e ColorActiveEvent s esto disponveis
via script. O objeto retornado por qualquer uma destas propriedades pode ser configurado utilizando o mtodo
SetConfig.
Aba Fonte
As opes disponveis so referentes a tipo, tamanho e efeitos da fonte.
NOTA
O nome da aba aparece no idioma do Windows, e no necessariamente no idioma do E3.
NOTA
Todas as opes do E3Alarm em tempo de execuo que esto disponveis via menu contextual (atravs do clique
com o boto direito do mouse) tambm esto disponveis utilizando a combinao de teclas SHIFT + F10, que
corresponde tecla de aplicao ou de menu .
E3Alarm em execuo
Dentre os alarmes que satisfazem os filtros configurados, so mostrados no E3Alarm aqueles que estiverem em
condio ativa ou no estiverem reconhecidos. De maneira geral, estes alarmes podem ser divididos em dois casos:
252 E3Alarm
Se a opo Pede Ack da Fonte de Alarme estiver em Falso, o alarme considerado reconhecido desde a sua
ativao, sem a necessidade de reconhecimento. Neste caso, o alarme permanece visvel at que saia da condio
ativa
Se a opo Pede Ack da Fonte de Alarme estiver em Verdadeiro, o usurio pode reconhecer o alarme antes ou
depois da varivel sair da condio de alarme. Em ambos os casos, o alarme s sai da lista do E3Alarm quando
as duas condies estiverem satisfeitas
A propriedade BannerMode, quando configurada para Verdadeiro, permite visualizar apenas uma mensagem de
alarme no objeto E3Alarm. A mensagem que mostrada depende da configurao realizada na aba Ordenao.
Reconhece todos os alarmes do filtro corrente Todos os alarmes visveis neste E3Alarm so
reconhecidos
A opo Reconhece apenas os alarmes selecionados s est disponvel se realmente houver alarmes
selecionados no E3Alarm. O usurio pode reconhecer o alarme (neste caso, inserido um novo registro no Banco
de Dados indicando o reconhecimento), e no E3Alarm a linha correspondente indica que este alarme foi
reconhecido. Esta opo est desabilitada caso a propriedade AllowAckSelected esteja configurada para Falso
A opo Reconhece todos os alarmes do filtro corrente s est disponvel se realmente houver alarmes visveis
no E3Alarm. possvel utilizar esta opo sem clicar em nenhum alarme. Para isto, clique em qualquer rea do
E3Alarm para mostrar a janela de Reconhecimento. Clicando nesta janela, a caixa de dilogo de reconhecimento
mostrada. Esta opo est desabilitada caso a propriedade AllowAckCurrentFilter esteja configurada para Falso
A opo Reconhece globalmente todos os alarmes est sempre disponvel, mesmo que no haja alarmes
visveis no E3Alarm. Esta opo est desabilitada caso a propriedade AllowAckAll esteja configurada para Falso
Ao selecionar a segunda opo, Deletar alarmes desvinculados, mostrada a caixa de dilogo da figura a seguir.
E3Alarm 253
Opes da janela Alarmes
Para esta opo, o nico item disponvel Globalmente todos os alarmes, ou seja, todos os alarmes que no
estejam vinculados a uma Fonte de Alarme so removidos. Esta opo do menu contextual do E3Alarm est
desabilitada caso a propriedade AllowDeleteUnboundAlarms esteja configurada para Falso.
NOTA
Um alarme considerado desvinculado quando est presente no sumrio de alarmes mas sua Fonte de Alarme foi
desativada. Esta desvinculao pode ocorrer em algumas situaes, como por exemplo:
Mudar o nome da Fonte de Alarme
Utilizar o mtodo Deactivate na Fonte de Alarme em um script
Remover a Fonte de Alarme
O reconhecimento de alarmes tambm pode ser executado atravs de um clique ou duplo-clique na linha do alarme.
Para isto, especifique nas propriedades da coluna desejada (janela de propriedades do E3Alarm, aba Colunas, opo
Propriedades) como deve ser executado o reconhecimento do alarme em tempo de execuo, com um ou dois
cliques na coluna.
Exemplo de ordenao
Na figura anterior, os alarmes esto ordenados primeiro por DataHora (Entrada), de forma descendente, e depois
por rea, tambm de forma descendente.
254 E3Alarm
14.2.4 Status das Conexes
A partir da verso 4.7, o E3Alarm permite visualizar o status das conexes configuradas na aba Conexes. Para
habilitar a barra de status, configure a propriedade ShowConnectionStatusBar do objeto E3Alarm na Lista de
Propriedades. A figura a seguir mostra a barra de status habilitada.
NOTA
O status indefinido indica que o E3Alarm no recebeu uma confirmao do Servidor de Alarmes de que a conexo
teve sucesso. Este o status padro para verses anteriores 4.7.
E3Alarm 255
CAPTULO
Storage
15
O Storage um mdulo alternativo de gravao dos dados histricos. Atravs dele possvel transformar dados de
produo, processos e outras coletas em informaes gerenciais. Este mdulo permite que diversas informaes
sejam coletadas atravs de servidores OPC, Drivers da Elipse, bancos de dados em geral, ou at mesmo arquivos de
texto e armazenamentos em banco de dados comerciais (Microsoft SQL Server e Oracle) por objetos histricos
definidos pelo usurio em uma forma compacta e eficiente.
O armazenamento das informaes segue a lgica de que um dado s gravado quando h uma variao
significativa, definida pelo usurio. A anlise das variaes feita pelo algoritmo BoxCar/BackSlope, que permite,
dependendo das bandas mortas configuradas, uma compactao significativa dos dados com a recuperao total das
informaes teis.
A recuperao dos dados no ambiente do E3 pode ser executada atravs de uma ferramenta de consulta
padronizada, que permite montar sua estrutura de consulta de forma grfica (similar ferramentas como Microsoft
Access ou SQL Server) ou ainda editar diretamente as consultas SQL. Os dados extrados podem ser visualizados em
formato tabular (E3Browser), grficos (E3Chart), relatrios que permitem visualizao em tela (usando o mtodo
PrintPreview do Relatrio), impresso direta para o papel, ou mesmo exportao para vrios formatos como
Acrobat PDF, HTML, TXT, CSV, TIFF e GIF, entre outros.
A principal funo do Storage permitir a gravao dos dados de forma compacta. Atravs desta ferramenta
possvel recuperar com grande exatido todas as mudanas nas variveis de processo, ocupando assim o mnimo de
espao no banco de dados. Alguns exemplos so mostrados nos tpicos a seguir.
256 Storage
Grfico com compactao
A gravao no Storage realizada da seguinte maneira:
Aps a definio da tabela nas propriedades do Storage, esta gerada clicando em Gerar Tabela e os dados
so gravados de acordo com estas definies. Se houver variao de qualidade no Tag, os dados tambm so
gravados
Os dados s no so gravados se a variao ocorreu em um tempo menor que o mnimo programado (campo
MinRecTime)
NOTA
O objeto Storage pode ser configurado para funcionar como rea de Alarme.
Storage 257
15.1 Configuraes
Quando o Storage criado na Tela, mostrada uma lista de definies dos Campos de gravao.
NOTA
As licenas de Storage so verificadas apenas quando o aplicativo executado e levam em conta apenas os Campos
ativos na aplicao, no a quantidade de Campos existentes no banco de dados.
Para efeitos de posterior consulta nos dados, toda a busca se d atravs do caminho do Tag ou propriedade que
est sendo armazenada, definido atravs da coluna Fonte. A coluna Nome s utilizada caso a coluna Fonte
contenha uma expresso (por exemplo, Driver1.Tag1 + Driver1.Tag2).
Logo, se expresses no estiverem sendo utilizadas na coluna Fonte, no h necessidade de se importar com o nome
do campo. As opes disponveis esto descritas na tabela a seguir.
Opes disponveis no Editor do Storage
OPO DESCRIO
Adicionar Adiciona Campos na tabela do Storage
258 Storage
OPO DESCRIO
MaxRecTime Diferena mxima, em segundos, entre as estampas de
tempo de dois registros consecutivos, isto , o tempo
mximo sem que nenhum dado seja gravado. Ao passar
este tempo, o dado considerado antigo e
armazenado. Esta opo corresponde propriedade
MaxRecTime do Campo do Storage
Storage 259
Aba Storage
Cada campo da aba Storage possui uma propriedade correspondente. As opes disponveis nesta aba esto
descritas na tabela a seguir.
Opes disponveis na aba Storage
OPO DESCRIO
Servidor de Banco de Dados Define o servidor de Banco de Dados. Este campo
equivale propriedade DbServer
Nome da tabela Determina o nome da tabela. Este campo equivale
propriedade TableName
260 Storage
OPO DESCRIO
Descartar do backup dados mais antigos que Determina o intervalo mximo de tempo (minutos, horas,
dias ou meses) dos dados na tabela de backup at serem
descartados, independente do tempo que os dados
permanecem na tabela principal. Por exemplo, para
manter os dados por 24 meses na tabela principal e mais
seis meses na tabela de backup, o valor desta opo
deve ser de 30 meses. Este intervalo deve ser sempre
maior que o configurado no item Descartar dados mais
antigos que da tabela principal. Este campo equivale
propriedade BackupDiscardInterval e o campo de
seleo da unidade de tempo do intervalo equivale
propriedade BackupDiscardTimeUnit
Gerar Tabela Gera a estrutura da tabela no Banco de Dados. Esta
opo tambm est disponvel clicando com o boto
direito do mouse no objeto Storage no Organizer e
selecionando a opo Gerar Estrutura no BD
Aps definir as configuraes da tabela, clique em Gerar Tabela. Esta ao cria a estrutura da tabela no banco de
dados.
A estrutura de tabelas do Storage semelhante estrutura do Histrico, com uma tabela de definies, uma tabela
principal de dados e uma tabela de backup (se selecionada pelo usurio). Para que se possa identificar externamente
que uma tabela compactada, verifique se foi criada a tabela _Fields.
Tabela de campos
Esta tabela possui os campos descritos na tabela a seguir.
Campos da tabela _Fields
CAMPO DESCRIO
FieldDeadBand Banda morta
Storage 261
CAMPO DESCRIO
FieldMaxRecTime Depois que este tempo expira, o dado deve ser
automaticamente gravado
FieldMinRecTime Valor mnimo de tempo de variao para armazenar
dados
FieldName Nome do campo
A implementao do Storage permite que o usurio no tenha que se preocupar em como os dados esto
armazenados nas tabelas. Entretanto, para uma melhor compreenso do funcionamento do mdulo, e tambm para
permitir acesso por outros programas, mostrado a seguir o formato das tabelas.
As opes de gerenciamento de tabelas especificadas no item anterior se aplicam na verdade a trs conjuntos de
tabelas geradas pelo Storage, de acordo com o campo Nome de Tabela.
Isto porque, para cada tipo de grandeza armazenada, gerado automaticamente um conjunto de tabelas, a saber: um
conjunto para os Tags analgicos, outro para os textos e mais outro para os digitais. Desta forma, cada Storage pode
gerenciar at sete tabelas, caso se especifique que os trs tipos de Tags devam ser armazenados:
<NomeTabela>_Fields
<NomeTabela>
<NomeTabela>_Text
<NomeTabela>_Bit
<NomeTabela>_Backup
<NomeTabela>_Text_Backup
<NomeTabela>_Dig_Backup
A tabela _Fields contm a descrio dos campos que so armazenados, que de forma geral armazenam as mesmas
informaes definidas na configurao dos campos do Storage, alm de associar um ndice automtico para cada
campo. As demais tabelas possuem um formato fixo:
E3TimeStamp: Campo que armazena a data e hora em que houve a variao do Tag. Caso o protocolo de
comunicao suporte o envio de informao de tempo, este campo contm o timestamp do equipamento
Qualidade: Contm a informao de qualidade do ponto (Ruim, Incerto ou Bom) de acordo com a utilizao
dentro do E3 e das normas OPC
ndice: Relaciona o campo gravado com o seu respectivo nome que est armazenado na tabela _Fields
Valor: Valor armazenado. Para a tabela de analgicos trata-se de um campo tipo Double (nmero real), j para a
tabela de digitais trata-se de um nmero inteiro e para os textos trata-se de um campo NVARCHAR de tamanho
varivel, especificado pelo usurio no campo StringFieldSize
15.2.1 Execuo
Ao iniciar a execuo do aplicativo e receber a primeira notificao de valor de cada uma das variveis armazenadas,
o Storage armazena este valor obtido com qualidade Ruim, e logo em seguida com a qualidade enviada, se esta for
Boa. Isto porque ao realizar a consulta, o usurio tem a visualizao de que houve uma interrupo no
armazenamento.
Depois, conforme sejam obtidos novos valores para as variveis, um algoritmo de verificao de gravao interpreta
a sequncia e decide se cada ponto ou no armazenado. Este algoritmo, conhecido como BoxCar/BackSlope, cria
duas bandas de variao (cuja amplitude dada pela banda morta da varivel) de um ponto gravado. A banda
horizontal (BoxCar) define uma verificao comum da banda morta. Uma segunda banda diagonal (BackSlope) define
uma variao para cima ou para baixo da banda morta.
262 Storage
Portanto, se a varivel est em uma derivativa contnua descendente ou ascendente, s necessrio armazenar os
pontos iniciais ou finais nesta linha reta. Assim, uma varivel analgica s gravada se o valor viola tanto a banda
horizontal quanto a vertical, ou se houve uma mudana na qualidade, ou seja, o equipamento foi ligado ou desligado.
Para todas as opes possvel indicar se os dados com qualidade Ruim so includos ou no no resultado, atravs
da caixa de seleo Incluir qualidade RUIM, correspondente propriedade IgnoreQuality da Consulta associada ao
objeto Storage.
Funes da Consulta
15.2.3 Utilizao
Se a funo selecionada possui algum filtro, ento necessrio informar o valor dos filtros antes de executar a
Consulta, seja na prpria caixa de dilogo de configurao (na aba Visualizar) ou atravs de script, usando o
mtodo SetVariableValue. Exemplo:
Set Chart = Screen.Item("E3Chart1")
Set Query = Chart.Item("Consulta1")
Query.SetVariableValue "StartTime", Chart.DataIni
Query.SetVariableValue "EndTime", Chart.DataFim
Query.SetVariableValue "TimeInterval",
264 Storage
rs.Fields("SampleInterval").Value
Chart.Queries.UpdateData
CompressedDataNValues E3NCompData
CompressedDataStartEndTime E3CompData
SampledData E3SampledData
CalculatedData E3CalculatedData
As Stored Procedures que utilizam parmetros de tipo Data recebem este parmetro na chamada como um nmero
Float (ponto flutuante), ao invs de DateTime. Isto permite aumentar a preciso do E3, j que ao utilizar o formato
DateTime a preciso mxima de 3ms, ao invs de 1ms com o tipo Float.
Para facilitar a passagem de parmetros, pode-se adicionar ao Banco de Dados uma funo do usurio que
transforma um valor DateTime em um Float, conforme o exemplo a seguir.
CREATE FUNCTION E3GETFLOATVALUE (@dDate datetime)
RETURNS FLOAT AS
BEGIN
RETURN CAST(@dDate AS float)
END
15.2.4.1 E3Archive
Retorna um valor armazenado em relao a um instante, conforme exposto na funo ArchivedValue. usada
somente para os sub-tipos Prev (0), Next (2) e ExactTime (3). A descrio formal a seguinte:
E3Archive(
@iSubType int,
@strTableName VARCHAR(100),
@dData float,
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@type int,
@bQuality int)
Onde:
@iSubType: Sub-tipo da funo (0: Prvio, 2: Prximo ou 3: Instante Exato)
@Data: Instante no tempo para a busca, no formato Float
Retorna uma consulta com apenas uma linha, com os campos E3TimeStamp, Quality e FieldValue. Exemplo de
utilizao:
DECLARE @MyDate FLOAT
SET @MyDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
EXECUTE E3Archive 0, 'STO22', @MyDate,
'Dados.TagDemo1', '', 2, 0
15.2.4.2 E3ArchiveInterpolate
Retorna os pontos imediatamente anteriores e posteriores a um instante, conforme exposto para a funo
ArchivedValue, porm somente para o Sub-tipo Interpolado. A descrio formal a seguinte:
E3ArchiveInterpolate(
@strTableName VARCHAR(100),
Storage 265
@dData float,
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@type int,
@bQuality int)
Onde:
@dData: Instante no tempo para a busca, no formato Float
Esta consulta retorna duas linhas, com os campos E3TimeStamp e FieldValue. Exemplo de utilizao:
DECLARE @MyDate FLOAT
SET @MyDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
EXECUTE E3ArchiveInterpolate 'STO22',
@MyDate, 'Dados.TagDemo1', '', 2, 0
15.2.4.3 E3CalculatedData
Equivale funo CalculatedData. A descrio formal a seguinte:
E3CalculatedData(
@iSubType int,
@strTableName VARCHAR(100),
@iModMin int,
@dStartDate float,
@dEndDate float,
@strFields VARCHAR(1000),
@strWhere VARCHAR(4000),
@type int,
@bQuality int)
Onde:
@iSubType: Sub-tipo do clculo (0: Total, 1: Mnimo, 2: Mximo, 3: Desvio Padro, 4: Amplitude, 5: Mdia ou
6: Mediana)
Exemplo de utilizao:
DECLARE @MyStartDate FLOAT
SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2004 12:00:00')
DECLARE @MyEndDate FLOAT
SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006 12:00:00')
EXECUTE E3CalculatedData 0, 'STOXX', 10,
@MyStartDate, @MyEndDate, 'Dados.TagDemo1', '', 2, 1
15.2.4.4 E3CompData
Equivale funo CompressedDataStartEndTime. A descrio formal a seguinte:
E3CompData(
@strTableName VARCHAR(100),
@dStartData float,
@dEndData float,
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@strOrder VARCHAR(100),
@type int,
@bQuality int)
Onde:
@dStartData: A data inicial, em formato Float
@dEndData: A data final, em formato Float
@strOrder: Quando desejar que a consulta seja ordenada por outro campo que no seja o TimeStamp
Esta funo retorna o nmero de linhas encontradas no intervalo, com os campos E3TimeStamp, Quality e
FieldValue. Exemplo de utilizao:
DECLARE @MyStartDate FLOAT
DECLARE @MyEndDate FLOAT
SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006 12:00:00')
EXECUTE E3CompData 'STO22', @MyStartDate,
@MyEndDate, 'Dados.TagDemo1', '', '', 2, 0
266 Storage
15.2.4.5 E3LastValue
Retorna o ltimo valor de um determinado Tag que est armazenado no Banco de Dados. A descrio formal a
seguinte:
E3LastValue(
@strTableName VARCHAR(100),
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@type int,
@bQuality int)
Onde:
@strTableName: Nome da tabela
@strFieldName: Nome do campo
@strFilter: Caso queira inserir opes de filtro para o valor
@type: Tipo de dado (0: String, 1: Bit ou Integer ou 2: Analgico)
@bQuality: Se diferente de 0 (zero), somente inclui Tags com qualidade Boa
Retorna uma consulta com apenas uma linha, com os campos E3TimeStamp, Quality e FieldValue. Exemplo de
utilizao:
EXECUTE E3LastValue 'TabelaXX',
'Tag234', '', 2, 1
15.2.4.6 E3NCompData
Equivale funo CompressedDataNValues. A descrio formal a seguinte:
E3NCompData(
@strTableName VARCHAR(100),
@dData float,
@strFieldName VARCHAR(100),
@iNValues int,
@strFilter VARCHAR(500),
@strOrder VARCHAR(100),
@type int,
@bQuality int)
Onde:
@iNValues: O nmero de valores desejado
@strOrder: Quando desejar que a consulta seja ordenada por outro campo que no seja o TimeStamp
Esta funo retorna o nmero de linhas solicitado, se encontrado, com os campos E3TimeStamp, Quality e
FieldValue. Exemplo de utilizao:
DECLARE @MyDate FLOAT
SET @MyDate = dbo.E3GETFLOATVALUE('10-10-2005 12:00:00')
EXECUTE E3NCompData 'STO22', @MyDate,
'Dados.TagDemo1', 20, '', '', 2, 0
15.2.4.7 E3SampledData
Equivale funo SampledData. A descrio formal a seguinte:
E3SampledData(
@strTableName VARCHAR(100),
@iModMin int,
@dStartDate float,
@dEndDate float,
@strFields VARCHAR(1000),
@strWhere VARCHAR(4000),
@type int,
@bQuality int)
Onde:
@iModMin: Intervalo em segundos para a interpolao de cada valor dentro do intervalo
@dStartData: A data inicial, em formato Float
Storage 267
@dEndData: A data final, em formato Float
@strFields: Lista de campos
Exemplo de utilizao:
DECLARE @MyStartDate FLOAT
SET @MyStartDate = dbo.E3GETFLOATVALUE('10-10-2004 12:00:00')
DECLARE @MyEndDate FLOAT
SET @MyEndDate = dbo.E3GETFLOATVALUE('10-10-2006 12:00:00')
EXECUTE E3SampledData 'STOXX', 10, @MyStartDate,
@MyEndDate, 'Dados.TagDemo1', '', 2, 1
268 Storage
CAPTULO
Histrico
16
Histricos so mdulos responsveis pelo armazenamento de dados da aplicao em um Banco de Dados. Permitem
armazenar dados de processos para anlises futuras. Pode-se criar tantos arquivos de Histricos quantos se desejar,
cada um contendo diversos Tags ou expresses. Cada Histrico pode criar ou utilizar uma tabela independente
dentro do Banco de Dados, cujo armazenamento pode ser definido por Tempo ou por Evento. Atravs da
propriedade CacheSize, define-se o nmero de registros enviados por vez para o Banco de Dados. Conforme a
definio da propriedade DBServer, define-se o Servidor do Banco de Dados que utilizado pelo Histrico. Para
utilizar este recurso, siga estes procedimentos:
1. Clique com o boto direito do mouse no nome do projeto no modo Explorer e selecione a opo Inserir -
Histrico. No modo Domnio, clique com o boto direito do mouse no item Objetos de Servidor - Banco de
Dados, selecione a opo Inserir Histrico em e logo aps o nome do projeto desejado.
Opes do Histrico
As opes disponveis neste Editor esto descritas na tabela a seguir.
Opes disponveis no Editor do Histrico
OPO DESCRIO
Adiciona campos na tabela do Histrico
Histrico 269
OPO DESCRIO
Remove o campo selecionado da tabela do Histrico
Determina as configuraes da tabela do Histrico
Gera a estrutura no Banco de Dados
Cria uma chave primria
Configura os ndices que so criados no Histrico
Mantm o Histrico sem vnculos diretos com a tabela
existente
Busca os campos na tabela original
Vincula o Histrico a uma tabela j existente
3. Abra a janela de propriedades do Histrico. Para isto, clique com o boto direito do mouse no objeto e selecione
a opo Propriedades. Algumas das propriedades deste objeto podem ser configuradas atravs da Lista de
Propriedades, sem a necessidade da criao de scripts para isto. Caso seja necessrio configurar alguma
propriedade, localize-a na Lista de Propriedades e faa os devidos ajustes. Demais informaes sobre as
funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referncia e Scripts do
E3, no captulo referente ao objeto Histrico.
NOTA
O objeto Histrico pode ser configurado para funcionar como rea de Alarme.
16.1 Configuraes
Quando um Histrico inserido no projeto, o campo E3TimeStamp criado automaticamente na tabela. O campo
E3TimeStamp mostra a data e hora em que o valor foi buscado (diferente do timestamp do Tag). Vale lembrar que
este campo utilizado somente para leitura. possvel associar um Tag ao campo E3TimeStamp. Se no houver
Associao, ele busca a hora atual do sistema para a gravao.
NOTA
O uso da hora atual do sistema para a gravao do campo E3TimeStamp s est disponvel quando a tabela
criada pelo Histrico. No caso de utilizar uma tabela j existente, necessrio associar um Tag do tipo Demo com a
propriedade Type configurada como 3 - Current Time para que este campo registre a data e hora corretamente.
Para criar a tabela no Histrico, importante que seus campos sejam previamente criados clicando-se em Adicionar
campo . Para remover algum campo indesejado, clique em Remover campo . A mensagem de confirmao da
figura a seguir mostrada.
A chave primria pode ser configurada de duas formas: verificando na tela do Histrico qual campo da tabela que se
pretende tornar chave primria, e habilitando-o atravs da opo ou clicando no cone , que abre a janela de
configurao, conforme a figura a seguir.
Garantir que os valores deste ndice sero nicos Faz com que os valores especificados para o ndice
Chave Primria sejam nicos. Esta opo est sempre
marcada para Chaves Primrias, no podendo ser
modificada
Nome do campo Mostra o nome do campo
Mude a ordem dos campos Muda a posio do campo na tabela, fazendo com que
ele suba ou desa
Histrico 271
Clicando em OK, confirma-se que o campo determinado uma chave primria da tabela. Para cancelar a
configurao, clique em Cancelar. Pode-se tambm atribuir um ndice tabela.
16.1.2 ndices
Um ndice um campo ou conjunto de campos que so previamente ordenados pelo Banco de Dados, a fim de
melhorar a performance das consultas que utilizam este ndice. Eles so utilizados para encontrar registros com um
valor especfico em uma coluna rapidamente. Sem um ndice, o Banco de Dados tem de iniciar com o primeiro registro
e depois ler atravs de toda a tabela at que encontre os registros relevantes. Quanto maior a tabela, maior o custo
desta operao. Se a tabela possuir um ndice para as colunas em questo, o Banco de Dados pode rapidamente
obter uma posio para procurar no meio do arquivo de dados sem ter que varrer todos os registros. Por exemplo,
se uma tabela possui 1.000 registros, isto pelo menos 100 vezes mais rpido do que ler todos os registros
sequencialmente. Note que, se for preciso acessar quase todos os 1.000 registros, mais rpido acess-los
sequencialmente, pois isto evita acessos ao disco.
Os tipos de ndices disponveis so os seguintes: Primrio, nico e Index.
Todos os tipos de colunas da tabela podem ser indexadas. O uso de ndices nas colunas relevantes a melhor forma
de melhorar a performance da tabela. O nmero mximo de ndices por tabelas e o tamanho mximo de um ndice
definido pelo mecanismo de armazenamento do Servidor de Banco de Dados.
Pode-se criar ndices em mltiplas colunas. Um ndice de mltiplas colunas pode ser considerado um vetor ordenado
contendo valores que so criados concatenando-se valores de colunas indexadas.
Os ndices podem ser configurados atravs do cone , que abre a janela de configurao, conforme a figura a
seguir.
272 Histrico
Janela Adio de ndices
As opes disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na janela Adio de ndices
OPO DESCRIO
Nome do ndice Determina o nome do ndice
Garantir que os valores deste ndice sero nicos Se habilitada, faz com que os valores especificados para
o ndice sejam nicos
Mude a ordem dos campos Muda a posio do campo na tabela, fazendo com que
ele suba ou desa
Clicando em OK, os ndices na tabela so confirmados. Para cancelar a configurao, clique em Cancelar.
Histrico 273
Aba Histrico
Cada campo da aba Histrico possui uma propriedade correspondente. As opes disponveis nesta aba esto
descritas na tabela a seguir.
Opes disponveis na aba Histrico
OPO DESCRIO
Servidor de Banco de Dados Define o servidor de Banco de Dados. Este campo
equivale propriedade DbServer
274 Histrico
OPO DESCRIO
Mover para a tabela de backup os dados descartados Habilita ou desabilita o armazenamento dos dados
descartados na tabela secundria (tabela de backup).
Este campo equivale propriedade EnableBackupTable
Descartar do backup dados mais antigos que Determina o intervalo mximo de tempo (minutos, horas,
dias ou meses) dos dados na tabela de backup at serem
descartados, independente do tempo que os dados
permanecem na tabela principal. Por exemplo, para
manter os dados por 24 meses na tabela principal e mais
seis meses na tabela de backup, o valor desta opo
deve ser de 30 meses. Este intervalo deve ser sempre
maior que o configurado no item Descartar dados mais
antigos que da tabela principal. Este campo equivale
propriedade BackupDiscardInterval e o campo de
seleo da unidade de tempo do intervalo equivale
propriedade BackupDiscardTimeUnit
Mensagem do sistema
Quando a opo Gerar Tabela utilizada, a tabela especificada no Histrico gerada, alm de uma tabela _Fields.
Esta tabela possui as informaes de cada campo cadastrado no Histrico.
Tabela de campos
Os campos disponveis na tabela _Fields do Histrico esto descritos na tabela a seguir.
Campos da tabela _Fields do Histrico
CAMPO DESCRIO
FieldDeadBand Banda morta
Histrico 275
CAMPO DESCRIO
FieldDeadBandUnit Unidade utilizada pela banda morta (em valores
absolutos ou em porcentagem)
FieldDescription Descrio do campo
A opo Vincular Histrico vincula o Histrico a tabelas existentes no Banco de Dados. Quando esta opo
habilitada, o Studio abre uma caixa de dilogo para determinar quais as tabelas so vinculadas ao Histrico corrente,
conforme a figura a seguir.
276 Histrico
Mensagem do sistema
Clicando em Cancel, os campos configurados na tabela permanecem com as configuraes atuais. J clicando em OK,
todos os campos, ndices e chaves primrias definidas no Histrico so substitudos pelos dados da tabela
selecionada.
Quando este item utilizado, outras duas opes so habilitados: Manter Histrico sem vnculos diretos com
tabela existente e Buscar campos da tabela original .
Quando a opo Manter Histrico sem vnculos diretos com tabela existente habilitada, o Studio mostra a
mensagem da figura a seguir.
Histrico aps habilitar a opo Manter histricos sem vnculo direto com a tabela existente
J a opo Buscar campos da tabela original recupera os dados do Histrico vinculado tabela existente, que
haviam sido apagados.
Histrico 277
CAPTULO
Consultas
17
O objeto Consulta (ou Query) auxilia no processo de definio de consultas no Banco de Dados da aplicao. Toda
vez que os objetos E3Browser ou Relatrio buscam dados de um Banco de Dados, necessrio enviar um comando,
de forma que se saiba quais os dados desejados para aquele objeto. Logo, toda vez que uma aplicao precisar
gravar ou buscar dados armazenados em um Banco de Dados, so enviados comandos no formato SQL (Structured
Query Language). A Consulta apresenta uma interface amigvel, que permite a construo das consultas em uma forma
grfica e o acompanhamento imediato da sintaxe SQL que est sendo gerada. A consulta permite mostrar os dados
dos ltimos N dias, horas ou meses, data final ou inicial e consultas.
O Assistente da consulta responsvel por criar o texto que executa o filtro ou a consulta, no sendo necessrio para
o usurio saber detalhes como data, etc. Para utilizar este recurso, siga estes procedimentos:
1. Clique com o boto direito do mouse em uma Tela do projeto e selecione a opo Inserir - Standard - Consulta.
NOTA
Quando criado um objeto Relatrio ou E3Browser, o objeto Consulta adicionado automaticamente a estes
objetos. No entanto, tambm pode-se inserir este objeto em uma Pasta de Dados, em uma Tela, em um Viewer ou
em uma Pasta do Viewer. Para maiores detalhes, veja os captulos correspondentes.
2. Antes de definir a Consulta, deve-se informar em qual Servidor de Banco de Dados a Consulta busca os dados.
Para tanto, selecione o servidor na caixa de listagem Nome do Servidor.
278 Consultas
Configuraes da Consulta
Para verificar quais as configuraes necessrias da Consulta, veja os captulos Relatrios e E3Browser.
Algumas das propriedades da Consulta podem ser configuradas atravs da Lista de Propriedades, sem a necessidade
de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de Propriedades e faa os
devidos ajustes. Para maiores informaes, consulte o Manual de Referncia e Scripts do E3.
Consultas 279
Adio de tabela
3. Selecione as tabelas que fazem parte da consulta e clique em OK.
4. Depois de definidas as tabelas, a janela de definio da Consulta mostrada, contendo as quatro abas a seguir:
Campos
Variveis
Visualizar
SQL
Configurao da Consulta
Estas abas so descritas nos prximos tpicos.
280 Consultas
Inserindo uma tabela
Para selecionar todos os campos da tabela para que faam parte da Consulta, selecione o primeiro item da lista de
seleo, correspondente ao smbolo * (asterisco). Para adicionar um campo especfico, selecione sua caixa de seleo
correspondente.
Selecionando campos de
uma tabela
Devido questes de performance, importante adicionar Consulta somente campos que realmente interessam
para a anlise.
Na rea de colunas, os campos escolhidos so mostrados.
rea de colunas
Cada coluna mostra propriedades para cada campo da tabela ou tabelas selecionadas, conforme a tabela a seguir.
Consultas 281
Opes disponveis para a configurao de colunas
OPO DESCRIO
Colunas Mostra o nome das colunas selecionadas. Ao clicar na
caixa de combinao de cada linha, pode-se redefinir a
coluna desejada
Ao definir um filtro, a janela da figura a seguir mostrada, permitindo que se defina o tipo de comparao e o valor a
ser comparado.
Definindo um filtro
O tipo de dado de comparao pode ser definido ao clicar na caixa de seleo correspondente e selecionar um dos
tipos na lista de opes.
282 Consultas
Configuraes para a definio do filtro
O valor de comparao pode ser uma constante (por exemplo, 123, 45, "ABCD", etc.) ou uma varivel definida pelo
usurio. Para criar uma varivel, informe um nome qualquer entre os seguintes smbolos:
<% %> se o valor for numrico
'<% %>' se o valor for uma String
#<% %># se o valor for uma data
O valor da varivel pode ser definido na aba Variveis ou atravs do mtodo SetVariableValue, via script.
Aba Variveis
As colunas desta aba so descritas na tabela a seguir.
Consultas 283
Opes disponveis na aba Variveis
OPO DESCRIO
Nome O nome da varivel definida pelo usurio
Visualizao da Consulta
284 Consultas
Aba SQL
Ao desmarcar a opo Habilita edio direta do SQL, todas as alteraes so perdidas e a Consulta retorna s
opes selecionadas nas abas Campos, Variveis e Visualizar.
O mtodo Requery possibilita que os novos parmetros de Consulta seja realmente utilizados, visto que uma nova
Consulta executada respeitando estes novos valores.
A varivel RS assume todas as caractersticas de um Recordset. A vantagem do uso deste recurso que se forem
feitas modificaes nas propriedades do banco de dados, no necessrio ajustar cada um dos scripts que acessam
este banco de dados.
Consultas 285
CAPTULO
E3Browser
18
O E3Browser um controle ActiveX utilizado para visualizar dados armazenados em Bancos de Dados. Pode-se
configurar consultas utilizando filtros de vrios tipos nos dados e atribuir cores para cada coluna, entre outras
configuraes. Este objeto utilizado para visualizar os Histricos, alarmes ou qualquer tabela existente no Banco de
Dados.
E3Browser
Para utilizar este recurso, siga estes procedimentos:
1. Insira um E3Browser no projeto clicando com o boto direito do mouse na rea de trabalho e selecionando o
item Inserir - E3Browser.
2. O E3Browser utiliza o objeto Consulta para auxiliar o usurio no processo de definio de consultas no Banco de
Dados da aplicao. Para maiores informaes, consulte o captulo referente.
3. Caso necessite, configure as propriedades do E3Browser. Algumas das propriedades deste objeto podem ser
configuradas atravs da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa os devidos ajustes. Demais informaes
sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referncia e
Scripts do E3, em seu captulo respectivo.
NOTA
Um E3Browser no pode carregar consultas que se encontrem no servidor.
A aba Consulta mostra os campos disponveis na consulta. Tais campos podem ser acessados clicando-se em
Configurar, que abre o assistente de configurao da consulta.
Aba Consulta
Para maiores informaes sobre a Consulta, veja o captulo Consultas.
E3Browser 287
18.2.1 Aba Estilo
Atravs da aba Estilo pode-se definir a aparncia das divises (grade) das clulas e dimenses das linhas e colunas.
Aba Estilo
Cada campo da aba Estilo possui uma propriedade correspondente. As propriedades disponveis esto descritas na
tabela a seguir.
Opes disponveis na aba Estilo
OPO DESCRIO
Estilo da grade Determina o estilo da grade do E3Browser. Este campo
equivale propriedade GridLinesType do E3Browser
Altura do cabealho Determina a altura, em pixels, do cabealho do
E3Browser. Este campo equivale propriedade
FixedRowHeight do E3Browser
Largura da 1 coluna Determina a largura da primeira coluna na tabela. Este
campo equivale propriedade FixedColumnWidth do
E3Browser
Altura das Linhas Determina a altura das linhas restantes na tabela. Este
campo equivale propriedade RowHeight do E3Browser
Largura das Colunas Determina a largura das colunas da tabela. Este campo
equivale propriedade ColumnWidth do E3Browser
288 E3Browser
Aba Opes
Cada campo da aba Opes possui uma propriedade correspondente. As propriedades disponveis esto descritas
na tabela a seguir.
Opes disponveis na aba Opes
OPO DESCRIO
Informe o intervalo de tempo em que os dados sero Determina o intervalo de tempo em que os dados so
atualizados atualizados. Este valor deve ser superior a 1000 ms. Este
campo equivale propriedade RefreshTime do
E3Browser
Informe qual ser o tipo de seleo Determina o tipo de seleo na tabela do E3Browser.
Este campo equivale propriedade SelectRow do
E3Browser
Aba Cor
As opes disponveis deste item esto descritas na tabela a seguir.
E3Browser 289
Opes disponveis da aba Cor
OPO DESCRIO
Propriedades (Properties) Determina a cor conforme a propriedade selecionada
Conjunto de Cores (Color Set) Determina o conjunto de cores a ser utilizado: Cores
padro ou Cores do Windows
Editar Cor Personalizada (Edit Custom Color) Edita uma nova cor personalizada, diferente das cores
padro
NOTA
O nome da aba aparece no idioma do Windows, e no necessariamente no idioma do E3.
Aba Fonte
As opes disponveis so referentes a tipo, tamanho e efeitos da fonte.
NOTA
O nome da aba aparece no idioma do Windows, e no necessariamente no idioma do E3.
290 E3Browser
CAPTULO
E3Chart
19
O E3Chart um componente ActiveX criado especialmente para trabalhar em conjunto com o E3. Com ele, possvel
exibir grficos mostrando Tags variando em tempo real, bem como dados histricos gravados em um Banco de
Dados.
O E3Chart composto por vrias colees. Uma coleo (collection) um objeto especial que gerencia um conjunto
de objetos semelhantes. O E3Chart possui as seguintes colees:
Coleo de Penas: Gerencia o conjunto de Penas criadas para manipular a sequncia de dados representada no
E3Chart
Coleo de Eixos: Gerencia os Eixos do E3Chart, onde podem ser configuradas diferentes escalas a serem
associadas aos dados das Penas
Coleo de Consultas: Gerencia as consultas com informaes sobre as Penas (por exemplo, no caso de grficos
que mostram dados histricos que j foram gravados em um Banco de Dados)
Coleo de Legendas: Gerencia as colunas da Legenda do E3Chart, onde so mostradas as informaes sobre as
Penas
2. Caso seja necessrio, configure as propriedades do E3Chart. Algumas das propriedades deste objeto podem ser
configuradas atravs da Lista de Propriedades, sem a necessidade da criao de scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faa os devidos ajustes. Demais informaes
sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referncia e
Scripts do E3, em seu captulo correspondente.
19.1 Configuraes
Para configurar um E3Chart, clique com o boto direito do mouse no objeto e selecione a opo Propriedades.
E3Chart 291
19.1.1 Abas Item, Posio e Geral
Atravs da aba Item, possvel visualizar o nome do objeto e atribuir-lhe uma descrio.
Aba Item
Cada campo da aba Item possui uma propriedade correspondente. As opes disponveis esto descritas na tabela a
seguir.
Opes disponveis na aba Item
OPO DESCRIO
Nome Determina o nome do objeto. Esta opo equivale
propriedade Name do E3Chart
Aba Posio
Cada campo da aba Posio possui uma propriedade correspondente. As opes disponveis esto descritas na
tabela a seguir.
292 E3Chart
Opes disponveis na aba Posio
OPO DESCRIO
X Define a coordenada horizontal esquerda do objeto, em
unidades Himetric. Esta opo equivale propriedade X
do E3Chart
Aba Geral
Cada campo da aba Geral possui uma propriedade correspondente. As opes disponveis esto descritas na tabela
a seguir.
Opes disponveis na aba Geral
OPO DESCRIO
Mostrar ttulo Exibe o ttulo do grfico. Esta opo equivale
propriedade Title do E3Chart
Mostrar ttulo com a cor Determina a cor do texto do ttulo do grfico. Esta opo
equivale propriedade TitleColor do E3Chart
Mostrar borda Habilita ou desabilita uma borda externa no E3Chart,
quando a visualizao das escalas est desabilitada. Esta
opo equivale propriedade ShowBorder do E3Chart
Mostrar o fundo do grfico com a cor Determina a cor de fundo do grfico. Esta opo
equivale propriedade BackColor do E3Chart
Mostrar o fundo da grade com a cor Determina a cor de fundo da grade do grfico. Esta
opo equivale propriedade GridBackColor do E3Chart
Intervalo entre as atualizaes (segundos) Determina o intervalo entre as atualizaes do desenho
no grfico. Esta opo equivale propriedade
RefreshTime do E3Chart
E3Chart 293
19.1.2 Aba Eixos
O objeto Coleo de Eixos representa o conjunto de Eixos contidos no E3Chart. Os Eixos so escalas colocadas no
contorno da grade do E3Chart.
Atravs da aba Eixos possvel adicionar e remover Eixos da Coleo de Eixos, bem como configurar suas
propriedades individualmente.
Aba Eixos
Quando o E3Chart criado, dois Eixos principais so criados automaticamente: Eixo Horizontal e Eixo Vertical. Estes
so os Eixos padro, e no podem ser removidos. Ao clicar em Adicionar, criado um novo Eixo no grfico e aberta
uma janela de configurao que permite determinar as propriedades do objeto Eixo. Esta janela possui as abas Geral,
Escala e Referncia Visual, e tambm pode ser aberta ao clicar em Configurar.
A aba Geral contm a informao que identifica a Pena no sistema.
294 E3Chart
Aba Geral
Cada campo da aba Geral possui uma propriedade ou mtodo correspondente. As opes disponveis esto
descritas na tabela a seguir.
Opes disponveis na aba Geral
OPO DESCRIO
Nome Determina o nome do Eixo do grfico. Esta opo
equivale propriedade Name do Eixo
Posio Determina a posio do Eixo no grfico: Direita ou
Esquerda (Eixo vertical), Base ou Topo (Eixo horizontal).
Esta opo equivale propriedade Position do Eixo
Espelhar o eixo Mostra o Eixo tambm do lado oposto ao escolhido,
com efeito de espelho. Esta opo equivale
propriedade Mirror do Eixo
Ttulo do eixo Determina o ttulo do Eixo. Esta opo equivale
propriedade Title do Eixo
Cor da escala Determina a cor da escala. Esta opo corresponde
propriedade Color do objeto Eixo
Visvel Determina a visibilidade do Eixo no grfico. Esta opo
equivale propriedade Visible do Eixo
Texto na cor da escala Determina se a cor do texto do Eixo tem a mesma cor da
escala. Esta opo equivale propriedade
EnableTextColor do Eixo
Cor das linhas da grade Determina a cor das linhas na grade. Esta opo equivale
propriedade GridColor do Eixo
Estilo da linha Determina o estilo da linha da grade do grfico. Esta
opo equivale propriedade GridStyle do Eixo
E3Chart 295
OPO DESCRIO
Mostrar as linhas na grade Habilita a visualizao das linhas na grade. Esta opo
equivale propriedade ShowGrid do Eixo
Intervalo entre divises Determina o intervalo entre os marcadores da escala,
caso a opo Automtico esteja desabilitada. Se a
escala no for numrica, possvel selecionar a unidade
de tempo a que este intervalo se refere. Esta opo
equivale ao mtodo SetTickSpacing do Eixo
Automtico Seleciona automaticamente o intervalo entre os
marcadores da escala. Esta opo equivale ao mtodo
SetTickSpacing do Eixo, com 0 (zero) no valor do
intervalo
Nmero de subdivises Determina o nmero de subdivises entre os
marcadores. Esta opo equivale propriedade
MinorTicks do Eixo
Clique em Aplicar para visualizar as modificaes realizadas nesta aba e em OK para salv-las.
A aba Escala define as configuraes da escala do Eixo.
Aba Escala
Cada campo da aba Escala possui uma propriedade ou um mtodo correspondente. As opes disponveis esto
descritas na tabela a seguir.
296 E3Chart
Opes disponveis na aba Escala
OPO DESCRIO
Escala numrica Define o Eixo como sendo uma escala numrica. Esta
opo equivale propriedade ScaleType do Eixo. As
opes de configurao da escala numrica so as
seguintes:
Mnimo: Determina o valor mnimo da escala numrica.
Este campo equivale ao mtodo SetMinMax do Eixo
Mximo: Determina o valor mximo da escala numrica.
Este campo equivale ao mtodo SetMinMax do Eixo
Mostrar ltimo perodo (tempo real) Mostra o intervalo de tempo que o Eixo mostra, sempre
em relao hora atual. Esta opo equivale ao mtodo
SetRealTimePeriod do Eixo
Clique em Aplicar para visualizar as modificaes realizadas nesta aba e em OK para salv-las.
A aba Referncia Visual define as informaes visuais para as linhas e bandas de referncia de um Eixo.
E3Chart 297
Aba Referncia Visual
Cada campo da aba Referncia Visual possui uma propriedade correspondente. As opes disponveis nesta aba
esto descritas na tabela a seguir.
Opes disponveis na aba Referncia Visual
OPO DESCRIO
Valor de referncia Define o valor usado como referncia para a linha. Este
valor se refere ao eixo x ou y, dependendo se a escala
vertical ou horizontal. Esta opo corresponde
propriedade ReferenceLineValue
Cor da linha Define a cor da linha de referncia. Esta opo
corresponde propriedade ReferenceLineColor
Estilo do trao Define o estilo do trao da linha de referncia. Os valores
possveis para esta opo so Slida, Tracejada,
Pontilhada, Trao-Ponto e Trao-Ponto-Ponto. Esta
opo corresponde propriedade ReferenceLineStyle
Espessura da linha Define a espessura da linha de referncia. Os valores
possveis para esta opo vo de 0 (zero) a 11 pixels.
Esta opo corresponde propriedade
ReferenceLineWidth
Visvel Indica se a linha de referncia est visvel ou no. Esta
opo corresponde propriedade ReferenceLineVisible
Valor superior Define o valor superior da banda de referncia. Esta
opo corresponde propriedade
NormalBandHighValue
298 E3Chart
OPO DESCRIO
Valor inferior Define o valor inferior da banda de referncia. Esta
opo corresponde propriedade
NormalBandLowValue
Cor de fundo Define a cor da banda de referncia. Esta opo
corresponde propriedade NormalBandColor
Clique em Aplicar para visualizar as modificaes realizadas nesta aba e em OK para salv-las. A figura a seguir
mostra uma referncia visual configurada no Eixo Vertical, com os seguintes valores:
Valor de referncia: 0 (zero)
Cor da linha: Preto (RGB(0, 0, 0))
Estilo do trao: Slido
Espessura da linha: 2 (dois) pixels
Valor superior: 50
Valor inferior: -50
Cor de fundo: Prata (RGB(192, 192, 192))
E3Chart 299
Aba Penas
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Penas
OPO DESCRIO
Adicionar Pena Adiciona uma Pena. Mostra um menu que permite
selecionar o tipo de Pena a ser criada: Tempo Real,
Histrica ou Tempo Real & Histrica
Mover Pena para cima Move a Pena selecionada uma posio para cima (esta
operao s permitida se apenas uma Pena estiver
selecionada)
Mover Pena para baixo Move a Pena selecionada uma posio para baixo (esta
operao s permitida se apenas uma Pena estiver
selecionada)
A listagem de Penas do E3Chart permite copiar e colar Penas, tanto no mesmo E3Chart quanto entre E3Charts
diferentes. Clique com o boto direito do mouse na Pena desejada (ou nas Penas selecionadas, em caso de mltipla
seleo) e selecione a opo Copiar (CTRL + C). No E3Chart de destino, abra a janela de Propriedades e, na aba
Penas, clique com o boto direito do mouse na listagem de Penas e selecione a opo Colar (CTRL + V). A opo de
Recortar a Pena (CTRL + X) tambm est presente. No caso de o E3Chart de destino j possuir uma Pena com o
mesmo nome da Pena sendo copiada, o nome automaticamente incrementado.
NOTA
Todas as opes das Penas selecionadas que esto disponveis via menu contextual (atravs do clique com o boto
direito do mouse) tambm esto disponveis utilizando a combinao de teclas SHIFT + F10, que corresponde tecla
de aplicao ou de menu .
Algumas propriedades da Pena podem ser configuradas diretamente na lista mostrada na aba Penas. Na coluna
Estilo, ao clicar em , a janela da figura a seguir mostrada.
300 E3Chart
Estilo da Pena
As opes disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na janela Estilo da Pena
OPO DESCRIO
Cor principal Define a cor da linha da Pena. Equivale propriedade
Color
Cor do fundo Define a cor de fundo usada em uma Pena do tipo rea.
Equivale propriedade BkColor
Ao selecionar uma Pena e clicar em , a janela de Propriedades da Pena mostrada. Esta janela possui cinco abas:
Geral, Dados, Estilo, Modo de Ligao e Estatsticas.
A aba Geral contm as informaes que identificam a Pena no E3Chart.
E3Chart 301
Aba Geral
Cada campo da aba Geral possui uma propriedade correspondente. As opes disponveis esto descritas na tabela
a seguir.
Opes disponveis na aba Geral
OPO DESCRIO
Nome da Pena Indica o nome da Pena. Esta opo equivale
propriedade Name da Pena
302 E3Chart
Aba Dados
Cada campo da aba Dados possui uma propriedade correspondente. As opes disponveis esto descritas na tabela
a seguir.
Opes disponveis na aba Dados
OPO DESCRIO
Tipo de pena Determina o tipo de Pena sendo utilizada. Esta opo
equivale propriedade DataSourceType da Pena
Link do eixo vertical Nome da Associao usada para plotar o dado em uma
escala vertical. Esta opo equivale propriedade YLink
da Pena
Link do eixo horizontal Nome da Associao usada para plotar o dado em uma
escala horizontal. Esta opo equivale propriedade
XLink da Pena
Nmero de amostras mantidas na memria Determina o nmero de amostras nas Penas de tempo
real. Esta opo equivale propriedade BufferSize da
Pena
Usar a estampa de tempo Habilita ou desabilita a estampa de tempo. A estampa de
tempo o valor de tempo que acompanha o valor do
Tag, indicando o momento em que este valor foi
alterado. Esta opo equivale propriedade
UseTimeStamp da Pena. Se esta opo estiver
habilitada, a opo Link do Eixo Horizontal permanece
inativa
Consulta local Determina a Consulta vinculada ao E3Chart que
utilizada nos dados do Eixo. Esta opo equivale
propriedade QueryName da Pena
E3Chart 303
OPO DESCRIO
Consulta externa Determina a consulta externa, isto , os dados vm de
uma consulta fora do objeto E3Chart
Campo do eixo vertical Nome do campo da Consulta usado para plotar o dado
em uma escala vertical. Esta opo equivale
propriedade YField da Pena
Campo do eixo horizontal Nome do campo da Consulta usado para plotar o dado
em uma escala horizontal. Esta opo equivale
propriedade XField da Pena
Usar consulta automtica Indica se a Pena deve ou no usar consulta automtica. A
consulta automtica no utilizada se o E3Chart estiver
utilizando um cdigo SQL personalizado, se estiver
usando um Storage ou se possuir vrias tabelas. Esta
opo equivale propriedade AutoQuery da Pena
Eixo vertical Especifica o Eixo vertical. Esta opo equivale
propriedade ScaleY da Pena
Aba Estilo
Cada campo da aba Estilo possui uma propriedade correspondente. As opes disponveis esto descritas na tabela
a seguir.
304 E3Chart
Opes disponveis na aba Estilo
OPO DESCRIO
Tipo de desenho Indica o tipo de desenho da Pena. Esta opo equivale
propriedade PenType da Pena
Cor de fundo do alarme Cor do fundo da Pena quando em alarme. Esta opo
equivale propriedade LimitPenBkColor
E3Chart 305
O modo como a Pena apresentada quando o scan
considerado representado pela cor verde e quando
este campo est desabilitado representado pelas cores
azul e rosa
A aba Modo de Ligao determina o estilo da ligao entre a parte histrica e a parte de tempo real de uma Pena
mista.
306 E3Chart
OPO DESCRIO
Valor considerado para o scan (ms) Define o tempo de leitura esperado do Tag da Pena de
tempo real. Se este valor for igual a 0 (zero), o E3Chart
desenha apenas os pontos realmente recebidos da fonte
(Tag). Para valores diferentes de 0 (zero), o E3Chart pode
criar pontos virtuais enquanto o valor no for recebido
da fonte e o tempo de scan for excedido. Esta opo
equivale propriedade ScanValue da Pena
Mostrar os pontos de qualidade ruim Define se mostra ou no os pontos de qualidade ruim.
Equivale propriedade ShowBadPoints da Pena
Intervalo mximo para ligar os dados histricos aos Especifica um tempo limite a ser considerado para a
de tempo real (s) conexo visual entre a parte histrica e a parte de tempo
real de uma Pena mista. Corresponde propriedade
MaxGapTime
Realar linha quando MaxGapTime usado Reala a linha de ligao entre a parte histrica e a parte
de tempo real. Corresponde propriedade
HighlightMaxGapTime da Pena
Cor da linha usada com MaxGapTime Especifica a cor da linha de ligao. Corresponde
propriedade MaxGapTimeColor da Pena
Estilo da linha usada com MaxGapTime Especifica o estilo da linha de ligao. Corresponde
propriedade MaxGapTimeStyle da Pena
Aba Estatsticas
Cada campo da aba Estatsticas possui uma propriedade correspondente. As opes disponveis esto descritas na
tabela a seguir.
E3Chart 307
Opes disponveis na aba Estatsticas
OPO DESCRIO
Calcular dados estatsticos Habilita o clculo de dados estatsticos
Mostrar linha da mdia Exibe a linha da mdia dos dados estatsticos. Ver NOTA
a seguir
NOTA
A mdia calculada pela opo Mostrar linha da mdia no uma mdia aritmtica simples, e sim uma mdia
aritmtica ponderada em relao ao intervalo de tempo dos dados estatsticos.
308 E3Chart
Propriedades do objeto Legenda
Alguns campos da aba Legenda possuem uma propriedade ou mtodo correspondente. As opes disponveis esto
descritas na tabela a seguir.
Opes disponveis na aba Legenda
OPO DESCRIO
Fonte Permite configurar o nome, o estilo e o tamanho da fonte
da Legenda. Clique em para abrir a janela padro de
seleo de fontes do Windows. Esta opo corresponde
propriedade Font da Legenda
Mostrar Legenda Habilita a visualizao da Legenda. A caixa de seleo ao
lado desta opo define o posicionamento da Legenda.
Esta opo equivale propriedade Visible da Legenda, e
a opo de seleo da posio da Legenda equivale
propriedade LegendPos da Legenda
Tamanho (pixels) Determina o tamanho da Legenda, em pixels. Pode ser a
altura ou a largura, dependendo da posio. A outra
dimenso acompanha a do E3Chart. Esta opo
corresponde propriedade Size da Legenda
Cor do fundo Determina a cor de fundo da Legenda. Esta opo
corresponde propriedade BackColor da Legenda
Estilo da borda Determina o estilo da borda da Legenda. Esta opo
corresponde propriedade BorderStyle da Legenda
Mostrar texto utilizando Determina a cor do texto da Legenda. As opes
disponveis so A cor da pena ou A seguinte cor, onde
se pode selecionar uma cor personalizada. Esta opo
corresponde propriedade TextColor da Legenda
Colunas disponveis Lista as colunas disponveis para visualizao na Legenda
E3Chart 309
OPO DESCRIO
Colunas selecionadas Mostra as colunas selecionadas para a Legenda
Cor do texto das colunas Define a cor do texto das colunas do cabealho da
Legenda. Esta opo equivale propriedade
HeaderTextColor da Legenda
Estilo da borda das colunas Define o estilo das bordas das colunas do cabealho da
Legenda. Esta opo equivale propriedade
HeaderBorderStyle da Legenda
310 E3Chart
OPO VALOR1 NOME DESCRIO
IncioX 13 XBegin Mostra a posio inicial do
cursor
IncioY 17 YBegin Mostra o ponto interpolado
onde o cursor inicial cruza
com a Pena
Ao clicar em Propriedades, mostrada uma caixa de dilogo para configurao do objeto Coluna da Legenda.
Propriedades da coluna
Cada campo da caixa de dilogo Propriedades da coluna possui uma propriedade correspondente. As opes
disponveis esto descritas na tabela a seguir.
Opes disponveis na janela Propriedades da coluna
OPO DESCRIO
Largura inicial Define a largura inicial da Coluna, em pixels. Esta opo
equivale propriedade Width da Coluna da Legenda
Ttulo da coluna Determina o ttulo da Coluna. Esta opo equivale
propriedade Caption da Coluna da Legenda
Alinhamento do texto Determina o alinhamento do texto na Coluna da Legenda.
Esta opo equivale propriedade TextAlign da Coluna
da Legenda
Formatador Determina o formatador da Coluna selecionada. Esta
opo equivale propriedade Format da Coluna da
Legenda
E3Chart 311
19.1.5 Aba Consultas
As Consultas so necessrias para mostrar valores histricos no E3Chart. Atravs da aba Consultas possvel
adicionar ou remover Consultas, bem como configur-las.
Aba Consultas
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Consultas
OPO DESCRIO
Consultas Mostra a Consulta selecionada para edio
NOTA
Ao clicar em Adicionar ou Configurar, uma caixa de dilogo aberta para especificao do Servidor de Banco de
Dados que guarda a Consulta. Os procedimentos de definio da Consulta podem ser encontrados no captulo
Consultas.
312 E3Chart
19.1.6 Aba Fonte
Atravs da aba Fonte, possvel configurar a fonte do cabealho e das linhas do E3Chart.
Aba Fonte
As opes disponveis so referentes a tipo, tamanho e efeitos da fonte.
NOTA
O nome da aba aparece sempre no idioma do Windows.
5. No segundo boto de comando, mude a propriedade Caption para "Habilitar Visualizao da Pena".
314 E3Chart
6. Abra a janela de propriedades deste boto e selecione a aba Scripts. No evento Click, escreva o script a seguir.
Sub CommandButton2_Click()
Set Pen1 = Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Visible = True
End Sub
E3Chart 315
Opes do menu do E3Chart em
tempo de execuo
As opes disponveis esto descritas na tabela a seguir.
Opes disponveis do menu contextual do E3Chart em tempo de execuo
OPO DESCRIO
Caixa de zoom Coloca o ponteiro do mouse no modo zoom por rea
selecionada. Esta opo est disponvel nos grficos de
escala numrica em XY e escala fixa
Mover Coloca o ponteiro do mouse em modo de movimentao
das escalas
Mover horizontalmente Coloca o ponteiro do mouse em modo de movimentao
das escalas somente na direo horizontal
Pesquisar Coloca o ponteiro do mouse em modo de pesquisa de
valores nos dados das Penas
Pesquisar Intervalos Habilita a opo de pesquisa de intervalos de tempo
316 E3Chart
A pesquisa mostrada nos campos Valor do TagX e Valor do TagY
NOTA
Para obter maiores informaes sobre as colunas Valor do Tag X e Valor do Tag Y, veja o tpico sobre as
configuraes da Aba Legenda.
Pesquisa de intervalos
E3Chart 317
Mensagens de status da parte de tempo real
MENSAGEM SIGNIFICADO
Erro: Parte de tempo real desconectada (YLink='Nome No houve conexo da parte de tempo real da Pena.
do Tag') (XLink='Nome do Tag') Verifique o nome dos Tags nas propriedades YLink e
XLink da Pena
Info: Tempo real n pts Mostra o nmero total de pontos da parte de tempo real
Erro: Campo no encontrado (XField = 'Nome do O campo informado na propriedade XField no foi
Campo') encontrado na consulta. Verifique se o campo est
selecionado na tela de edio da consulta ou no cdigo
SQL
Erro: Campo no encontrado (YField = 'Nome do O campo informado na propriedade YField no foi
Campo') encontrado na consulta. Verifique se o campo est
selecionado na tela de edio da consulta ou no cdigo
SQL
Erro: 'Nome da Consulta' 'Mensagem de Erro' Indica que houve um erro na consulta, no sendo
possvel recuperar os dados. As possveis mensagens
mostradas em Mensagem de Erro so descritas na tabela
a seguir
Erro: Consulta invlida (QueryName = 'Nome da A consulta indicada pela propriedade QueryName da
Consulta') Pena no foi encontrada pelo E3Chart
318 E3Chart
MENSAGEM SIGNIFICADO
Cursor ocupado Os registros da consulta no esto disponveis para
serem trazidos do servidor
Falha ao pegar os dados do servidor No foi possvel trazer do servidor os registros da
consulta
Erro desconhecido Houve um erro inesperado ao tentar trazer do servidor
os dados da consulta
E3Chart 319
CAPTULO
E3Playback
20
Uma ferramenta de playback visa facilitar o ps-operao, sobretudo a anlise de ocorrncias. Sua necessidade
justificada por permitir que o usurio visualize, atravs das telas de monitoramento em tempo real, as variaes de
eventos e pontos analgicos em tempo passado que, em determinados casos, pode ser complicado observando
apenas relatrios de eventos e valores analgicos.
Cabe ressaltar que um playback uma ferramenta que permite a um operador experiente e conhecedor do processo
interpretar os acontecimentos de forma mais clara. No faz parte do escopo de um playback a identificao
automtica de soluo ou de causa de uma ocorrncia.
Um exemplo prtico de uso de um playback pode ser o seguinte:
O usurio, ao chegar em seu horrio de trabalho, recebe a informao de uma grave ocorrncia acontecida durante a
madrugada, por volta das 3h15min. Ele pode ento abrir na ferramenta de playback uma tela que contm o ponto gerador
do evento e outros pontos relacionados, movendo o relgio para as 03h10min e clicando em Play. Ao observar a tela sendo
animada com os dados histricos, o usurio facilmente acompanha o estado geral do processo, avanando e retrocedendo
livremente no tempo at compreender perfeitamente a causa da ocorrncia.
320 E3Playback
Incluso do E3Playback em uma Tela
2. Abra a Lista de Propriedades e configure a propriedade DBServer do E3Playback para apontar para o objeto
Banco de Dados que contm os dados histricos do aplicativo.
E3Playback 321
Selecionando um Quadro para a propriedade InitialScreen
4. Abra a Tela "UpperMenu" e insira a imagem Stopwatch no canto superior direito (abra a Galeria e selecione a
categoria Misc Symbols 1).
Tela UpperMenu
5. Clique duas vezes na imagem Stopwatch, adicione o Pick Abrir Tela no evento Click para abrir a "TelaPlayback" no
Quadro principal e configure-o conforme as figuras a seguir.
322 E3Playback
Configuraes do estilo da janela
6. Execute o aplicativo, abra o Viewer, clique em Portugus, depois em Preview de Aplicaes, e finalmente clique
no cone Stopwatch. Neste momento deve aparecer a Tela de playback.
Tela de playback
7. Clique em para entrar no modo Online. Os primeiros dados de playback so carregados, e o relgio de
playback posicionado no centro dos dados disponveis.
E3Playback 323
Tela de playback em modo Online
324 E3Playback
CONE COMANDO AO
Reproduzir Inicia a reproduo dos dados no
horrio atual de playback,
avanando o relgio de acordo
com a velocidade de reproduo
atual
Parar Interrompe o playback, os dados
de Tags e alarmes so removidos
das Telas e nenhuma nova
consulta feita ao banco de
dados
Mais devagar Diminui a velocidade de playback
pela metade. O valor mnimo
1/1024x, isto , avana
aproximadamente um
milissegundo de dados a cada
segundo
Velocidade normal Deixa a velocidade de playback no
valor normal (1x)
Mais rpido Dobra a velocidade de playback.
O valor mximo de 1024x, isto
, a cada segundo o relgio de
playback avana 1024 segundos
(aproximadamente 17 minutos)
Seletor de velocidade Permite selecionar a velocidade
de playback
Data e hora atual Mostra a data e hora atual do
relgio de playback, e permite
selecionar uma nova data
Mostrar ou esconder a Linha de Mostra ou oculta a janela Linha
Tempo de Tempo do E3Playback
E3Playback 325
Janela Opes de gravao
As opes disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na janela Opes de gravao
OPO DESCRIO
Salvar vdeo como Mostra o local e o nome do arquivo de vdeo a ser salvo.
Pode-se clicar em para navegar pelas pastas do
computador
Tempo mximo de gravao Permite definir um tempo total para gravao. Se o valor
estiver em Indefinido, a gravao apenas para se o
boto de gravao de vdeo do E3Playback for
pressionado. A opo Tempo permite que seja pr-
definido um tempo mximo de gravao, em segundos
(neste caso a gravao encerrada automaticamente ao
final do tempo estipulado)
Quadros por segundo Configura o nmero de quadros (frames) capturados a
cada segundo de gravao
Mostrar cursor na gravao Quando esta opo estiver habilitada, o cursor do mouse
aparece no vdeo gravado. O padro desta opo
desabilitada. O ponteiro do mouse gravado no vdeo o
que estiver configurado como padro do Windows.
Ponteiros com animao no so animados no vdeo.
Neste caso, mostrado sempre o primeiro quadro da
animao
Compressor Compressor de vdeo utilizado na gravao. So listados
todos os compressores que esto instalados no
computador, desde que sejam suportados pelo
E3Playback
Qualidade de compresso Configura a taxa de compresso, que afeta a qualidade
final do vdeo e, consequentemente, o tamanho do
arquivo gerado
326 E3Playback
OPO DESCRIO
Intervalo de quadros a cada quadro-chave Configura a quantidade de quadros a cada quadro-chave
(key frame)
Configurar (compresso de vdeo) Abre uma nova janela que possui configuraes
especficas do compressor selecionado
Sobre Abre uma nova janela que possui informaes sobre o
compressor selecionado
Gravar udio Habilita a gravao de udio. O padro desta opo
desabilitada
Dispositivo Lista os dispositivos de udio instalados e habilitados no
sistema, e que podem ser utilizados na captura de udio
Formato Mostra informaes sobre o formato de udio atualmente
selecionado
Atributos Mostra informaes sobre os atributos do formato de
udio atualmente selecionado
Configurar (gravao de udio) Mostra uma janela que permite alterar o formato de
gravao e os atributos do udio
Mostrar resumo ao concluir gravao Habilita ou desabilita a janela que mostrada no
momento em que a gravao finalizada
Linha de tempo
As opes deste componente esto descritas na tabela a seguir.
Opes disponveis na Linha de Tempo
OPO DESCRIO
Rgua Mostra a linha de tempo. Pode-se mover a linha de tempo
para os lados clicando e arrastando o mouse. O zoom
controlado pela roda do mouse. Girando para cima,
feito um zoom in. Girando para baixo, zoom out.
necessrio primeiro clicar no fundo da linha de tempo
antes de tentar executar o zoom. Se a tecla CTRL estiver
pressionada, o zoom feito trs vezes mais rpido
Cursor Marca a posio atual do relgio de playback. Quando o
playback est no modo Pausa pode-se arrastar o cursor
para os lados, alterando o relgio de playback enquanto
arrasta-se o cursor. Est sempre visvel na linha de tempo
Barra de Consultas Mostra os perodos de tempo que j tm dados
carregados:
Uma linha verde clara significa que naquele perodo os
dados j esto totalmente carregados
Uma linha verde escura indica que os dados do perodo
esto sendo carregados
Uma linha amarela clara indica que o perodo contm
alguns dados carregados. Novas consultas ao banco de
dados so necessrias se o cursor for movido para
cima do perodo
E3Playback 327
OPO DESCRIO
Uma linha cinza clara indica que o perodo no tem
nenhum dado carregado ainda. Para carregar os dados
do perodo, mova o cursor de playback para cima do
perodo
Barra de Dados Indica com um ponto azul cada momento em que h um
evento de playback
Barra de Zoom Geral Mostra o perodo de dados que est sendo mostrado na
Linha de Tempo, comparado com o perodo total de
dados disponvel para playback
Caso tenha sido selecionada a opo Mostrar grfico na Linha de Tempo de um Tag na Lista de Eventos ou na
Lista de Tags, mostrada uma representao visual do Tag esquerda do grfico. Esta representao varia de
acordo com o tipo de dados do Tag:
String: Mostra caixas de texto com o nome do Tag
Booleano ou Digital: Mostra um grfico de estado do Tag, onde o valor do Tag fica sempre sobre uma linha
inferior (Off ou False) ou sobre uma linha superior (On ou True). A linha do grfico fica pontilhada nos perodos
em que a qualidade do Tag est ruim
Double, Integer ou Analgico: Mostra um grfico de linha com os valores do Tag. A escala do grfico (inferior e
superior) calculada automaticamente de acordo com os valores do Tag que o E3Playback j consultou no banco
de dados. Assim como no grfico digital, a linha do grfico fica pontilhada nos perodos em que a qualidade do
Tag est ruim. A linha tambm pode ser interpolada ou em escada, dependendo se o Tag suporta (Storage) ou
no (Histrico) interpolao
20.3.3 Marcadores
Os Marcadores so utilizados para sinalizar ocorrncias na linha de tempo do E3Playback.
Marcadores
Opes disponveis na barra de ferramentas Marcadores
CONE COMANDO AO
Adicionar marcador no timestamp Adiciona um nome ao marcador na
selecionado linha de tempo, na data e hora
selecionadas
Editar marcador selecionado Permite editar o marcador
selecionado, podendo alterar data e
hora, nome ou descrio
328 E3Playback
CONE COMANDO AO
Remover o marcador Remove o marcador selecionado na
linha de tempo
Remover todos os marcadores Remove todos os marcadores
criados na linha de tempo
Mover para o marcador anterior Seleciona o marcador imediatamente
frente na linha de tempo e na lista
de eventos, simultaneamente
Mover para o marcador seguinte Seleciona o prximo marcador na
linha de tempo e na lista de eventos,
simultaneamente
Quando um marcador criado, ele mostrado na Linha de Tempo, como pode ser observado na figura a seguir, e
tambm na Lista de Eventos.
E3Playback 329
rea de Telas
A rea de Telas funciona como se fosse um Viewer dentro do E3Playback. As Telas so sempre abertas no zoom
Preencher. possvel navegar livremente entre as Telas do aplicativo.
Existem algumas restries e comentrios quanto ao funcionamento das Telas dentro do E3Playback:
As Telas funcionam como se estivessem em um Viewer Somente Leitura, isto , no permitido o envio de
comandos e valores para o servidor E3. Isto garante que as operaes efetuadas no E3Playback no iro
perturbar o funcionamento do aplicativo em tempo real
No permitido acesso aos objetos do servidor atravs do mtodo Application.GetObject. Se este mtodo for
chamado em algum script, ele falha abortando o script
Devido s vrias limitaes de acesso ao servidor, erros de script ocorridos dentro do E3Playback no geram
uma mensagem de erro, e os scripts so abortados silenciosamente
O E3Playback emula um Viewer real. Para isto criada uma nova cpia do objeto Viewer e seus Tags para uso do
E3Playback. Se algum comportamento especfico do Viewer tiver que ser habilitado ou desabilitado dentro do
E3Playback, pode-se testar a propriedade IsPlaybackMode, do objeto Viewer
O isolamento entre as Telas que executam dentro do E3Playback e o que est fora total
O E3Playback trata os novos Quadros criados pelo aplicativo como novas abas no topo da rea de Telas. O ttulo
da aba o nome do Quadro ou Tela que foi aberto
330 E3Playback
O E3Alarm mostra o sumrio de alarmes de acordo com o que estiver registrado na tabela de alarmes no banco
de dados
O E3Browser funciona normalmente, j que consultas ao banco de dados so permitidas dentro do E3Playback
NOTA
Os dados mostrados no E3Browser so sempre os dados ATUAIS do banco de dados, isto , o E3Playback no
tenta emular o estado do banco de dados em um momento no passado.
Lista de Eventos
As colunas desta janela esto descritas na tabela a seguir.
Colunas da Lista de Eventos
COLUNA DESCRIO
Data/hora Mostra a data e a hora do evento, conforme est
registrado no banco de dados
E3Playback 331
CONE COMANDO AO
Prximo Evento Posiciona o relgio de playback no
prximo evento com timestamp maior
que o timestamp atual
Filtrar Eventos Liga ou desliga o filtro de eventos.
Ao ligar o filtro, apenas os eventos
do Tag ou da fonte de alarme
selecionado atualmente so
mostrados na lista de eventos. Os
Marcadores so mostrados sempre,
independente do filtro
Filtrar marcadores Mostra apenas os Marcadores
criados
Ao clicar com o boto direito do mouse em um evento, um menu contextual mostrado com as opes descritas na
tabela a seguir.
Opes do menu contextual dos eventos
OPO DESCRIO
Mostrar ou Remover grfico na Linha de Tempo Adiciona ou remove uma representao visual do Tag
selecionado na janela Linha de Tempo
Mostrar apenas os eventos deste tag ou Mostrar todos Filtra os eventos na Lista de Eventos para mostrar apenas
os eventos o Tag selecionado. Selecionando de novo esta opo,
todos os eventos so mostrados
Lista de Tags
As colunas desta janela esto descritas na tabela a seguir.
Colunas da Lista de Tags
COLUNA DESCRIO
Caminho do Tag Mostra o caminho do Tag
332 E3Playback
COLUNA DESCRIO
Data/hora Mostra o timestamp atual do Tag. Se o Tag suportar
interpolao (apenas para pontos analgicos
armazenados no Storage), ento o timestamp igual ao
horrio atual de playback. Caso contrrio, o timestamp
o do ltimo evento com timestamp anterior ou igual ao
horrio atual de playback
NOTA
A Lista de Tags pode ajudar tambm a determinar quais Tags necessitam ser gravados no banco de dados para
permitir o playback completo de uma Tela, bastando verificar os Tags com o sinal de proibido .
Ao clicar com o boto direito do mouse em um Tag, um menu contextual mostrado com as mesmas opes
descritas no tpico Lista de Eventos, exceto no caso de Tags marcados com o cone , em que o menu contextual
aparece desabilitado.
E3Playback 333
5. Se a tabela for de Histrico, a tabela _Fields varrida para determinar quais so os Tags armazenados na tabela.
O caminho do Tag neste caso determinado pelo campo FieldSource. O campo que fornece o timestamp dos
dados desta tabela sempre o E3TimeStamp.
6. Se a tabela for de alarmes, a tabela _Fields varrida para determinar o nome dos campos de alarme de usurio
(se existirem). O campo que fornece o timestamp na tabela de alarmes o EventTime (opcionalmente combinado
com o campo EventTimeMS, se existir) ou o campo EventTimeDbl (este ltimo tem prioridade por representar
os milissegundos com mais preciso).
7. Depois que todas as tabelas de dados e os caminhos dos Tags foram detectados, feita uma consulta simples
em cada uma das tabelas para determinar a data mais antiga e a data mais nova armazenada na tabela. Isto
permite determinar o intervalo de datas em que o playback permitido.
NOTAS
O intervalo de datas vlidas no atualizado durante um processo de playback, de forma que os dados novos que
forem adicionados ao banco de dados aps a montagem s esto disponveis se a janela de playback for fechada
e aberta novamente.
Em modo Demo (ou com uma licena de E3 Studio), o perodo permitido para playback se resume s ltimas seis
horas de dados armazenados no banco de dados.
Quando o relgio de playback movido sobre uma fatia de tempo, o E3Playback analisa se todos os Tags necessrios
j esto carregados na fatia, e se todas as informaes de alarme tambm j foram carregadas. Se estiver faltando
algum dado, ento gerada uma consulta assncrona para carregar os dados necessrios do banco de dados. Uma
consulta de dados de playback composta dos seguintes parmetros:
Perodo que vai ser consultado (data e hora inicial e final)
Conjunto de Tags que devem ser consultados (pode estar vazio). Para cada Tag deve ser retornado:
O ltimo evento anterior ao incio da consulta
Todos os eventos ocorridos durante o perodo da consulta
O prximo evento que ocorreu aps o perodo da consulta
Informaes de alarmes que devem ser consultadas, que podem ser zero ou mais das seguintes opes:
Sumrio de alarmes anterior (estado de cada Fonte de Alarme na data e hora inicial da consulta)
Eventos de alarmes no perodo
Sumrio de alarmes posterior (prximo evento de cada Fonte de Alarme aps a data e hora final do perodo)
Para executar uma consulta a dados de playback, normalmente so necessrias vrias consultas ao banco de dados. O
servidor de dados de playback efetua estas consultas de forma assncrona e em um thread separado, coleta os dados
e s os retorna quando todas as consultas tiverem terminado.
Quando uma consulta de playback completada, os dados so imediatamente adicionados fatia correspondente e o
E3Playback automaticamente dispara consultas para atualizar as fatias vizinhas. Desta forma, medida que o relgio
334 E3Playback
de playback avana, as consultas de dados vo sendo feitas, e quando o relgio passa para a prxima fatia bem
provvel que ela j tenha todos os seus dados carregados.
Caso o relgio de playback esteja no modo Reproduzir e entre em uma fatia sem dados ou com dados incompletos,
o E3Playback fica temporariamente pausado aguardando at que as consultas daquela fatia sejam completadas.
O E3Playback tambm busca minimizar o acesso ao banco de dados, aproveitando as informaes dos campos
ltimo evento anterior, Prximo evento aps, Sumrio anterior e Sumrio posterior para evitar que estes dados
sejam consultados novamente. Por exemplo:
Se uma consulta a um Tag no retornou o prximo evento aps o perodo da consulta, sinal de que este Tag
no possui nenhum evento aps a data e hora final da consulta, e portanto este Tag no precisa ser consultado
nas fatias de tempo posteriores
Se uma consulta retornou o sumrio anterior, eventos de alarmes no perodo e o sumrio posterior para uma
fatia, possvel calcular o sumrio anterior da prxima fatia simplesmente combinando o sumrio anterior e os
eventos ocorridos durante a fatia atual. Desta forma, torna-se desnecessrio consultar no banco de dados o
sumrio anterior da prxima fatia
20.5.1 Storage
A nica recomendao para o Storage que a coluna Fonte no deve conter expresses, pois elas no podem ser
utilizadas no playback.
O E3 j cria automaticamente nas tabelas de Storage os ndices necessrios para otimizar as consultas do E3Playback.
20.5.2 Alarmes
Para executar o playback de alarmes, siga estes procedimentos:
1. Habilite ou configure o registro de alarmes em disco.
2. Selecione os seguintes campos para registro (obrigatrios):
EventTime (mais EventTimeMS) ou EventTimeDbl
FullAlarmSourceName
ConditionActive
Acked
AckRequired
3. Ainda recomendada a seleo dos seguintes campos para registro:
InTime (mais InTimeMS) ou InTimeDbl
OutTime (mais OutTimeMS) ou OutTimeDbl
AckTime (mais AckTimeMS) ou AckTimeDbl
Area
ActorID
Enabled
EventCategory
EventType
Message
Severity
Source
SubConditionName
CurrentValue
E3Playback 335
Seleo dos campos
O E3 j cria automaticamente na tabela de alarmes os ndices necessrios para otimizar as consultas de playback.
20.5.3 Histricos
O formato de arquivo Histrico no o ideal para playback, pois normalmente muitos dados duplicados esto
armazenados. As consultas de playback tm um trabalho extra para eliminar os valores duplicados de cada Tag e
encontrar apenas os eventos de mudana de valor, o que pode exigir longas consultas sequenciais na tabela do
Histrico. recomendado o uso do Storage sempre que possvel. Se for indispensvel o uso de dados de Histrico
no playback, deve-se seguir ao mximo as seguintes recomendaes:
Configurar a propriedade UserTable para Falso (se esta propriedade estiver em Verdadeiro, a tabela _Fields
deste histrico no gerada, e este histrico no reconhecido pelo playback)
Colocar cada Tag em um campo separado (no utilizar expresses na fonte do campo, por exemplo)
Criar um ndice para o campo E3TimeStamp. Sem este ndice as consultas ao Histrico ficam muito lentas,
tornando o playback impraticvel
Utilizar tabelas com poucos campos e, se possvel, adicionar um ndice individual para cada campo
(principalmente para os campos com poucas variaes)
Configurar a propriedade CompressedTable em Verdadeiro e utilizar a propriedade DeadBand no Histrico
A figura a seguir mostra como deve ser a configurao do ndice do campo E3TimeStamp:
336 E3Playback
20.5.4 Licenciamento
A Elipse Software fornece dois pacotes de playback, de acordo com as suas ferramentas:
Playback Bsico
Playback Avanado: Consiste no Playback Bsico mais as ferramentas Gravao de Vdeo e Captura de Tela
Cada um destes pacotes dimensionado conforme o nmero de pontos (Tags e Fontes de Alarmes) armazenados no
banco de dados. Por exemplo, um Playback Bsico 1000 permite fazer playback de um banco de dados com at 1000
pontos. Se o banco de dados tem mais pontos que as licenas disponveis, a montagem do banco de dados falha e
mostrada uma mensagem de erro indicando que no h licenas disponveis para executar o playback.
A licena de Studio do E3 inclui uma licena de Playback Avanado sem limite de pontos, porm limitada s ltimas
seis horas de dados armazenados no banco de dados. Isto permite que o desenvolvedor do aplicativo teste o
playback sem precisar adquirir as licenas para isto.
Em modo Demo (quando no h dispositivo de proteo), o playback tambm funciona no modo Avanado sem
limite de pontos, porm limitado a mostrar apenas as ltimas seis horas de dados armazenados no banco de dados,
em relao hora atual do servidor.
IMPORTANTE
Se o dispositivo de proteo for do tipo Master (Studio + Runtime) ou apenas de Runtime, o playback s est
disponvel se houver licenas programadas no dispositivo. Para maiores informaes sobre as limitaes do modo
Demo do E3, veja o tpico Limitaes do Modo Demonstrao.
E3Playback 337
CAPTULO
Frmulas
21
Frmulas so mdulos destinados ao armazenamento e transferncia de conjuntos de valores para determinados
agrupamentos de variveis, de forma a criar configuraes pr-definidas. So compostas de trs partes: Templates,
Unidades e Conjuntos de Valores.
As Frmulas podem ser utilizadas para facilitar processos industriais. Por exemplo, uma fbrica de bebidas produz
vrios tipos de sucos, cada um deles com uma receita diferente. Neste caso, os Templates so os sabores (laranja,
uva, tangerina, etc.). As Unidades so os tanques onde os sucos so produzidos. Os Conjuntos de Valores so o tipo
e a quantidade de produtos colocados em cada suco (por exemplo, 50 g de acar, 1000 l de gua, polpa de fruta,
etc.). Para utilizar este recurso, siga este procedimento:
1. Clique com o boto direito do mouse no nome do projeto no Organizer e selecione a opo Inserir - Frmula.
NOTA
O objeto Frmula pode ser configurado para funcionar como rea de Alarme.
21.1 Configuraes
Quando se cria uma Frmula, mostrada uma janela para a configurao do Banco de Dados e da tabela a ser
utilizados. Sem isto, no possvel a criao de Unidades e Conjuntos de Valores.
338 Frmulas
Configurao do Banco de Dados e da tabela
As opes disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na janela Configurao do Banco de Dados
OPO DESCRIO
Banco de Dados Determina o servidor de Banco de Dados que gerencia
os dados configurados na Frmula. Este campo equivale
propriedade DBServer da Frmula
Tamanho mximo dos campos de Unidades Determina o tamanho mximo dos campos de Unidades
na tabela do Banco de Dados. O valor padro deste
campo 200. Este campo equivale propriedade
DataSourceSize da Frmula
Tamanho mximo dos campos de Valores Determina o tamanho mximo dos campos de Valores na
tabela do Banco de Dados. O valor padro deste campo
200. Este campo equivale propriedade ValueSize da
Frmula
Caso seja necessrio configurar estas opes posteriormente, ou mesmo reconfigur-las, selecione a opo
Configurar Banco de Dados no menu contextual da Frmula.
Frmulas 339
Configurando o Banco de Dados
21.2 Templates
A primeira aba no Editor de Frmulas chama-se Templates. Os Templates definem o tipo de dados que pode ser
armazenado em cada varivel da Frmula, alm de suas restries.
Aba Templates
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Templates
OPO DESCRIO
Nome Define o nome do Template
340 Frmulas
OPO DESCRIO
Tipo Define o tipo do Template
A barra de ferramentas da aba Templates contm as opes Adicionar , para a criao de um novo Template, e
Remover , para a excluso do Template selecionado.
Ao clicar em Restries , a janela da figura a seguir mostrada.
Frmulas 341
21.3 Unidades
A segunda aba no Editor de Frmulas chama-se Unidades. As Unidades definem os Tags que so associados aos
Templates da Frmula. possvel criar vrias Unidades, ou seja, vrios grupos de Tags que podem receber os valores
da Frmula.
Aba Unidades
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Unidades
OPO DESCRIO
Nome Determina o nome do Template
A barra de ferramentas da aba Unidades contm as opes Adicionar , para a criao de uma nova Unidade,
Remover , para a excluso da Unidade selecionada, e Renomear , para a troca do nome da Unidade selecionada.
Para cada nova Unidade, a janela a seguir mostrada para definir um nome.
Aba Valores
As opes disponveis nesta aba esto descritas na tabela a seguir.
342 Frmulas
Opes disponveis na aba Valores
OPO DESCRIO
Nome Determina o nome do Template
A barra de ferramentas da aba Valores contm as opes Adicionar , para a criao de um novo Conjunto de
Valores, Remover , para a excluso do Conjunto de Valores selecionado, e Renomear , para a troca do nome do
Conjunto de Valores selecionado.
21.5.1 Procedimentos
1. Insira um objeto Frmula na aplicao.
2. Configure o Banco de Dados e a tabela. Use um Banco de Dados existente no projeto, e nomeie a tabela como
"Produo".
Templates
4. Na prxima etapa so definidas as Unidades relativas a esta Frmula. Antes de criar as Unidades, no entanto,
deve-se criar os Tags usados nesta Frmula. Para isto, insira em um Servidor de Dados uma Pasta chamada
"Formula" e dentro dela outras duas Pastas chamadas "Maquina1" e "Maquina2". Dentro destas Pastas crie trs
Tags Internos para cada uma.
Frmulas 343
Criando Tags
5. Crie na Frmula duas Unidades chamadas "Maquina1" e "Maquina2". Associe cada campo destas Unidades aos
Tags criados anteriormente.
344 Frmulas
8. Crie seis objetos SetPoint nesta Tela, que devem ser associados a cada um dos Tags da Frmula, e ajuste o
tamanho da Tela ao dos objetos. A Tela deve estar semelhante figura a seguir.
Tela de Frmula
NOTA
s vezes, pode ocorrer um erro na Tela que faz com que as imagens desapaream. Para solucionar esta questo,
deve-se desabilitar a opo Esconder extenses do MS-DOS para arquivos registrados. Esta opo est disponvel
no Windows Explorer.
9. Crie um boto na Tela com o ttulo "Carregar valores". Este boto mostra uma caixa de dilogo com os valores
existentes e as Unidades para as quais estes podem ser carregados, podendo ser selecionada qualquer opo.
Para tanto, crie o seguinte script neste boto.
Sub CommandButton1_Click()
Application.LoadFormulaDlg_
"Formula1", "Maquina1, Maquina2",_
"Modelo1, Modelo2, Modelo3, Modelo4"
End Sub
Onde Formula1 o nome do objeto Frmula criado e o mtodo LoadFormulaDlg um mtodo do Viewer. Ao ser
executado este mtodo, a caixa de dilogo da figura a seguir mostrada.
Frmulas 345
Caixa de dilogo do mtodo LoadFormulaDlg
10. Na diviso da direita so apresentadas as duas Unidades criadas na Frmula, assim como os Conjuntos de
Valores. A opo Modo Silencioso inibe a possibilidade de o usurio alterar valores gravados em disco, que so
carregados para os Tags.
11. Atravs deste boto, pode-se ver a aplicao funcionando com as Frmulas e os Tags recebendo os valores do
disco. Este um dos mtodos para carregar valores de uma Frmula, mas tambm existem mtodos em que o
usurio no necessita selecionar os valores ou as Unidades em uma caixa de dilogo.
12. Crie agora um objeto SetPoint na Tela e um boto com o ttulo "OK". Junto com o SetPoint, coloque um texto de
identificao com o ttulo "Modelo:". No boto deve ser criado o seguinte script.
Sub CommandButton2_Click()
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo1"
Screen.Item("Texto16").Value
End Sub
Onde Texto16 o nome do ltimo SetPoint inserido na Tela. Este comando carrega o Conjunto de Valores
especificado no SetPoint para a Unidade Maquina1. Ao ser executado, este mtodo busca pelo Conjunto de Valores
em disco. Caso encontre, carrega-o seguindo o padro de restries definido no Template da Frmula. Os campos
com restries abertas podem ter seus valores modificados pelo usurio. Para que o usurio no seja interrogado
sobre as mudanas de valores nos campos carregados, deve-se utilizar o modo silencioso.
Alterao do valor
No entanto existe uma alternativa, o mtodo LoadFormulaValuesQuiet, do objeto Viewer. feita uma opo pelo
modo silencioso na Tela, utilizando para isto, o objeto Caixa de Seleo.
1. Crie um objeto Caixa de Seleo na Tela.
2. Coloque um texto de identificao ao seu lado, com o texto "Silencioso".
3. Volte ao script do boto OK e mude o cdigo para o seguinte:
Sub CommandButton2_Click()
If Screen.Item("CheckBox1").Value = true Then
346 Frmulas
Application.LoadFormulaValuesQuiet_
"Formula1", "Maquina1", "Modelo1"
Application.LoadFormulaValuesQuiet_
"Formula1", "Maquina1", "Modelo2"
Application.LoadFormulaValuesQuiet_
"Formula1", "Maquina1", "Modelo3"
Application.LoadFormulaValuesQuiet_
"Formula1", "Maquina1", "Modelo4"
Else
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo1"
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo2"
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo3"
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo4"
End If
End Sub
Onde CheckBox1 o nome da Caixa de Seleo criada. Isto faz com que se o objeto estiver habilitado, seja utilizado
o mtodo LoadFormulaValuesQuiet. Caso contrrio, utilizado o mtodo LoadFormulaValues.
1. Repita os ltimos procedimentos desde a criao do SetPoint para os itens da Maquina2, modificando os scripts
necessrios. Ao final das alteraes, a Tela deve estar semelhante figura a seguir.
Frmulas 347
CAPTULO
Relatrios
22
O Relatrio um componente ActiveX chamado ActiveReport, que permite a visualizao e impresso de valores
instantneos de variveis do sistema e dados armazenados em Banco de Dados (Alarmes, Histricos, Consultas e
Frmulas). Estes dados podem ser impressos tanto em formato texto como em formato grfico, sendo este ltimo
feito atravs do objeto E3Chart.
NOTAS
O objeto Relatrio NO est disponvel na verso 64 bits do E3. Entretanto, o Relatrio pode ser editado na
verso 32 bits do Studio, presente na instalao 64 bits.
Um Viewer 32 bits conectado a um Servidor 64 bits imprime Relatrios normalmente.
Inserindo um Relatrio
2. Caso necessite, configure as propriedades do objeto.
22.2 Componentes
Um Relatrio contm vrias Sees. Cada Seo do Relatrio contm um grupo de controles que so processados e
impressos ao mesmo tempo, como uma unidade.
348 Relatrios
Sees do Relatrio
O Relatrio define tipos de Seo, que so explicados nos tpicos a seguir.
22.2.1 Detail
A Seo Detail o corpo do Relatrio, que imprime uma vez para cada registro da fonte de dados.
NOTA
Um Report Header pode estender-se por mltiplas pginas. Para isto, basta inserir um objeto Quebra de Pgina em
seu contedo.
Relatrios 349
22.3 Configuraes
O Relatrio possui vrios objetos que podem ser agregados a ele, que so acessados atravs da barra de
ferramentas Relatrios.
Menu da rea do
Relatrio
Em um objeto no Relatrio: Somente as opes Insert, Delete, Cut, Copy, Paste, Bring to Front, Send to Back,
Alignment e Format Border esto habilitadas
Menu de objeto do
Relatrio
Em mais de um objeto selecionado no Relatrio: Todas as opes do menu esto habilitadas
Opes disponveis no menu contextual do Relatrio
OPO DESCRIO
Insert Permite inserir um novo componente do Relatrio. As
opes disponveis so as seguintes:
Insert - Group Header/Footer: Adiciona um novo par
de cabealhos ou rodaps de grupo no Relatrio
Insert - Page Header/Footer: Adiciona um novo par de
cabealhos ou rodaps de pgina
Insert - Report Header/Footer: Adiciona um novo par
de cabealhos ou rodaps no Relatrio
350 Relatrios
OPO DESCRIO
Delete / Delete Section Apaga a Seo, objeto ou grupo selecionado. Esta opo
no aplicada na Seo Detail do Relatrio
Reorder Groups Reorganiza os grupos selecionados. Esta opo vlida
quando vrios grupos de Seo (pares de cabealho ou
rodap) so adicionados no Relatrio. Esta opo no
aplicada na Seo Detail do Relatrio
Quando a opo Format Border selecionada, a caixa de dilogo da figura a seguir mostrada.
Relatrios 351
Opes de borda do objeto
As opes disponveis esto descritas na tabela a seguir.
Opes disponveis para a borda do objeto
OPO DESCRIO
Presets Determina o estilo da borda externa do objeto
22.3.1 Preview
Atravs desta opo, possvel visualizar uma prvia da impresso do Relatrio. Assim possvel verificar
configuraes de margem, figuras, etc.
352 Relatrios
Prvia de impresso do Relatrio
As opes disponveis nesta janela esto descritas na tabela a seguir.
Configuraes da Prvia de Impresso
CONE DESCRIO
Tabela de contedo do Relatrio
Imprime o Relatrio, abrindo a Tela de
configurao de impresso
Copia o contedo selecionado
Procura um texto especfico no Relatrio
Visualizao de uma pgina simples do Relatrio
Visualizao de mltiplas pginas do Relatrio
Menos zoom na pgina
Mais zoom na pgina
Porcentagem de zoom na pgina
Relatrios 353
Configuraes de pgina do Relatrio
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes de configurao Page Setup (pgina)
OPO DESCRIO
Top Margin Determina a margem do topo da pgina
354 Relatrios
Configuraes de impresso do Relatrio
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes de configurao Printer Settings (Impressora)
OPO DESCRIO
Paper Size Determina o tamanho do papel
Relatrios 355
Configuraes da grade do Relatrio
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes de configurao Grid Settings (grade)
OPO DESCRIO
Show Grid Habilita ou desabilita a grade
356 Relatrios
Configuraes de estilo do Relatrio
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes de configurao Styles (estilos)
OPO DESCRIO
New / Delete / Lista Determina o estilo do Relatrio. Pode-se inserir um novo
estilo (clicando em New), apagar um estilo (clicando em
Delete) ou utilizar os estilos existentes na lista
Font / Colors / Misc Determina as especificaes do estilo do Relatrio
(fontes, cores de fundo e frente, orientao, etc.)
Editor de Scripts
No campo Object necessrio especificar o objeto onde se deseja criar o script e no item Events, o evento do
Relatrio em que ocorre a ao.
Relatrios 357
22.3.4 Carregar Arquivo RPX
Importa a configurao do Relatrio de um arquivo externo.
22.3.6 Objetos
Esta seo contm informaes sobre os objetos que podem ser usados em um Relatrio.
Caixa de seleo
Aps ser inserido no Relatrio, este objeto chamado de "CheckBox".
Campo de Dados
Aps ser inserido no Relatrio, este objeto chamado de "Field".
358 Relatrios
Cdigo de barras
Aps ser inserido no Relatrio, este objeto chamado de "Barcode".
22.3.6.4 E3Chart
O objeto E3Chart um componente ActiveX utilizado para exibir um grfico mostrando Tags variando em tempo real
e tambm mostrar dados histricos gravados em um Banco de Dados.
E3Chart
NOTA
O E3Chart no pode ser adicionado na Seo Detail do Relatrio.
Existem algumas diferenas de funcionamento entre o E3Chart na aplicao e no Relatrio. Na aplicao, o E3Chart
consegue plotar grficos em tempo real, histrico e misto. J quando este objeto utilizado em um Relatrio, no
permitida sua utilizao com dados em tempo real ou mistos, somente com dados histricos.
Note que nenhum objeto do Relatrio pode ser acessado externamente, ou seja, ao se criar o Relatrio pelo
aplicativo, no possvel acessar suas propriedades nem tampouco as de seus objetos via scripts do aplicativo. Por
isto, as alteraes nos objetos, incluindo o E3Chart, devem ser feitas diretamente no E3 Studio ou em eventos do
prprio Relatrio.
Para maiores informaes sobre este objeto, veja o captulo E3Chart.
22.3.6.5 Elipse
O objeto Elipse permite o desenho de crculos e elipses, utilizando toda a largura ou a altura e definindo o centro do
crculo no centro do retngulo.
Elipse
Aps ser inserido no Relatrio, este objeto chamado de "Shape".
22.3.6.6 Figura
O objeto Figura permite mostrar imagens que estejam armazenadas em arquivos, tanto em arquivos externos como
em arquivos de recurso do aplicativo.
Relatrios 359
Figura
Aps ser inserido no Relatrio, este objeto chamado de "Image".
22.3.6.7 Linha
O objeto Linha liga dois pontos quaisquer. Permite o desenho de retas, atravs de dois pontos especificados na sua
criao ou em polgonos.
Linha
Aps ser inserido no Relatrio, este objeto chamado de "Line".
22.3.6.8 Quadro
O objeto Quadro composto de linhas e colunas onde so inseridos textos ou grficos. Os Quadros dos Relatrios
so usados para organizar e apresentar informaes. Pode-se tambm usar Quadros para criar disposies de
pgina, ou criar textos, grficos e tabelas animadas como em uma pgina em HTML.
Quadro
Aps ser inserido no Relatrio, este objeto chamado de "Frame".
Quebra de Pgina
22.3.6.10 Retngulo
O objeto Retngulo permite o desenho de retngulos, utilizando toda a largura ou altura do objeto. Criado a partir
de dois vrtices.
360 Relatrios
Retngulo
Aps ser inserido no Relatrio, este objeto chamado de "Shape".
Retngulo arredondado
Aps ser inserido no Relatrio, este objeto chamado de "Shape".
22.3.6.12 Texto
O objeto Texto possibilita a criao de um texto. Ao definir a rea na Tela, pode-se digitar diretamente o texto
desejado, que aceita tambm mltiplas linhas.
Texto
Aps ser inserido no Relatrio, este objeto chamado de "Label".
Estas duas reas podem ser acessadas clicando com o boto direito do mouse no Relatrio e selecionando a opo
Insert.
22.4.4 Visualizao
possvel executar a visualizao do Relatrio criado clicando-se em Preview , disponvel na rea de edio.
Para tanto, necessrio direcionar o servidor de Banco de Dados do projeto para o arquivo MDB da pasta onde foi
salvo o exemplo.
362 Relatrios
Report.Export "EXCEL", "C:\correio\reports\report.XLS"
MsgBox "Exportado para XLS!"
Case 3
Report.Export "HTML", "C:\correio\reports\report.html"
MsgBox "Exportado para HTML!"
Case 4
Report.Export "RTF", "C:\correio\reports\report.rtf"
MsgBox "Exportado para RTF!"
Case 5
Report.Export "TEXT", "C:\correio\reports\report.txt"
MsgBox "Exportado para Texto (CSV)!"
Case 6
Report.Export "TIFF", "C:\correio\reports\report.tiff"
MsgBox "Exportado para TIFF!"
Case 7
Set reportFilter = report.GetExportFilter("TEXT")
reportFilter.FileName="C:\correio\reports\_
report2.txt"
reportFilter.TextDelimiter = ","
report.Export reportFilter
MsgBox "Exportado para TXT usando filtro!"
End Select
End Sub
Relatrios 363
A nica exceo para Data/Hora, que um Campo de Dados padro com a propriedade DataField igual a
"=CLng(E3TimeStamp*288)/288".
ReportFooter: Em branco (ou outro valor qualquer)
Se a consulta for entre a zero hora de um dia e outro, o resultado composto por 288 linhas impressas com a mdia
dos campos a cada cinco minutos.
364 Relatrios
CAPTULO
Segurana
23
Atravs desta opo, possvel controlar o acesso a Domnios, Viewers, Telas e Alarmes em uma lista de usurios e
grupos. Conforme a opo configurada, a aplicao permite ou no o acesso aos usurios cadastrados.
As permisses de acesso so configuradas por usurio ou por grupos de usurios. Os grupos podem ser criados
contendo apenas usurios ou tambm outros grupos.
Para acessar as configuraes de usurios, grupos ou permisses, siga este procedimento:
1. Clique no menu Arquivo - Usurios para mostrar uma caixa de dilogo para configurao das permisses, dos
usurios e dos grupos na aplicao.
23.1 Usurios
Atravs da aba Usurios possvel configurar as informaes referentes aos usurios que tm ou no acesso
aplicao. Para utilizar este recurso, clique no menu Arquivo - Usurios e selecione a aba Usurios.
Segurana 365
Aba Usurios
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Usurios
OPO DESCRIO
Nome Indica o usurio corrente
366 Segurana
Adicionando usurios na aplicao
As opes disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na janela Adicionar usurios
OPO DESCRIO
Nome Determina o nome do usurio
O usurio no pode alterar sua senha O usurio no pode alterar sua senha, pois somente o
administrador pode executar esta tarefa
Segurana 367
OPO DESCRIO
A senha expira aps ... dias Determina o prazo de validade da senha do usurio.
Quando a data de expirao estiver prxima, mostrado
um lembrete para renovar a senha. Caso deseje renov-
la, uma caixa de dilogo aberta para que o usurio
configure a senha. Se a senha expirar antes do usurio
renov-la, no mais possvel executar o login, e a
opo Esta conta est bloqueada habilitada
automaticamente. Esta condio persiste at que um
administrador desbloqueie a senha manualmente
A senha deve conter no mnimo ... caracteres Determina um nmero mnimo de caracteres para a
senha do usurio
A senha deve conter letras e nmeros Determina que a senha deve conter letras e nmeros
A senha deve conter no mnimo ... nmeros Determina um nmero mnimo de nmeros para a senha
do usurio
A senha deve conter no mnimo ... letras Determina um nmero mnimo de letras para a senha do
usurio
A senha deve conter letras maisculas e minsculas Determina que a senha deve conter letras maisculas e
minsculas
Esta conta est desabilitada Indica que a conta est desabilitada
Esta conta est bloqueada Indica que a conta do usurio est bloqueada. Esta
opo habilitada automaticamente caso a senha do
usurio expire ou se o usurio digitar a senha errada
vrias vezes
O usurio deve trocar a senha no prximo login Indica que o usurio deve trocar sua senha quando
executar o prximo login
Validar senhas sem diferenciar maisculas e Permite a validao de senhas, independente de seus
minsculas caracteres serem digitados em maisculas ou minsculas.
Esta opo no recomendada
NOTA
No caso da edio de um usurio existente, modificar o campo Senha implica em limpar o contedo do campo
Confirme a senha e vice-versa, mas apenas na primeira vez em que se edita qualquer um destes campos.
Ao efetuar o login do usurio (pelo mtodo Login do Viewer ou pelo menu Arquivo - Login), abre-se a caixa de
dilogo da figura a seguir.
Janela de login
Ao selecionar o modo de autenticao Windows, os campos Nome do usurio e Senha so desabilitados e
preenchidos com o nome e a senha do usurio logado no domnio de rede. Para selecionar outro usurio pertencente
368 Segurana
ao domnio de rede, clique em Outro usurio. Selecionando o modo de autenticao E3, preencha as informaes de
usurio e senha de um usurio do Domnio do E3 nos campos Nome do usurio e Senha, respectivamente.
Quando a opo Este usurio um administrador habilitada para um usurio, este usurio pode, em tempo de
execuo, alterar todas as configuraes mostradas na aba Usurios.
Estes privilgios so acessados via script atravs do mtodo UserAdministration do Viewer, que habilita a caixa de
dilogo dos usurios em tempo de execuo.
NOTA
Apenas o administrador tem acesso ao mtodo UserAdministration do Viewer.
Ao clicar em Remover, a aplicao mostra uma caixa de mensagem questionando se realmente deseja-se remover o
usurio.
possvel que um usurio pertena a um grupo, podendo assim compartilhar as configuraes deste grupo. Para
tanto, na lista Grupos disponveis so mostrados os grupos disponveis na aplicao que podem conter o usurio
selecionado, e na lista Pertence a, a lista dos grupos aos quais o usurio selecionado j pertence. Para adicionar um
usurio a um grupo, siga estes procedimentos:
1. Selecione o usurio que deseja inserir no grupo especfico.
2. Na lista Grupos disponveis, selecione o grupo ao qual o usurio vai pertencer.
3. Clique em Adicionar para adicionar o grupo, que aparece na lista Pertence a.
4. Para remover o grupo, selecione-o na lista Pertence a e clique em Remover.
23.2 Grupos
A aba Grupos permite que sejam configuradas as informaes referentes aos grupos. Cada grupo define
caractersticas que so comuns para todos os seus membros. Um grupo tambm pode pertencer a outros grupos. S
no permitido pertencer a outro grupo que j pertena a ele, ou seja, criar uma referncia circular.
Para utilizar este recurso, clique no menu Arquivo - Usurios e selecione a aba Grupos.
Aba Grupos
Segurana 369
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Grupos
OPO DESCRIO
Nome Indica o grupo corrente
Adicionar grupo
As opes disponveis nesta janela esto descritas na tabela a seguir.
Opes disponveis na janela Adicionar Grupos
OPO DESCRIO
Nome do grupo Determina o nome do grupo
O usurio no pode alterar sua senha O usurio no pode alterar sua senha, pois somente o
administrador pode executar esta tarefa
A senha expira aps ... dias Determina o prazo de validade da senha do usurio
A senha deve conter no mnimo ... caracteres Determina um nmero mnimo de caracteres para a
senha do usurio
A senha deve conter letras e nmeros Determina que a senha deve conter letras e nmeros
A senha deve conter no mnimo ... nmeros Determina um nmero mnimo de nmeros para a senha
do usurio
370 Segurana
OPO DESCRIO
A senha deve conter no mnimo ... letras Determina um nmero mnimo de letras para a senha do
usurio
A senha deve conter letras maisculas e minsculas Determina que a senha deve conter letras maisculas e
minsculas
Validar senhas sem diferenciar maisculas e Permite a validao de senhas, independente de seus
minsculas caracteres serem digitados em maisculas ou minsculas
Ao clicar em Remover, a aplicao mostra uma caixa de mensagem perguntando se realmente deseja-se excluir o
grupo selecionado.
possvel que um grupo de usurios pertena a outro, podendo assim compartilhar as configuraes. Para tanto, na
lista Grupos disponveis so mostrados os grupos disponveis na aplicao que podem conter o grupo selecionado,
e no item Pertence a, a lista dos grupos aos quais o grupo selecionado pertence. Para adicionar um grupo a outro
especfico, siga estes procedimentos:
1. Selecione o grupo que deseja inserir em um grupo especfico.
2. Na lista Grupos disponveis, selecione o grupo ao qual o grupo vai pertencer.
3. Clique em Adicionar para adicionar o grupo, que aparece na lista Pertence a.
4. Para remover o grupo, selecione-o na lista Pertence a e clique em Remover.
NOTA
importante verificar a hierarquia entre usurios e grupos. Se o usurio tem uma opo desabilitada, mas esta
mesma opo est habilitada no grupo, vale a opo do usurio, que possui este item desabilitado. A opo do
grupo s respeitada se a mesma opo do usurio estiver marcada como neutra.
23.3 Permisses
A aba Permisses permite configurar as permisses dos usurios e grupos para Domnios, Viewers, Telas e Alarmes.
Uma verificao de permisso consiste em uma informao que um membro de um grupo tem sobre um comando
que atua sobre um objeto especfico.
Segurana 371
Aba Permisses
As opes disponveis nesta aba esto descritas na tabela a seguir.
Opes disponveis na aba Permisses
OPO DESCRIO
Usurios/Grupos Esta opo lista os usurios ou grupos de usurios
configurados na aplicao
372 Segurana
OPO DESCRIO
Grupos um filtro das opes de configurao. Habilitando esta
opo, possvel visualizar somente os grupos
cadastrados na aplicao
Permisses Mostra as permisses dos usurios ou grupos quanto aos
itens de segurana (Domnios, Viewers, Telas e Alarmes)
NOTA
A opo Desabilitar a verificao de permisses deve ser utilizada com cuidado, pois implica nos seguintes
comportamentos:
O login sempre funciona, mesmo que a senha esteja errada ou que seja utilizado um nome de usurio inexistente
As aes sempre so permitidas, mesmo para usurios annimos
Para cada item de segurana existe uma srie de permisses que podem ser configuradas para cada usurio ou
grupo. As opes disponveis esto descritas nas tabelas a seguir.
Opes disponveis para Telas
OPO DESCRIO
Abrir Tela Habilita a abertura de Telas
Cada item da lista de permisses pode estar configurado com um dos estados da tabela a seguir.
Segurana 373
Opes da lista de permisses
CONE ESTADO DESCRIO
Permitido O comando selecionado na lista de
permisses permitido para o
usurio ou grupo selecionado,
independente dos grupos aos quais
ele pertence
NOTA
Para configurar os estados possveis para cada item de segurana na lista de permisses, pode-se utilizar as
seguintes opes:
Clique com o boto direito do mouse no item ou use a combinao de teclas SHIFT + F10, que corresponde
tecla de aplicao ou de menu , para selecionar uma das opes, Permitir comando, No permitir comando
ou Usar a informao do grupo.
Clique duas vezes no item ou utilize a barra de espao do teclado para alternar entre os estados Permitido, No
permitido ou No informado.
No caso de Telas, possvel que a configurao de permisso seja realizada por Tela especificamente. No caso de
Alarmes, esta configurao pode ser realizada por rea.
NOTA
Em uma aplicao, todos os usurios tm acesso Tela de abertura. Caso deseje que a aplicao sempre inicie com
a tela de login do usurio, crie um usurio sem permisso especfica na Tela inicial. Assim, toda vez que for iniciada a
aplicao, pede-se o login do usurio e aps, mostra-se a Tela de abertura.
Com relao a permisses para um usurio annimo, devem ser observadas as seguintes situaes:
Se no h usurio criado, a verificao de permisses no est habilitada ou no h usurio com restrio para
uma determinada operao, ento no exigida identificao (o usurio logado como annimo)
Se h usurio criado, a verificao est habilitada e h pelo menos um usurio que no possa executar
determinada operao, ento para esta operao exigida identificao (no permitido o acesso como usurio
annimo)
374 Segurana
NOTA
A nomenclatura e descrio das opes de restrio podem ser acessadas atravs da opo Legenda.
Caso haja alguma restrio para executar, parar, editar um Domnio ou configurar os usurios ou grupos, necessrio
que um usurio esteja logado no E3. Para tanto, utilizam-se as opes Login ou Logout, disponveis no menu
Arquivo.
Segurana 375
Proteo de arquivos
Esta janela possui dois tipos de proteo: Proteo de Edio e Proteo de Execuo.
Proteo de Edio: Protege o arquivo contra alteraes e visualizaes no autorizadas. Este recurso utilizado
para evitar que determinada biblioteca ou projeto seja alterado acidentalmente, ou que sejam copiados
procedimentos de conhecimento especfico do desenvolvedor
A opo Adicionar proteo permite configurar uma senha de proteo para a aplicao
Adicionar proteo
A opo Alterar senha altera a senha de proteo do E3 Studio para o arquivo
376 Segurana
Alterao de senha de proteo
A opo Remover proteo remove a proteo de edio deste arquivo. Para isto, clique nesta opo, digite a
senha e clique em OK para que a aplicao abra uma caixa de mensagem informando se a ao foi executada
corretamente
Proteo de Execuo: Esta opo utilizada para proteger o arquivo contra execuo no autorizada. Para isto,
necessrio solicitar a gravao de uma senha no dispositivo de proteo, que realizada pela Elipse Software.
Isto protege o desenvolvedor de cpias no autorizadas do projeto, por exemplo. Para isto, no momento do
pedido de licena do E3 Server, necessrio fornecer a senha de execuo. Este processo realizado
posteriormente compra do servidor
A opo Adicionar proteo permite configurar uma senha de proteo para a aplicao
Adicionar proteo
A opo Alterar senha altera a senha de proteo de execuo para o arquivo
Quando um arquivo .lib ou .prj aberto no E3 Studio, este inicializa mostrando um cone cinza , com um cadeado
indicando que est protegido e seu contedo no pode ser acessado. Para acessar o contedo do arquivo, clique
com o boto direito do mouse no projeto ou biblioteca e selecione a opo Abrir com senha. Aps informar a senha
e a aplicao liberar o acesso, o cone muda para colorido , indicando a acessibilidade dos arquivos.
Segurana 377
O contedo de arquivos .prj e .lib protegidos criptografado. Quando um projeto protegido, as propriedades
DocString e Domain so bloqueadas.
IMPORTANTE
As protees implementadas no podem ser desfeitas caso as senhas sejam perdidas. Portanto, ao proteger um
arquivo, mantenha as senhas armazenadas em local seguro. Isto garante que possvel usar o arquivo sempre que
necessrio.
378 Segurana
CAPTULO
E3 Viewer e E3 WebViewer
24
O E3 Viewer o ambiente de visualizao do E3. Nele, possvel visualizar a execuo da aplicao feita no E3
Studio.
O E3 WebViewer um componente ActiveX que faz o navegador comportar-se como o E3 Viewer, o que permite a
visualizao e controle de aplicaes E3 via Internet. Desta forma, possvel visualizar e interagir com um processo de
cho de fbrica atravs de um navegador web comum. O navegador pode estar em qualquer computador da rede
que tenha acesso ao E3 Server.
Depois de instalado, o E3 WebViewer vai funcionar exatamente como o E3 Viewer, executando o download da
aplicao (Telas, bitmaps, etc.) para a mquina local. Todas as funcionalidades do E3 Viewer (E3Chart, E3Alarm, etc.)
so suportadas pelo E3 WebViewer.
importante lembrar que, no caso de no haver usurio logado no Viewer (usurio annimo), aplicada a restrio
de acesso, desde que pelo menos um ou mais usurios tenham esta restrio.
Desta forma, cada vez que ocorre uma mudana de usurio o modo de acesso do Viewer pode ser mudado (e
consequentemente a propriedade IsReadOnly), de acordo com a combinao do que permitido pela licena em uso
e a permisso do usurio logado.
A mudana do modo de acesso tambm pode acontecer caso ocorra a reconexo do Viewer, j que esta pode
provocar tanto a mudana de licena (de Viewer Full para Viewer Only, ou vice-versa) quanto a mudana das
permisses do usurio logado.
Caso haja algum usurio com acesso de escrita ao servidor bloqueado no momento da abertura do Viewer, este entra
automaticamente no modo Somente Leitura, independente da licena em uso, j que o usurio annimo sempre
assume a restrio mxima configurada.
24.2.1 Atravs do E3
O E3 Viewer pode ser executado atravs da barra de ferramentas Padro:
Quando o E3 Viewer executado, a aplicao mostra a janela a seguir, indicando o estado da conexo.
O argumento nome_do_servidor representa o nome da mquina onde o E3 Server est executando. Se este
argumento no for informado, uma caixa de dilogo mostrada perguntando o caminho do servidor da aplicao,
como ocorre quando o E3 Viewer executado a partir do menu Iniciar (como mostrado no prximo tpico).
As opes de configurao para a linha de comando so as seguintes:
-screen ou /screen: Permite ao usurio informar uma Tela inicial vlida, diferente da Tela inicial configurada no
Domnio
Viewer [nome_do_servidor] screen <nome_da_tela>
-noping ou /noping: Descarta a necessidade de se executar um comando ping para o servidor antes da
tentativa de conexo (tentativa de conexo direta)
Viewer [nome_do_servidor] noping
-readonly ou /readonly: Permite ao usurio especificar que o Viewer deve tentar conectar apenas no modo
Somente Leitura. Quando isto for realizado, o Viewer sempre utiliza uma licena do tipo Viewer Only
Viewer [nome_do_servidor] readonly
-cachepath ou /cachepath: Permite especificar um diretrio para a gravao do cache do Viewer. Se no for
especificado, usado o diretrio temporrio do sistema (varivel de ambiente TEMP)
Viewer [nome_do_servidor] cachepath <diretorio>
-useservers ou /useservers: Esta opo faz com que o Viewer tente se conectar somente aos servidores
especificados na linha de comando. Se a opo no estiver presente (comportamento padro), o Viewer pode
tentar descobrir servidores alternativos caso no consiga se conectar aos servidores passados na linha de
comando. Esta opo funciona apenas em rede local, portanto deve ser informada caso o servidor que o Viewer
deve acessar esteja fora da rede local
Viewer [nome_do_servidor] useservers
-params: Permite que o usurio especifique parmetros de inicializao do Viewer. Esta opo no pode vir
imediatamente antes da lista de servidores. Os valores passados nesta opo podem ser recuperados via script
utilizando a propriedade Params do Viewer. Para maiores informaes sobre a utilizao desta propriedade, veja
o captulo Viewer no Manual de Referncia e Scripts do E3
Viewer -params <Nome1>=<Valor1> [<Nome2>=<Valor2>] ...
-help: Mostra uma caixa de dilogo com exemplos de uso das opes de linha de comando do Viewer, como na
figura a seguir
E3 Viewer
Se o E3 Server estiver na mesma mquina do E3 Viewer, selecione a opo Servidor Local. Caso estejam em mquinas
diferentes, selecione a opo Servidor na rede e informe o nome ou o endereo IP da mquina com o E3 Server. Se o
E3 Server estiver disponvel em uma porta diferente do padro (6515), informe o nmero desta porta no campo
Servidor na rede aps o nmero do IP, separados por dois pontos. Para se conectar no modo Somente Leitura,
selecione a opo Iniciar o Viewer no modo apenas de leitura.
A pgina docwrite2.asp vem configurada considerando-se que o E3 Server est executando no mesmo computador
que o servidor web. Porm, possvel alterar o cdigo fonte desta pgina para atender configurao desejada. Para
isto, altere a linha a seguir no arquivo docwrite2.asp:
var Domain = getDomain();
Caso se queira permitir ao usurio informar uma Tela inicial vlida, diferente da configurada no Domnio, deve-se
alterar o parmetro Screen no arquivo docwrite2.asp, colocando em Nome_da_Tela um nome de Tela vlido na
aplicao. Exemplo:
<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 conexo,
deve-se alterar o parmetro Ping no arquivo docwrite2.asp. O valor pode ser "True" ou "False". Exemplo:
<param name="Ping" value="True">
Caso seja preciso que o WebViewer procure por outros servidores na rede se no conseguir conectar ao servidor
especificado no parmetro Domain, deve-se alterar o parmetro UseServers no arquivo docwrite2.asp. Se o parmetro
no for informado, o WebViewer tenta se conectar apenas ao servidor especificado no parmetro Domain, que o
comportamento padro do WebViewer (valor "True"). A alterao do valor para "False" s funciona para servidores e
WebViewers que estejam na mesma rede. Exemplo:
<param name="UseServers" value="False">
A configurao do E3 WebViewer para abrir no modo Somente Leitura realizada atravs do parmetro
StartReadOnly, com os valores "True" ou "False", no arquivo docwrite2.asp. Se este item no existir, o valor assumido
"False" (comportamento compatvel com verses anteriores). Exemplo:
<param name="StartReadOnly" value="False">
NOTA
Caso o parmetro InstallACP esteja configurado com o valor "False", as Telas da aplicao que utilizem MS Forms
podem apresentar erros durante o carregamento, se os objetos MS Forms no tenham sido previamente instalados
por outros aplicativos, como por exemplo o Microsoft Office.
Os servidores e o E3 WebViewer podem tanto executar na mesma mquina quanto em mquinas diferentes. Os
tpicos a seguir mostram como estas situaes se aplicam.
7. O IIS inicia a instalao (para instalar o IIS preciso ter o CD de instalao no Window Server 2003 SP2 e
Windows XP SP3).
8. Aguarde a finalizao do processo para configurar o IIS.
Aps a instalao do IIS, os arquivos e3web.asp, e3web2.asp, docwrite.asp, docwrite2.asp e e3downloader.cab devem
ser copiados para C:\InetPub\wwwroot. Esta pasta criada na instalao do IIS. Alm dos arquivos .asp, o instalador
do E3 WebViewer tambm deve ser copiado para esta mesma pasta. Este instalador (e3webviewer-x86-ptb.exe)
utilizado quando a mquina cliente acessar o servidor pela primeira vez, caso o E3 no tenha sido previamente
instalado nesta mquina. Este arquivo pode ser obtido atravs de download no site da Elipse.
O IIS ainda necessita ser configurado para seu correto funcionamento. A configurao diferente caso o IIS e o E3
Server estejam na mesma mquina ou em mquinas diferentes. Para configur-lo, consulte o Guia de Instalao do
E3, no tpico Instalao do E3 WebViewer.
NOTA
A verso do cliente tem que ser a mesma do servidor. Para isto, o instalador (e3-w2kwebviewer.exe) no servidor
deve ser sempre o mais atual.
IMPORTANTE
Para executar uma aplicao redundante no E3, necessrio que todos os servidores executem a mesma verso do
software, e tenham uma cpia local atualizada dos arquivos do Domnio (arquivos .prj, .lib, etc.). O arquivo .dom, por
sua vez, sincronizado automaticamente pelo E3 Server, isto , mudanas realizadas no arquivo .dom em um
servidor so automaticamente copiadas para o arquivo .dom dos outros servidores do Domnio. Para isto, o arquivo
.dom deve obrigatoriamente existir no mesmo caminho em todos os servidores.
O Hot-Standby usa a conexo REC, portanto ele s funciona se o E3 Server estiver iniciado nas mquinas envolvidas.
Se o usurio de um E3 Studio ou Hot-Standby administrador da mquina remota onde o E3 Server est executando,
ele pode controlar o servio remotamente usando o aplicativo services.msc, atravs da opo Action - Connect to
another computer.
25.1 Configurando
As configuraes que devem ser feitas para implementar o Hot-Standby so as seguintes:
1. Localize o caminho dos arquivos de Domnio (arquivos .dom, .prj, .lib, etc.) no computador principal e copie esta
pasta para o computador Standby. Caso tenha sido indicado um outro caminho para os arquivos de Domnio na
opo Pasta raiz dos arquivos do Domnio na aba Servidores, deve-se utilizar este caminho para a cpia.
2. Os arquivos de bancos de dados devem ser tratados de maneira diferenciada. Para maiores informaes, veja o
tpico Utilizando Bancos de Dados com Hot-Standby.
3. Clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do Windows e selecione
a opo Domnio - Opes.
Hot-Standby 387
E3 Admin
4. Na aba Servidores, adicione os servidores principal e backup. Configure as opes Nome do servidor e
Identificao do servidor na rede, conforme descrito no tpico Domnios - Configuraes de Domnio -
Servidores. Por exemplo:
Nome do servidor: Servidor1
Identificao do servidor na rede: \\Computer1
5. Na aba Opes, selecione o item Hot-Standby - Habilitar. No campo Servidor principal, selecione o servidor
principal do projeto e, no campo Servidor de backup, selecione o servidor de backup. O E3 busca o servidor
principal por ordem alfabtica.
6. Defina a opo Endereos para PING de integridade de rede, conforme especificado no item Endereos para
PING de integridade da rede do tpico Domnios - Configuraes de Domnio - Opes.
7. Habilite a opo Ativar backup em caso de falha local, conforme especificado no item Ativar backup em caso
de falha local do tpico Domnios - Configuraes de Domnio - Opes.
8. Para confirmar as configuraes, clique em OK.
9. Ao iniciar a execuo do E3 mostrado, na rea de Notificaes do Windows dos computadores configurados no
Hot-Standby, um cone representado por uma barra amarela circulante , indicando que os Domnios esto
sendo carregados. Aps alguns segundos, o E3 reconhece o computador principal e indica este estado, na rea
de Notificaes do Windows, com um cone representado por uma seta verde . Este cone determina que este
computador est em execuo. No computador standby mostrado um cone representado por duas barras
amarelas , indicando que este computador est em modo Standby (modo de espera).
Este servidor inicia os servidores do Domnio e depois automaticamente fechado. Um Domnio pode ser iniciado
tambm atravs do E3 Studio. Para tanto, abra o Domnio e clique em na barra de ferramentas Padro.
IMPORTANTE
As opes de parar e fechar um Domnio AFETAM TODOS OS SERVIDORES DO DOMNIO, e no apenas o servidor
onde o comando executado.
388 Hot-Standby
25.4 Parando um dos Servidores do Domnio
A maneira correta de parar um dos servidores do Domnio marc-lo como Em manuteno na configurao
Domnio - Opes, aba Servidores, do Domnio. Se o servidor ativo for colocado em manuteno, o servidor Standby
passa para o estado ativo. Para recolocar o servidor no Domnio, desmarque a opo Em manuteno deste
servidor.
NOTA
Se a aplicao principal no conseguir enviar os dados para o servidor em Standby, estes dados permanecem
armazenados localmente em disco, para posterior envio quando a comunicao entre os dois computadores for
restabelecida, assegurando assim a igualdade entre as tabelas geradas pela aplicao.
Hot-Standby 389
CAPTULO
Configuraes Avanadas
26
Existem configuraes do E3 que podem ser realizadas diretamente no Registro do Windows, embora esse
procedimento no seja aconselhvel. A Elipse Software possui uma ferramenta, chamada E3 Tweak, que realiza as
configuraes de registro usando uma interface grfica. O Manual do Usurio do E3 Tweak pode ser aberto pelo
menu Iniciar - Programas - Elipse Software - Elipse E3 - Manuais - Manual do Usurio do E3 Tweak. O aplicativo E3
Tweak pode ser aberto de trs formas:
Pelo menu Iniciar - Programas - Elipse Software - Elipse E3 - E3 Tweak
Pelo menu Ferramentas - E3 Tweak do E3 Studio
Pelo item Atalhos - E3 Tweak do menu do E3 Admin na rea de Notificao do Windows
27.1 Alarmes
Foi encontrado um erro no nmero de colunas do arquivo CSV na importao de um Alarme do tipo
<nomedotipo>. Deseja continuar a importao dos demais Alarmes, ignorando os erros?
POSSVEIS CAUSAS
O arquivo CSV para os alarmes que se quer importar possui um erro nas colunas do Alarme do tipo indicado.
Arquivos de alarmes devem ter sempre o nmero mnimo de colunas esperado, de acordo com cada tipo. Colunas
extras so desprezadas. Para saber a maneira correta de criar um arquivo CSV para alarmes, veja o tpico Criando
um arquivo CSV manualmente no captulo E3 Studio.
SOLUO
Existem trs possveis respostas pergunta feita na mensagem de erro:
Sim: A importao dos Alarmes contidos no arquivo CSV prossegue, ignorando apenas este erro de nmero de
colunas. O Alarme cujas colunas esto incorretas no importado
Sim (Todos): A importao dos Alarmes prossegue, ignorando todos os demais Alarmes com erro no nmero de
colunas que possam existir no arquivo CSV
No: A importao interrompida, mas os Alarmes j importados so preservados
Para que este erro no ocorra, o arquivo CSV deve ser criado de acordo com as recomendaes do captulo
Alarmes.
IMPORTANTE
Embora os arquivos de Tags e Alarmes tenham a mesma extenso (.csv), eles so internamente diferentes. Sendo
assim, um arquivo de Alarmes no serve para Tags e vice-versa.
Criei um arquivo CSV manualmente, contendo a configurao dos Alarmes. Como fao para
import-lo?
Verifique as configuraes regionais no Painel de Controle do Windows, e confirme se o caractere separador o
mesmo utilizado no arquivo CSV. DICA: crie um Alarme no E3 e utilize a ferramenta de exportao, utilizando-o como
modelo para a gerao dos novos Alarmes.
SQL Server:
SELECT InTime, OutTime, Message, FormattedValue,
Severidade = CASE Severity
WHEN 0 THEN 'Alta' WHEN 1 THEN 'Mdia'
WHEN 2 THEN 'Baixa' END FROM Alarms;
Oracle:
SELECT InTime, OutTime, Message, FormattedValue,
DECODE(Severity, 0, 'Alta', 1, 'Mdia', 2, 'Baixa')
Severidade FROM Alarms;
27.2 Associaes
Como criar um Tag Expresso no E3?
Associando a propriedade Value de um Tag Interno expresso desejada. A expresso pode ser do tipo simples e
pode conter operadores aritmticos e lgicos envolvendo constantes e outros Tags.
Outra maneira criar uma Associao por Tabela em todas as propriedades que possuem contedo a ser traduzido,
usando para todas as Associaes a mesma fonte. Em cada faixa de valores da Associao, coloque uma String
referente a um idioma diferente. A fonte pode ser um Tag Interno cujo valor pode ser definido ao abrir o Viewer. No
caso do mtodo MsgBox, use o mesmo Tag como condio para escolher qual String utilizada.
Ao abrir uma Tela, aparece uma mensagem de erro dizendo que no foi possvel abrir uma
Biblioteca ActiveX
POSSVEL CAUSA
Alguns ActiveX utilizados nesta Tela no foram registrados e adicionados no computador.
SOLUO
Registre e adicione o ActiveX atravs da opo Adicionar ActiveX, disponvel no menu Ferramentas. Para tanto,
deve-se ter o arquivo OCX que contm a Biblioteca.
Tenho duas Bibliotecas em meu Domnio, mas no consigo utiliz-las ao mesmo tempo. Quando
registro uma, a outra deixa de funcionar. Como posso resolver este problema?
Provavelmente, uma das Bibliotecas foi criada a partir da cpia da outra, permanecendo as duas com o mesmo
identificador. Por isto, necessrio remover uma delas do Domnio.
Utilizei o E3 Admin via linha de comando e apareceu um erro. Por qu isto ocorreu?
Muitas vezes, quando se utiliza o E3 Admin via linha de comando, pode-se configurar algum parmetro errado, o que
acaba provocando uma mensagem de erro. As mensagens de erro que podem aparecer so as seguintes:
O Domnio no pode ser aberto porque o arquivo 'nomedoarquivo.dom' somente para leitura
Esta mensagem aparece quando o arquivo de Domnio somente de leitura (read-only)
As opes no so vlidas ou o nome do Domnio no est correto. Verifique as opes informadas e se o
Domnio existe
Como duas ou mais pessoas podem trabalhar ao mesmo tempo no mesmo Domnio?
Criando o Domnio pela rede, vrias pessoas podem abri-lo em mquinas diferentes e trabalhar nele ao mesmo
tempo. As alteraes salvas por uma pessoa so visveis para todas as outras, assim que abrirem o objeto especfico
alterado, ou ento assim que atualizarem o projeto ou a Biblioteca alterados.
O que acontece quando a comunicao entre o Domnio Cliente e o Domnio Servidor cai?
Quando uma situao de erro ocorrer, todas as Associaes da aplicao cliente referenciando o Domnio so
desconectadas (Displays, por exemplo, passam a mostrar o texto que indica erro de comunicao, conforme as
configuraes do objeto Viewer), assim como todos os comandos Application.GetObject referenciando o Domnio
Remoto falham, ou seja, causam erros de script. Quando o problema resolvido, as Associaes devem reconectar-se
automaticamente. J os comandos Application.GetObject devem ser executados novamente.
Um E3 Server pode ser configurado como Domnio Remoto Servidor e Cliente ao mesmo tempo?
No. Isto pode causar o surgimento de Associaes circulares, ou seja, A B C A, onde o Domnio A tem como
Cliente o Domnio B, o Domnio B tem como Cliente o Domnio C e o Domnio C tem como Cliente o Domnio A.
Mesmo que as Associaes no sejam circulares, as escritas de Associaes (ou outras operaes sncronas) podem
causar travamentos (deadlocks) entre os E3 Servers. Para contornar esta situao, sugerimos que o aplicativo seja
modificado para que um Domnio funcione apenas como Cliente ou como Servidor, mas nunca como Cliente e
Servidor ao mesmo tempo.
O que o protocolo REC? Como posso visualizar o trfego de dados no log do E3?
O REC um protocolo desenvolvido pela Elipse Software para comunicao entre os diversos mdulos do E3. Os
pacotes do REC no tm tamanho fixo. A quantidade de dados que passa pelo protocolo pode ser vista nos mesmos
logs do E3 e indicada pela quantidade de dados, em KB, enviados e recebidos.
O que se deve fazer caso muitos erros de ping estejam ocorrendo na rede?
Caso isto acontea, verifique a qualidade e performance da rede e siga os procedimentos do artigo Configuraes de
rede do E3 para redes com alta latncia, banda reduzida e/ou perda de pacotes. Entretanto, relembramos que a
configurao padro dos Domnios Remotos, e do protocolo REC em geral, no adequada para redes WAN (Wide
Area Network), apenas para redes LAN (Large Area Network).
Qual a maneira mais fcil de fazer piscar a cor de um objeto na Tela quando houver um erro de
comunicao?
Crie uma Associao Digital entre a propriedade ForegroundColor do objeto e a expresso NomeDoTag.Quality <
192, com a opo de pisca habilitada. A propriedade Quality representa o estado da qualidade do valor do Tag, no
padro OPC, e pode variar de 0 a 255, sendo que a qualidade boa apenas acima do valor 192.
27.7 E3Alarm
Os Alarmes no aparecem no E3Alarm. Por qu isto ocorre?
POSSVEIS CAUSAS
Para checar a configurao do E3Alarm, verifique se o nome do Servidor est configurado corretamente. Outra
possibilidade a existncia de mais de um Servidor de Alarmes no Domnio, o que pode gerar problemas. Mais uma
situao de erro seria um filtro configurado para uma rea de Alarme inexistente.
SOLUO
Certifique-se de que existe apenas um Servidor de Alarmes no Domnio e que todos os Alarmes esto configurados
corretamente. Confira tambm se a rea configurada existe.
27.8 E3Browser
Como limitar o nmero de registros que aparecem no E3Browser?
Este item pode ser configurado na consulta do E3Browser. Habilite a caixa de seleo Retornar no mximo ...
registros, especificando o nmero mximo de registros a serem retornados. Outra opo otimizar a consulta a ser
feita utilizando os filtros para restringir o perodo, a quantidade de colunas ou registros envolvidos, etc. Para isto, veja
o captulo Consultas.
27.9 E3Chart
possvel no plotar o valor de um Tag quando a qualidade estiver ruim, em um E3Chart histrico?
Sim. Utilizando scripts possvel configurar o E3Chart da seguinte forma:
Set Pena = Screen.Item("E3Chart1").Pens
Pena.Item("Nome da Pena").ShowBadPoints = False
Observe, no entanto, que esta soluo somente vlida para valores histricos. Em tempo de execuo, o valor
sempre plotado, independente da qualidade do Tag.
27.10 Histrico
Como no gravar os registros de Histricos por scan?
27.14 Relatrios
Como colocar a data e a hora atual em um Relatrio do E3?
Existem pelo menos duas alternativas:
Coloque um objeto Texto na Seo Page Header e, no evento OnFormat desta Seo, escreva o seguinte script
(Label1 o nome do objeto Texto):
Report.Sections("PageHeader").Controls("Label1")._
Caption = Now
Crie um Tag Demo do tipo CurrentTime. No cabealho ou no rodap do Relatrio, deve-se inserir um objeto
SetPoint e, na propriedade DataField, deve-se digitar o nome completo do Tag (por exemplo,
"Dados.TagDemo1.Value"). Configure o formato da data desejada. Isto pode ser feito clicando com o boto
direito do mouse no objeto e ajustando as suas propriedades, ou ento digitando diretamente o formato na
propriedade OutputFormat, na Lista de Propriedades (um exemplo de formato de data "dd/MM/yyyy
hh:mm:ss").
Tenho um Relatrio que mostra o resultado de uma Consulta que possui um filtro por data.
Quando o Relatrio gerado, a Consulta no retorna os valores configurados via script para estas
variveis. Como solucionar este problema?
Verifique, no script que configura ou acessa este Relatrio, se aps os valores para as variveis da Consulta terem
sido configurados no foi acionado o mtodo LoadReport, j que este mtodo carrega o Relatrio com as
configuraes feitas no E3 Studio. Utilize somente uma vez o mtodo LoadReport no script, carregando o Relatrio
para uma varivel (atravs do comando Set).
Como executar corretamente um Relatrio que utiliza o mtodo CopyConfig para copiar para si as
configuraes de um E3Chart em Tela?
O mtodo CopyConfig no copia os valores de variveis de consulta, sendo necessrio executar este procedimento
via script dentro do grfico. As Penas configuradas no E3Chart em Tela so do tipo Real.
Como mostrar as datas utilizadas como filtro na Consulta na Seo Page Header do Relatrio?
Primeiro, adicione dois SetPoints na Seo Page Header (um para mostrar a data inicial e outro para a data final) e
crie um script que passe os valores que foram carregados nos SetPoints da Tela (e transferidos para a Consulta) para
estes dois SetPoints. O script a ser criado na Seo Page Header, no evento OnBeforePrint do Relatrio o seguinte:
Set dados = Application.GetFrame().Screen
Report.Sections("PageHeader").Controls("Field5").Text = _
dados.Item("TextoDataInicial").Value
Report.Sections("PageHeader").Controls("Field6").Text = _
dados.Item("TextoDataFinal").Value
Depois, associe dois Tags Internos aos SetPoints da Tela onde so especificadas as datas. Associe estes Tags aos
SetPoints no Relatrio.
Como utilizo o evento de script OnError para mostrar uma mensagem de erro quando falhar a
impresso do Relatrio?
O evento OnError do Relatrio no permite que sejam executados scripts dentro dele, servindo somente para seu uso
interno. Isto significa que no possvel alterar a mensagem de erro, nem executar algum outro procedimento a partir
deste evento.
SOLUO
H duas maneiras de solucionar esta questo:
1. O usurio deve criar um ndice nico para os campos da chave.
2. O usurio deve verificar a aplicao para que ela no envie valores repetidos de chave para gravao.
ErrorLocal = Open Connection ErrorError #0x80040E4D Description: Login failed for user
'UsuarioErrado'.(Source: Microsoft OLE DB Provider for SQL Server) (SQL State: 42000)(NativeError:
18456)
POSSVEL CAUSA
Erro no nome do usurio ou senha.
SOLUO
Utilize um usurio cadastrado no banco de dados ou verifique a senha utilizada.
Como eu mostro a data e a hora atual do sistema em uma Tela da minha aplicao?
Crie um Tag Demo do tipo CurrentTime e associe-o a um Display na Tela. O formato de data e hora pode ser
configurado na aba Formatao das propriedades do Display.
NOTA
No tente remover a Animao do objeto atravs do Organizer, pois esta ao remove o objeto.
A sintaxe para as variveis deve ser o caractere "<" (menor que), o caractere "%" (percentual), o nome da varivel, o
caractere "%" novamente e por fim o caractere ">" (maior que). Os valores var1 e var2 so as variveis que a Stored
NOTA
A propriedade CursorLocation da Consulta do E3 deve estar configurada como 1: clClient.
27.20 Viewer
No consigo conectar um Viewer remoto ao Servidor. Por qu isto est acontecendo?
POSSVEL CAUSA
Existe um firewall bloqueando o acesso ao servidor.
SOLUO
Deve-se liberar as portas utilizadas pelo E3. O procedimento para desbloquear uma porta no Firewall do Windows
est descrito a seguir.
NOTA
A porta padro utilizada pelo E3 a 6515, mas este comportamento pode ser alterado conforme descrito no tpico
Execuo do E3 Viewer - Execuo atravs do Menu Iniciar.
Windows XP SP3
1. V ao menu Iniciar - Painel de Controle (Start - Control Panel).
2. Clique em Central de Segurana (Security Center).
3. Clique em Firewall do Windows (Windows Firewall).
4. Selecione a aba Excees (Exceptions) e clique em Adicionar Porta (Add Port).
5. Digite um nome e o nmero da porta a ser liberada. Deixe a opo Protocolo (Protocol) selecionada como TCP.
6. Clique em OK para salvar as alteraes.
No consigo abrir um Viewer remoto pelo Internet Explorer. Por qu isto est acontecendo?
POSSVEIS CAUSAS
O Viewer no foi instalado na mquina remota
Dvidas mais Frequentes 403
Existe um firewall bloqueando o acesso ao servidor
SOLUO
Pode-se instalar o Viewer na mquina remota ou ento colocar o arquivo de instalao do Viewer na pasta C:
\Inetpub\wwwroot do computador servidor. Assim, toda vez que se tentar abrir um Viewer pelo Internet Explorer em
um computador remoto onde o Viewer no foi previamente instalado, a instalao iniciada automaticamente.
Filial PR Filial MG
Av. Sete de Setembro, 4698 - Sala 1705 Rua Antnio de Albuquerque, 156
80240-000 Curitiba - PR 7 andar, sala 705
Fone: (+55 41) 4062-5824 30112-010 Belo Horizonte - MG
E-mail: elipse-pr@elipse.com.br Fone: (+55 31) 4062-5824
E-mail: elipse-mg@elipse.com.br
Filial RJ Taiwan
Av. Luiz Carlos Prestes, 180 - 3 andar 9F., No.12, Beiping 2nd St., Sanmin Dist.
22775-055 Rio de Janeiro - RJ 807 Kaohsiung City - Taiwan
Fone: (+55 21) 2112-4682 Fone: (+886 7) 323-8468
Fax: (+55 21) 2158-1099 Fax: (+886 7) 323-9656
E-mail: elipse-rj@elipse.com.br E-mail: evan@elipse.com.br