Académique Documents
Professionnel Documents
Culture Documents
Sumrio
1 Introduo
1.1 Descrio Geral
1.2 Arquitetura do E3
7
8
9
11
12
12
2 E3 Studio
14
15
15
16
25
2.5 Organizer
43
48
79
2.8 Galeria
80
2.9 AppBrowser
81
2.10 Conectar A
84
3 Domnios
87
3.1 E3 Server
87
3.2 E3Run
88
3.3 E3 Admin
89
3.4 IOServer
90
3.5 E3 Studio
90
3.6 E3 Viewer
90
90
91
99
124
132
139
4 Drivers
140
140
154
155
4.4 Qualidade
170
5 Servidor de Dados
178
178
179
181
182
184
186
6.1 Tela
186
188
195
209
211
7 ActiveX
217
220
222
8 Quadros
224
9 Associaes
228
230
231
232
233
234
236
236
238
10 Viewer
243
244
250
250
251
11 Banco de Dados
253
254
255
259
262
12 Alarmes
264
264
268
279
13 E3Alarm
289
290
299
14 Histricos
14.1 Configuraes do Histrico
15 Storage
302
304
315
318
320
16 Consultas
332
333
341
342
17 E3Browser
343
344
345
18 E3Chart
349
350
375
379
19 E3Playback
384
384
384
389
403
407
20 Frmulas
411
412
20.2 Templates
414
20.3 Unidades
416
417
418
21 Bibliotecas
425
21.1 Galeria
426
427
436
22 Relatrios
437
437
438
439
455
456
23 Segurana
460
23.1 Usurios
461
23.2 Grupos
466
23.3 Permisses
469
473
24 E3 Viewer e E3 WebViewer
477
478
479
482
483
25 Hot-Standby
487
488
490
491
491
491
491
492
26 Configuraes Avanadas
493
494
494
494
495
495
496
497
498
27.8 Alarmes
499
27.9 E3Alarm
500
27.10 E3Browser
501
27.11 E3Chart
501
27.12 Histrico
501
27.13 Associaes
502
27.14 Viewer
502
27.15 Bibliotecas
504
27.16 Relatrios
505
507
508
508
CAPTULO
Introduo
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 no 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 desses equipamentos. Esses 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
Introdu o
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 failover (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.
1.1.3 E3 Viewer
Permite operar as aplicaes residentes no servidor em 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 ser feito o download e o registro de
todos os componentes (Telas, bibliotecas e controles ActiveX).
Introdu o
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
Notificao da Barra de Tarefas do Windows, e controlar o Domnio pela linha de comando.
1.2 Arquitetura do E3
Para supervisionar um determinado processo com um sistema SCADA, geralmente
construda uma aplicao que conter 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 esse 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 numa arquitetura comum para realizar essa 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
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 a monitorao do processo
10
Introdu o
Introdu o
11
12
Introdu o
Introdu o
13
CAPTULO
E3 Studio
O E3 Studio o ambiente de desenvolvimento do E3. Nele, possvel a criao e manuteno
de Domnios, projetos e bibliotecas.
cone do E3
2. O dispositivo de proteo dever estar conectado na porta de comunicao adequada, no
14
E3 Studio
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.
DESCRIO
Iniciar o E3 Studio
15
novo projeto.
16
E3 Studio
Aba Comandos
As opes disponveis so as seguintes:
Opes disponveis na aba Comandos
OPO
DESCRIO
Categorias
Comandos
Descrio
Aba Barra de Ferramentas: Atravs desta aba, pode-se configurar, editar ou criar novas
barras de ferramentas
E3 Studio
17
DESCRIO
Barra de ferramentas
Boto Restaurar
Boto Nova
Boto Remover
Mostrar legendas
18
E3 Studio
Aba Menus
As opes disponveis so as seguintes:
Opes disponveis na aba Menus
OPO
DESCRIO
Boto Restaurar
Aba Aparncia: Atravs desta aba, possvel alterar a aparncia das janelas e barras de
ferramentas no E3 Studio
E3 Studio
19
Aba Aparncia
As opes disponveis so as seguintes:
Opes disponveis na aba Aparncia
OPO
DESCRIO
Office XP
Windows XP
Office 2000
Office 2003
VS.Net 2005
Aba Opes: Atravs desta aba possvel configurar as especificaes gerais do projeto.
Nesse item possvel habilitar ou desabilitar as opes da barra de ferramentas
20
E3 Studio
Aba Opes
As opes disponveis so as seguintes:
Opes disponveis na aba Opes
OPO
DESCRIO
Mostrar descries
cones grandes
E3 Studio
21
DESCRIO
Tamanho da margem
Numerao da linha
Tamanho da margem
Tamanho do Tab
Fonte
Tamanho
22
E3 Studio
NOTA: Feche os editores de scripts abertos para que as modificaes sejam aplicadas.
Configuraes de Arquivos
Toda a 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 desse CRC. Caso essa verificao falhe
(ou seja, o CRC no coincida com os dados), a carga do arquivo abortada, indicando uma
corrupo dos dados do arquivo. Isso pode ser causado por falhas diversas de hardware:
memria, rede, dispositivo de armazenamento, etc.
Porm, se um projeto criado na verso atual modificado numa verso inferior a 1.00.019
build 203, o CRC no atualizado. Com isso, o arquivo no poder ser aberto novamente com
as verses atuais, pois a verificao de CRC ir falhar, mesmo que o arquivo no esteja
efetivamente corrompido. Para solucionar essa questo, necessrio habilitar a opo
Ignorar verificao de CRC. Assim, o projeto poder ser aberto numa verso atual.
Neste caso, a opo dever permanecer habilitada at que todos os objetos editados na
verso antiga tenham sido salvos com a verso atual, o que ir atualizar o CRC.
E3 Studio
23
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 esse
procedimento no sero perdidas as configuraes desses arquivos.
Configuraes do Studio
As opes disponveis deste item so as seguintes:
Opes disponveis na aba Studio
OPO
DESCRIO
24
E3 Studio
E3 Studio
COMANDO
AO
Novo
Abrir projeto
Salvar
Salva o projeto.
Salvar tudo
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.
Refazer
Organizer
Mostra ou esconde o
Organizer.
Galeria
Lista de Propriedades
Mostrar no Editor
25
CONE
COMANDO
AO
Mostrar no Organizer
Executar aplicativo
Rodar/Parar Domnio
Executar/Parar E3 Viewer
Verificar Domnio
Erro anterior
Prximo erro
Desfragmentar arquivos
Desfragmenta o arquivo
especificado.
Procurar/Substituir
Documentao de scripts
Relatrio de verses
WatchWindow
26
COMANDO
AO
Sombra do objeto
Sombra acima
Sombra abaixo
CONE
COMANDO
AO
Sombra esquerda
Sombra direita
Cor da sombra
E3 Studio
COMANDO
AO
E3Alarm
E3Browser
E3Chart
Caixa de Seleo
Boto de Opo
Lista de Seleo
Boto de Comando
Texto
Lista
Barra de Rolagem
Boto IncrementoDecremento
Editor de Texto
Boto Liga-Desliga
27
28
COMANDO
AO
Selecionar
Rotacionar
Mostra o identificador de
ordem de navegao entre os
objetos.
Linha
Conector
Retngulo
Retngulo arredondado
Elipse
Arco de Elipse
Desenho livre
Polgono
Polgono de Curvas
Figura
Texto
E3 Studio
CONE
COMANDO
AO
Display
SetPoint
Escala
Agrupar
Desagrupar
Avanar
Recuar
Zoom
Camadas
E3 Studio
COMANDO
AO
Cor do fundo
Cor da frente
29
CONE
COMANDO
AO
Cor da borda
Estilo da borda
Espessura da linha
Estilo do preenchimento
Define o estilo do
preenchimento do objeto.
30
COMANDO
AO
Alinhar esquerda
Alinhar direita
Alinhamento superior
Alinhamento inferior
Mesma largura
Mesma altura
Mesmo tamanho
Centralizar horizontalmente
Centraliza os objetos
horizontalmente.
Centralizar verticalmente
Centraliza os objetos
verticalmente.
Distribui horizontalmente
Formata o espaamento
entre objetos na horizontal.
Distribuir verticalmente
Formata o espaamento
entre objetos na vertical.
Espelhar horizontalmente
E3 Studio
CONE
COMANDO
AO
Espelhar verticalmente
Grade
E3 Studio
COMANDO
AO
Fonte
Tamanho da fonte
Determina o tamanho da
fonte.
Cor da fonte
Fonte em negrito
Fonte em itlico
Fonte sublinhada
Texto esquerda
Texto centralizado
Centraliza o texto.
Texto direita
31
32
E3 Studio
Janela Procurar/Substituir
Existem trs maneiras de se realizar a procura e a substituio:
Escolher um item no Organizer, clicar com o boto direito do mouse sobre ele, e selecionar
a opo Procurar/Substituir. Essa procura feita a partir do item, seguindo a hierarquia
(apenas objetos filhos sero pesquisados)
Clicar no menu principal do E3 Studio, em Ferramentas - Procurar/Substituir. Essa procura
feita em todos os projetos e bibliotecas abertos
Clicar no cone Procurar/Substituir
efetuada em todo o Domnio
DESCRIO
Procurar por
Boto Procurar
E3 Studio
33
OPO
DESCRIO
Palavras inteiras
Substituir por
Boto Substituir
Uma a uma
Todas
Apenas as selecionadas
Boto
ou
Boto
Boto
NOTA: Para selecionar o objeto e mostrar o local exato onde o texto se encontra, basta um
duplo-clique 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.
34
E3 Studio
EXEMPLO
10/02/2010
00:00:10
Inteiro
0
100
Ponto flutuante
10.0
40,5
Cor
255,255,0
0,0,234
Booleano
Verdadeiro
True
String
Teste
Tag
E3 Studio
OBSERVAO
Encontra em propriedades do
tipo 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.
Encontra em todas as
propriedades numricas.
Pesquisando por 10
encontrar 10 e 10.0, mas
no encontrar 10.1 ou 100.
Encontra em todas as
propriedades 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.
Encontra apenas em
propriedades do tipo Cor.
Deve necessariamente usar
vrgulas para separar os
valores, que devem estar no
sistema RGB.
Leva em considerao o
idioma do Windows para
entender a pesquisa como
sendo de um valor Booleano.
Encontra Strings inteiras ou
partes 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.
35
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. Esse assistente responsvel por guiar o
usurio na configurao do arquivo de documentao de scripts.
36
E3 Studio
E3 Studio
37
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 escolhida for Apenas os nomes dos scripts, ser gravado no arquivo o texto
seguinte:
TelaInicial_KeyDown(KeyCode, Shift)
Se for escolhida a opo Todo o script, ento todo o cdigo ser gravado com a mesma
formatao (identao, linhas em branco, etc.) feita 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
38
E3 Studio
E
<Tela1.CommandButton1:CommandButton1_Click()>
Sub CommandButton1_Click()
...
End Sub
Isto permite a identificao correta de cada script. Clique no boto Avanar para ir prxima
janela.
Na janela Separador de scripts, possvel definir o texto que ser gravado entre um script e
outro no seu arquivo de documentao. possvel escolher entre linhas em branco ou
personalizadas, e ainda informar quantas linhas do tipo escolhido sero inseridas no arquivo.
Separador de scripts
Pode-se optar entre uma Linha em branco ou uma Linha personalizada. Escolhendo a opo
Linha em branco, o arquivo de documentao ter uma linha em branco entre um script e
outro. Escolhendo a opo Linha personalizada, pode-se informar um ou mais caracteres para
compor a linha que ser 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 sero 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 e 100, no campo Entre com o nmero de linhas do
separador. Clique no boto Avanar para finalizar a configurao. Logo aps, o assistente
mostrar uma mensagem indicando a finalizao da configurao e a gerao do arquivo que
contm a documentao dos scripts.
E3 Studio
39
40
E3 Studio
Relatrio de verses
As opes mostradas nesta caixa de dilogo so as seguintes:
Opes disponveis na caixa de dilogo Relatrio de verses
OPO
DESCRIO
Projeto/Biblioteca
Verso
Comentrio
NOTA: Estes campos so apenas para visualizao, no sendo permitida sua edio.
E3 Studio
41
2.4.5 WatchWindow
A ferramenta WatchWindow permite a visualizao do valor corrente de qualquer
propriedade ou Tag em tempo de execuo no E3 Studio. Para acessar essa ferramenta, devese clicar no boto
da barra de ferramentas Padro ou acessar o menu Ferramentas WatchWindow, que a caixa de dilogo a seguir ser mostrada:
DESCRIO
Boto Adicionar
Boto Remover
Boto Atualizar
Boto Conectar
42
E3 Studio
OPO
DESCRIO
Nome
Qualidade
Estampa de tempo
Valor
Status
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
E3 Studio
43
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 (XObjects e XControls).
Os demais objetos do E3 esto nos grupos Visualizao e Objetos de Servidor. Em Visualizao
esto os objetos que rodam 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
44
E3 Studio
A manuteno da aplicao pode ser feita em qualquer um dos dois modos. As operaes
realizadas em um modo sero imediatamente refletidas no outro. Para facilitar a localizao
dos objetos, ambos os modos so intercambiveis, tanto entre si como com a aba Design da
view do objeto. Para alternar o modo de visualizao, siga estes procedimentos:
1. No modo Domnio, clique com o boto direito no objeto e selecione Mostrar no Explorer
para visualiz-lo no modo Explorer.
2. No modo Explorer, clique com o boto direito no objeto e selecione Mostrar no Organizer
para visualiz-lo no modo Domnio.
3. Em qualquer um dos modos, clique com o boto direito no objeto e selecione Mostrar no
Editor para visualiz-lo diretamente na aba Design.
4. Em qualquer view 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 podero ser
visualizadas e editadas atravs da Lista de Propriedades, se habilitada. Clicando com o boto
direito do mouse sobre cada item do Organizer, so mostradas as seguintes opes:
Opes disponveis no Organizer
OPO
DESCRIO
Fechar
Atualizar
Registrar
Salvar Como
Desfragmentar
E3 Studio
45
OPO
DESCRIO
Proteo
Nova Pasta
Inserir
Inserir Recurso
Habilitar/Desabilitar projeto
Adicionar/Remover do Domnio
Procurar/Substituir
Importar/Exportar
Documentar Scripts
Verificar
46
E3 Studio
OPO
DESCRIO
Editar Associaes
Copiar/Colar Associaes
Propriedades
E3 Studio
47
OPO
DESCRIO
E3 Studio
cada objeto podem ser gravadas suas propriedades, Associaes e itens de colees.
possvel, portanto:
Criar novos objetos do E3 a partir do arquivo CSV, desde que estes no sejam diretamente
objetos filhos do projeto ou biblioteca
Importar ou exportar qualquer propriedade de qualquer tipo de objeto do E3
Importar ou exportar qualquer tipo de Associao de objetos do E3
Exportar qualquer tipo de coleo de objetos do E3 e importar suas propriedades
Importar ou exportar qualquer tipo de item da coleo de objetos do E3
49
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
50
E3 Studio
Exportao de Objetos
Na exportao, todas as propriedades, Associaes, colees e itens de colees do objeto
selecionado e de seus filhos sero automaticamente exportadas. gerado um arquivo CSV
com uma linha para cada objeto exportado, bem como para cada Associao, coleo ou item
de coleo existente nesses 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, essa coluna contm a hierarquia com nomes separados
por pontos. Exemplo de exportao a partir de um objeto IODriver.
E3 Studio
51
Hierarquia de 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 na seo Modelos. Utilizando um modelo possvel configurar se as
Associaes, colees e itens de colees sero ou no exportados, se o objeto raiz ser
exportado ou no, quais as propriedades de cada objeto devem ser exportadas, entre outras
configuraes. Para isso, siga estes procedimentos:
1. Clique com o boto direito do mouse sobre o objeto desejado e selecione a opo Exportar.
2. Clique no boto Avanado para configurar ou selecionar um modelo.
3. Na caixa de dilogo, selecione o arquivo CSV desejado e clique no boto Salvar.
Para importar objetos, siga esses procedimentos:
1. Clique com o boto direito do mouse sobre o objeto desejado e selecione a opo Importar.
2. Na caixa de dilogo, selecione o arquivo CSV desejado e clique no boto Abrir.
52
E3 Studio
Importao de Objetos
Na importao, para cada linha lida do arquivo CSV identificado o objeto que 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 poder ter linhas como essas:
ObjectType;Name
IOFolder;Pasta1
2.6.3 Modelos
Os Modelos so arquivos INI utilizados para configurar a ferramenta de importao e
exportao, informando, por exemplo, qual o separador que deve ser utilizado no arquivo CSV,
se as Associaes dos objetos devem ou no ser exportadas, etc. 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
E3 Studio
53
de igualdade. Uma seo no pode conter duas variveis com o mesmo nome
Linhas em branco so ignoradas
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 disso, tambm permitem que o
usurio agrupe mais de uma propriedade em uma mesma coluna. Isso tudo feito atravs da
definio de identificadores, que so palavras-chave utilizadas no arquivo CSV e associadas a
propriedades ou classes de objetos no arquivo INI.
No E3, os modelos da ferramenta de importao e exportao esto definidos com as
seguintes sees e variveis:
Sees definidas para os Modelos
SEO
Header (*)
DESCRIO
Define os identificadores permitidos para
nomes de colunas e tipos de dados. Nesta
seo devero ser definidas as variveis
header e types.
(*) Seo obrigatria para a exportao.
Configuration
Types
54
E3 Studio
SEO
DESCRIO
Columns
Filter
DESCRIO
Define a ordem das colunas e os
identificadores que sero utilizados. Devem
ser listadas todas as colunas que o arquivo
CSV ter, separadas por vrgulas. Cada
identificador que no for igual a um nome de
propriedade dever ser discriminado na
seo Columns, cada um com uma varivel.
(*) Varivel obrigatria para a exportao.
types
separator
root
E3 Studio
55
SEO
DESCRIO
link
collection
objectduplicated
bindduplicated
collectionduplicated
Define o que fazer quando uma coleo prexistente estiver sendo importada. Os
valores possveis para essa varivel so: 0 askalways (sempre questiona o usurio sobre
o que deve ser feito); 1 - changealways
(sempre substitui a coleo existente pela
nova); e 2 - ignorealways (sempre ignora a
coleo sendo importada). Caso essa
varivel no seja definida, assumido o
valor askalways. Essa opo no tem valor na
exportao, nem tampouco possui o valor
createalways; neste caso, sempre
modificado para askalways.
56
E3 Studio
SEO
DESCRIO
itemduplicated
include
exclude
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 esse caractere definir um comentrio no arquivo INI. Dessa 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:
E3 Studio
57
[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
A Elipse Software fornece alguns modelos para importao e exportao de alguns tipos de
objetos. Esses 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 que sero 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 dever estar definido na seo Columns ou a
coluna ser ignorada.
58
E3 Studio
Aba Configuraes
As opes disponveis so as seguintes:
Opes disponveis na aba Configuraes
OPO
Separador de colunas
E3 Studio
DESCRIO
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) e Usar outro
caractere como separador (escolhe outro
caractere definido pelo usurio como
separador de colunas).
59
OPO
DESCRIO
Outras opes
Salvar modelo
Importao: Atravs desta aba, o usurio pode configurar as opes vlidas somente para
a importao.
60
E3 Studio
Aba Importao
As opes disponveis so as seguintes:
Opes disponveis na aba Importao
OPO
Importao de objetos duplicados
E3 Studio
DESCRIO
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 e Sempre
criar um novo objeto.
61
OPO
DESCRIO
Filtros: Atravs desta aba, o usurio pode escolher quais as classes que sero utilizadas na
importao ou na exportao, ou quais classes no deseja utilizar
62
E3 Studio
Aba Filtros
As opes disponveis so as seguintes:
Opes disponveis na aba Filtros
OPO
DESCRIO
No filtrar objetos
Boto Alterar
Boto
E3 Studio
63
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 no boto , ou
remover alguma classe, clicando no boto
64
E3 Studio
Aba Identificadores
As opes disponveis so as seguintes:
Opes disponveis na aba Identificadores
OPO
Nome da classe
E3 Studio
DESCRIO
Indica o nome da classe selecionada na
opo.
65
OPO
DESCRIO
Identificador
Boto
Boto
Boto
Propriedades: Atravs desta aba, o usurio escolhe quais as propriedades dos objetos que
deseja utilizar na importao ou na exportao. O valor inicial da lista ObjectType; as
demais propriedades devem ser adicionadas manualmente pelo usurio
66
E3 Studio
Aba Propriedades
As opes disponveis so as seguintes:
E3 Studio
67
DESCRIO
Nome da coluna
Propriedade
Botes
Boto
Boto
Boto
Boto
Ao pressionar o boto
68
E3 Studio
Seleo de Propriedades
As opes disponveis so as seguintes:
Opes disponveis na janela Propriedades
OPO
DESCRIO
Classes de objetos
Boto
Propriedades
As propriedades em negrito nesta lista j foram inseridas na lista que define as colunas do
arquivo CSV. Um duplo-clique sobre uma propriedade faz com que ela seja adicionada ou
removida, dependendo se ela j estava ou no na lista. Se a propriedade havia sido agrupada
com outras, o duplo-clique remove apenas essa propriedade do agrupamento, mantendo as
outras propriedades agrupadas corretamente.
As propriedades do tipo Font 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,
E3 Studio
69
70
E3 Studio
Exportao de Drivers
3. Escolha o local e o nome do arquivo a ser gerado. Alm do arquivo com as configuraes dos
Tags, ser gerado um arquivo com o mesmo nome, seguido do sufixo _Alarms. Esse arquivo
ser utilizado posteriormente na importao da configurao de alarmes no E3.
Para fazer a importao dos Tags no E3 3.0, siga esses passos:
1. Insira um Driver de Comunicao no Organizer do E3.
2. Renomeie o Driver para que fique com o mesmo nome do Driver utilizado na aplicao
Elipse SCADA, para que posteriormente as referncias para os Tags desse Driver sejam
importadas corretamente.
3. Clique com o boto direito do mouse no Driver de Comunicao, e clique em 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.
E3 Studio
71
Importao de Tags
72
E3 Studio
Exportao de Tags
3. Escolha o local e o nome do arquivo a ser gerado. Alm do arquivo com as configuraes dos
Tags, ser gerado um arquivo com o mesmo nome seguido do sufixo _Alarms. Esse arquivo
ser utilizado posteriormente na importao da configurao de alarmes no E3.
Para fazer a importao dos Tags no E3 3.0, siga esses passos:
1. Insira um Servidor de Dados no Organizer do E3.
2. Renomeie o Servidor de Dados para Dados, para que posteriormente as Associaes dos
objetos de Tela sejam importadas corretamente.
3. Clique com o boto direito do mouse no Servidor de Dados, e clique na 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.
E3 Studio
73
E3 Studio
E3 Studio
75
Exportao de Telas
3. Escolha o local e o nome do arquivo a ser gerado.
4. No Organizer do E3, insira uma nova Tela.
5. Clique com o boto direito do mouse sobre a 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 ser preenchida com os objetos, e nenhuma
mensagem de erro ser 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 na pasta Recursos do
Organizer, e escolhendo a opo Inserir recurso em
Arquivos de imagens com caminhos absolutos: estes arquivos devem permanecer nos seus
diretrios originais. O E3 ir procur-los no mesmo diretrio onde so encontrados pela
aplicao do Elipse SCADA
76
E3 Studio
NOTA: recomendado inserir todos os arquivos no projeto como Recursos, para que o
Viewer do E3 possa fazer o download automaticamente pela rede. Isso evita a necessidade
de ter que instalar os arquivos manualmente nas mquinas cliente.
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 5), 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 ser questionado sobre o que fazer. Caso contrrio, elas sero criadas.
E3 Studio
77
E3 Studio
E3Chart1.Pens.Pena1
E3 Studio
79
Lista de Propriedades
Pode-se configurar um valor para uma propriedade digitando diretamente no campo
selecionado, ou ainda seguindo as instrues da janela ao clicar sobre o campo Valor.
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).
Galeria
80
E3 Studio
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 ser o resultado do uso do AppBrowser. De acordo com seu contexto de utilizao,
alguns objetos no podero ser utilizados e nem sero 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 dos botes Colar e Cancelar
. Clique em Colar para aceitar o resultado e copiar o valor para o local desejado. Clique em
Cancelar para ignor-lo.
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
que ele ser automaticamente selecionado.
81
Atravs de algumas propriedades de objetos que possuem como valor um outro nome de
objeto
82
E3 Studio
Finalmente, o sexto item mostra todas as funes do VBScript disponveis para uso em
scripts
De acordo com o objeto selecionado, o quadro central mostra suas propriedades e seus
mtodos.
E3 Studio
83
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 roda o Domnio
ou se deve obter a licena em um outro servidor. Para utilizar este recurso, clique no menu
Arquivo - Conectar a, e a seguinte caixa de dilogo aberta:
84
E3 Studio
Janela Conectar a
Opes disponveis na janela Conectar a
OPO
DESCRIO
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 conectar 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 ficar em modo Demo. Um E3 Studio sem licena (modo Demo) s poder 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.
E3 Studio
85
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 rodando, a licena de E3 Studio emprestada (que
permite a execuo do aplicativo por seis horas) ser liberada, e o E3 Server finalizar a
execuo do aplicativo imediatamente (em no mximo 10 segundos).
86
E3 Studio
CAPTULO
Domnios
Um Domnio um conjunto de objetos e configuraes que definem um sistema de
superviso. Corresponde ao que se chamava de 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 roda como servio,
mesmo no modo Demo, seja ele registrado como servio ou com /regserver, e deve estar
sempre rodando. Pode tambm ser iniciado quando um E3 Studio local for iniciado, ou atravs
de um atalho para rodar 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 runtime (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 ir comparar as licenas deste novo dispositivo
com as licenas do dispositivo anterior, e far os seguintes ajustes:
Se as novas licenas forem exatamente iguais em limitaes s do dispositivo anterior,
sero aplicadas imediatamente
Domnios
87
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 rodando.
Quadrado cinza: o Domnio est carregado,
mas no rodando.
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 espera.
O E3Run sempre roda como servio, seja ele registrado como servio ou com o comando /
regserver. Este processo usa o protocolo REC para se conectar fila de banco de dados do E3
Server.
88
Domnios
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 o Domnio informado pelo usurio. O uso desta opo no
obrigatrio. Mesmo se no for informada, o Domnio ser 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
89
3.4 IOServer
O IOServer o processo responsvel pela execuo dos Drivers de Comunicao. Cada Driver
roda em um IOServer separado. 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.
90
Domnios
Domnios
91
Atravs do Assistente de Aplicaes do E3, que permite a criao de um Domnio novo com
um arquivo de projeto (.prj) ou uma biblioteca (.lib), conforme a prxima seo
Uma vez que o Assistente tenha sido acessado, a tela inicial aberta. Para continuar, clique
em Avanar.
92
Domnios
93
3.8.1.2 Domnio
Nesta tela, possvel decidir a qual Domnio pertencer o projeto ou a biblioteca que est
sendo criado. A habilitao da opo Adicionar no Domnio ativo condicionada existncia
de Domnios ativos no sistema; clicando nesta opo, o novo projeto far parte do Domnio
atual. A opo Criar um novo Domnio cria um novo Domnio, ao qual o projeto ou biblioteca
pertencer. 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
continuar sem pertencer a nenhum Domnio.
Tela Domnio
Clique no boto Avanar para prosseguir.
94
Domnios
Domnios
95
96
Domnios
Domnios
97
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 no boto Avanar para finalizar a criao da aplicao.
Aps, o sistema mostra a tela final do Assistente, com uma mensagem que indica o final do
processo de criao da aplicao.
98
Domnios
Domnios
99
NOTA: O menu Domnio - Opes no est disponvel 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.
3.9.1 Opes
Na aba Opes possvel habilitar a redundncia de servidores.
Aba Opes
As opes disponveis so as seguintes:
Opes disponveis na aba Opes
OPO
Hot-Standby
100
DESCRIO
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 ser executado e,
opcionalmente, um servidor em espera.
Domnios
OPO
DESCRIO
Servidor principal
Servidor de backup
Domnios
OPO
DESCRIO
102
Domnios
OPO
Pr-ativar os seguintes servios
DESCRIO
Permite ao usurio escolher 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 XObjects sejam avaliadas durante a
ativao em espera
I/O Drivers (sem comunicao): O valor
padro desabilitado. Se habilitado, os
IOServers sero criados durante a
ativao em espera. NOTA: Esta opo
importante em aplicativos com vrios
Drivers de Comunicao
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 ser conectado durante a ativao
em espera. Se desabilitado, ele 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 True.
103
arquivos do Domnio. O E3Run ir utilizar esta cpia local dos arquivos PRJ e LIB
Abrir sempre o arquivo DOM da rede, utilizando o caminho de rede (por exemplo, \
\server\folder\Domnio.dom)
Quando utilizar o E3 Studio, sempre editar os projetos e bibliotecas da cpia principal (na
rede). Para aplicar as alteraes, copie os projetos e bibliotecas alterados para o diretrio
local dos servidores do Domnio. Aps a cpia, clique no boto Executar Aplicativo do E3
Studio para que as alteraes sejam aplicadas no processo de tempo de execuo (E3Run)
3.9.2 Segurana
Atravs da aba Segurana, possvel determinar as configuraes de segurana do Domnio.
Esta opo utilizada como padro, caso no seja habilitada nenhuma das opes de
permisso de segurana nos usurios do projeto. Para acessar tal item, clique com o boto
direito do mouse no cone do E3 Admin na rea de Notificaes do Windows, selecione a
opo Domnio - Opes e acesse a aba Segurana. A seguinte janela ser mostrada:
104
Domnios
Aba Segurana
As opes disponveis so as seguintes:
Opes disponveis na aba Segurana
OPO
DESCRIO
Domnios
105
OPO
DESCRIO
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 timeout de bloqueio expire.
Domnios
DESCRIO
Nome
Adicionar / Remover
Nome do grupo
Domnios
107
OPO
DESCRIO
Lista de IPs
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 sero
usadas. No entanto, se o dispositivo de proteo possuir cinco licenas de Viewer e o grupo
especificar dez conexes no mximo, ser utilizado o limite de cinco conexes do dispositivo.
Ou seja, o grupo de Viewer ter sempre uma limitao de licenas adicional a ser aplicada na
conexo do Viewer.
A configurao de Grupos de Viewers deve ser feita preferencialmente com o Domnio parado.
Caso seja feita com o Domnio em execuo, ela no ter efeito at que todos os Viewers
sejam desconectados.
108
Domnios
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 chamar o mtodo Application.
TrackEvent, e o evento ser enviado para o E3 Server.
O diagrama a seguir mostra como os diferentes processos do E3 geram e tratam os eventos do
sistema:
Domnios
109
Diagrama de processos do E3
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 sero 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 acesse a
aba Registro de Eventos. A seguinte janela ser mostrada:
110
Domnios
DESCRIO
Domnios
111
OPO
Nome da tabela
DESCRIO
Indique o nome da tabela onde sero
gravados os eventos. A tabela informada
ser criada automaticamente pelo E3Run, e
ter 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)
Se o E3Run tiver que escolher entre vrios Servidores de Dados, normalmente ser 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 escolher outro Servidor de Dados que esteja
disponvel no aplicativo, e continuar com este Servidor de Dados at que outro 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 seguinte janela mostrada:
112
Domnios
Edio de eventos
Desmarque a opo Usar mensagem padro para alterar a mensagem do evento. Clique no
boto
para inserir uma macro dentro da mensagem. Apenas as macros permitidas para o
evento sero mostradas.
113
%SESSION%: Insere o nome do programa onde o usurio estava logado (Viewer, E3 Studio ou
E3 Server)
%CAUSE%: Informao adicional sobre o evento
Se o usurio Admin escrever uma senha errada enquanto fizer login no Viewer que est
rodando na mquina CLIENT004, ser gerado o seguinte evento:
"Falhou login do usurio Admin no computador CLIENT004 (usando um Viewer): login ou
senha incorretos"
114
Domnios
Domnios
115
116
Domnios
Domnios
117
3.9.5 Projetos
possvel adicionar, remover ou editar os projetos (arquivos .prj) de um Domnio. Para
acessar este item, clique com o boto direito do mouse no cone do E3 Admin na rea de
Notificaes do Windows, selecione a opo Domnio - Opes e acesse a aba Projetos. A
seguinte janela ser mostrada:
Aba Projetos
As opes disponveis deste item so as seguintes:
Opes disponveis na aba Projetos
OPO
Nome
118
DESCRIO
Esta opo lista os nomes dos projetos no
sistema.
Domnios
OPO
DESCRIO
Adicionar / Remover
Nome do projeto
3.9.6 Servidores
possvel adicionar, remover ou editar os servidores de um Domnio. Use a lista da esquerda
para selecionar um ou mais servidores a alterar. A lista indica tambm se o servidor est
habilitado ( ), em modo Manuteno ou desabilitado ( ). Para acessar este item, clique
com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do Windows,
selecione a opo Domnio - Opes e acesse a aba Servidores. A seguinte janela ser
mostrada:
Domnios
119
Aba Servidores
As opes disponveis neste item so as seguintes:
Opes disponveis na aba Servidores
OPO
DESCRIO
Nome
Adicionar e Remover
Nome do servidor
120
Domnios
OPO
DESCRIO
Domnios
121
122
DESCRIO
Esta opo lista os nomes dos Domnios
Remotos no sistema.
Domnios
OPO
DESCRIO
Adicionar / Remover
Nome do Domnio
Arquivo de Domnio
Servidor Principal
Servidor de Backup
Usurio no Domnio
Usurio
Identifica o usurio.
Senha
possvel que uma configurao de Domnio Remoto possibilite a conexo ao prprio Domnio
local. A isso 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 rodando para que tudo funcione localmente. Neste caso, para que a
configurao funcione no Studio, no campo Arquivo de Domnio, basta colocar diretamente o
caminho local do arquivo DOM (por exemplo, c:\caminho\arquivo.dom).
Domnios
123
NOTAS:
A mudana dos aliases locais com o Domnio rodando NO suportada. O que acontecer
que, se o Domnio estiver rodando, Links j resolvidos como locais continuaro sempre
locais, mesmo que o alias seja reconfigurado para conectar numa mquina remota
realmente. Para contornar isso, basta reiniciar o Domnio
As conexes do tipo loopback no aparecero na janela Licenas (ou Estatsticas) do E3
Admin e nem iro necessitar de licena de Domnios Remotos para funcionar
* Para que o nome localhost funcione, necessrio que ele esteja configurado para
apontar para o IP 127.0.0.1 (que a configurao padro do Windows)
Para maiores informaes sobre as configuraes da aba Domnios Remotos, veja o item
Configurao da Conexo
3.10.1 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.
Se j h um Domnio rodando 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 escolher o servidor e outras opes, como descrito no tpico E3
Viewer e E3 WebViewer - Execuo do E3 Viewer - Execuo Atrves do Menu Iniciar.
124
Domnios
3.10.2 Licenas
possvel visualizar as diversas licenas disponveis atravs do E3 Admin. Para acessar este
item, clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do
Windows e selecione a opo Licenas. A seguinte janela ser mostrada:
Licenas
As opes disponveis deste item so as seguintes:
Opes disponveis na janela Licena
OPO
DESCRIO
Nmero da licena
E3 Server
Domnios
125
OPO
DESCRIO
E3 Studio
E3 Viewer
E3 Viewer Only
Pontos E/S
Tags do Storage
Drivers
Servidor OPC
Para maiores informaes sobre as limitaes do modo Demo do E3, veja o tpico Limitaes
do Modo Demonstrao.
126
Domnios
3.10.3 Estatsticas
A janela Estatsticas de Comunicao mostra os dados em tempo real sobre o trfego de
informaes na rede. A lista atualizada automaticamente a cada segundo. Para acessar tal
item, clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do
Windows e selecione a opo Estatsticas.
Estatsticas de Comunicao
As opes disponveis deste item so as seguintes:
Opes disponveis na janela Estatsticas de Comunicao
OPO
DESCRIO
Computador
Dados enviados
Compresso no envio
Pacotes enviados
Dados recebidos
Compresso no recebimento
Pacotes recebidos
Conectado desde
127
tabela a seguir.
cones das conexes na janela de Estatsticas
CONE
DESCRIO
Conexo de um Studio, consumindo licenas
do E3 Server (locais ou remotas).
Conexo de um Viewer, consumindo licenas
do E3 Server (locais ou remotas).
Conexo de um Viewer Only, consumindo
licenas do E3 Server (locais ou remotas).
Este cone pode representar trs tipos de
conexes:
Conexo de Hot-Standby de outro E3
Server (sempre remota)
Conexo de Domnios Remotos de outro
E3 Server (sempre remota)
Conexo do E3 Admin (atualmente sempre
local)
Conexo da fila de operaes do banco de
dados (arquivos .e3i e .e3o, sempre local).
128
Domnios
3.10.4 Monitor
A janela Monitor mostra informaes em tempo real sobre o estado dos servidores do
Domnio. Para acessar este item, clique com o boto direito do mouse no cone do E3 Admin
na rea de Notificaes do Windows e selecione a opo Monitor.
Monitor
As opes disponveis deste item so as seguintes:
Opes disponveis na janela Monitor
OPO
DESCRIO
Domnio atual
Endereos de ping
Nome
Nome do servidor.
Endereo
Ping
Relgio
Estado
Conexo
Domnios
129
OPO
Funo
DESCRIO
Mostra uma lista de funes reportadas pelo
servidor:
Ativo: Este o servidor ativo do Domnio
Reserva: Este o servidor standby do
Domnio
Falha(n): Servidor possui falhas locais
reportadas
Prioridade: O servidor requisitou
prioridade para rodar o Domnio, este
indicador faz com que o servidor ativo
passe para o modo Standby
Candidato: O servidor candidato a rodar
o Domnio
E/S: O servidor possui IOServers ativos
3.10.5 Inicializao
Esta opo permite controlar o Domnio a ser iniciado automaticamente. O Domnio
configurado s ser executado se o E3 Server no estiver em modo Demo. Para acessar tal
item, clique com o boto direito do mouse no cone do E3 Admin na rea de Notificaes do
Windows e selecione a opo Inicializao. A seguinte janela ser mostrada:
E3 Server - Inicializao
As opes disponveis deste item so as seguintes:
Opes disponveis na janela Inicializao
OPO
O Domnio carregado
130
DESCRIO
Ao iniciar, executa automaticamente o
Domnio previamente carregado.
Domnios
OPO
DESCRIO
O Domnio configurado
Nenhum Domnio
3.10.6 Impressora
Esta opo mostra a lista das impressoras encontradas local ou remotamente, e permite que
o usurio escolha uma para ser usada pelo E3 Server. Para acessar tal item, clique com o
boto direito do mouse no cone do E3 Admin na rea de Notificaes do Windows e selecione
a opo Impressora. A seguinte janela ser mostrada:
E3 Server - Impressora
As opes disponveis deste item so as seguintes:
Opes disponveis na janela Impressora
OPO
DESCRIO
Nome da impressora
Padro
Configurar
Procurar
Domnios
131
132
Domnios
Domnios Remotos
Neste caso, o Domnio referenciado pela configurao o Domnio Servidor. possvel
tambm que os Domnios se referenciem entre si, sendo ao mesmo tempo servidores e
clientes de Domnios Remotos. Para configurar o uso de um Domnio Remoto, siga estes
procedimentos:
1. Informe um apelido para o Domnio Remoto no campo Nome do Domnio. Este campo no
sensvel a maisculas ou minsculas. Este nome ser 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.
Domnios
133
O item Servidores e Opes de Conexo contm um boto Avanado, que permite realizar
configuraes especficas da conexo entre os Domnios, atravs da janela mostrada na
figura a seguir.
DESCRIO
Verificar PING
134
Domnios
OPO
DESCRIO
135
caminho da cpia no campo Arquivo de Domnio. Dessa forma, o E3 Studio vai utilizar a cpia
local para determinar quais objetos existem, permitindo o trabalho offline. 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 disso, para que a conexo entre os Domnios possa ocorrer, todos os E3 Servers
envolvidos devero rodar 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 rodar os E3 Servers para que as
conexes remotas sejam estabelecidas.
NOTA: Para maiores informaes sobre a configurao de Domnios Remotos, veja o item
Configuraes de Domnio - Domnios Remotos.
3.11.2 Licenas
Tanto o E3 Server rodando o Domnio Cliente, quanto o que roda o Domnio Servidor, devem
ter licenas especficas para Domnios Remotos.
Quando essa licena existe, o E3 Server Servidor passa a aceitar um nmero ilimitado de
conexes externas de outros Domnios. Da mesma forma, no caso do E3 Server Cliente, ser
possvel estabelecer um nmero ilimitado de conexes. Para maiores informaes sobre as
limitaes do modo Demo do E3, veja o tpico Limitaes do Modo Demonstrao.
Domnios
Comea com um caractere que no seja uma letra (sem acentos nem "")
Possui um caractere qualquer que no seja uma letra (sem acentos nem ""), um algarismo
(0-9) ou o caractere de sublinhado
Permisses de usurio
Com isso, pode ser necessrio que a conexo com o Domnio Remoto especifique um
determinado usurio para poder ter acesso completo aos objetos do Domnio. Esse usurio
dever 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
Domnios
137
remoto, o que exige que a conexo com o Domnio Remoto especifique um determinado
usurio para poder ganhar acesso aos objetos remotos. Isso feito atravs da permisso
Acesso remoto ao Domnio, tambm do item de segurana Domnio.
NOTA: A permisso Acesso remoto ao Domnio sempre ter precedncia sobre a permisso
Acesso remoto de escrita ao Domnio. Isto significa que quando a primeira permisso for
negada, a segunda no ser 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 isso,
basta apenas especificar os nomes dos dois servidores (principal e backup) nos itens
respectivos da rea Identificao dos servidores na rede, da aba de configurao dos Domnios
Remotos. importante ressaltar que, para o correto funcionamento do Hot-Standby, esses
nomes devem ser os mesmos especificados pelo Domnio Remoto acessado. Uma vez que
haja essa configurao em tempo de execuo, o E3 Server sempre tentar 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 rodando o Domnio. Caso
os nomes dos servidores sejam modificados quando o Domnio Cliente estiver em execuo,
este ir desconectar-se e reiniciar a conexo com os novos servidores.
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 rodando o E3 Server
138
Domnios
Quando uma dessas situaes ocorrer, todos os Links do Cliente referenciando o Domnio
ficaro desconectados, assim como todos os comandos de Application.GetObject
referenciando o Domnio Remoto iro falhar (ou seja, causaro erros de script). Quando o
problema for resolvido, os Links devero conectar-se automaticamente. J os comandos de
Application.GetObject devero ser re-executados.
Domnios
139
CAPTULO
Drivers
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.
140
Drivers
Localizar Driver
Se for selecionado um Driver vlido, o sistema exibir sua janela prpria de configurao.
Logo em seguida, ser aberta a janela de importao de Tags (se disponvel).
Ao inserir um Driver em uma aplicao do E3 Studio, aberta a view do objeto, conforme a
Drivers
141
figura a seguir.
CONE
DESCRIO
Adicionar
Remover
Configurar o driver
Abre a janela de
configuraes extras do
Driver.
Tag Browser
Ativar/desativar comunicao
Ativa ou desativa a
comunicao do Driver.
142
Drivers
OPO
CONE
Contagem de tags
DESCRIO
Apresenta o nmero total de
Tags de Comunicao no
Driver.
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.
143
Drivers
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, temos acesso interface de execuo do Driver de
Comunicao denominado Gerenciador de Drivers.
Gerenciador de Drivers
As opes disponveis so as seguintes:
Opes disponveis na janela Gerenciador de Drivers
OPO
DESCRIO
Nome
Objeto(s)
Drivers
145
OPO
DESCRIO
Erros de leitura
Erros de escrita
Processo
Estado
Compartilhado
Log
Caminho
Boto Atualizar
Drivers
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.
147
148
Drivers
Drivers
149
Caso o equipamento sendo utilizado para coletar os dados informe valores de Tags que
precisam ser convertidos, pode-se utilizar as escalas dos Tags, que so basicamente uma
especificao de uma converso linear entre duas bases diferentes.
Para isto, deve-se habilitar a propriedade EnableScaling do Tag e informar os parmetros
DeviceLow e DeviceHigh (atravs das respectivas propriedades), que seriam os limites inferior
e superior do dado vindo do equipamento, alm de informar os 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 deste objeto podem ser configuradas diretamente na Lista de
Propriedades, sem a necessidade de criar scripts para isto. Demais informaes sobre as
funcionalidades das propriedades deste objeto podem ser encontradas no Manual de
Referncia de Scripts do E3, em seu captulo respectivo.
150
Drivers
Inserindo Blocos de
Comunicao
3. O sistema mostrar 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
Drivers
151
152
Drivers
Drivers
153
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.
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 standby. Aps o aviso, todos os
clientes so desconectados.
154
Drivers
Drivers
155
CONE
DESCRIO
Adicionar
Remover
Selecionar servidor
Ativar/desativar comunicao
Ativa e desativa a
comunicao do Driver.
Importar tags
Contagem de tags
156
Drivers
Drivers
157
DESCRIO
158
Drivers
Drivers
159
160
Drivers
Drivers
161
DESCRIO
Tipo de dados
Tipo de acesso
Projeto corrente
162
Drivers
OPES
Servidor OPC
DESCRIO
Mostra os tags disponveis no servidor para a
importao.
Para fazer a importao, basta selecionar o tag desejado e arrast-lo para o driver ou Grupo
OPC desejado. Para desativar a comunicao do Driver OPC, basta clicar na opo 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, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Para
maiores informaes, consulte o Manual de Referncia de Scripts do E3.
Drivers
163
164
Drivers
Drivers
165
Drivers
Drivers
167
Inserindo Blocos de
Comunicao OPC
3. O sistema mostrar 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.
168
Drivers
Tabela 5
12
77
55
42
20
89
ndice 0
NOTA: O E3 pode criar automaticamente os elementos de Bloco OPC. Para maiores detalhes,
veja a opo Importar Tags, no tpico Configurao dos Drivers OPC.
Drivers
169
4.4 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 8 bits so definidos na forma de 3 campos de
bits: Campo Qualidade, Substatus e Limite.
Os outros 8 bits (de maior ordem) esto disponveis para uso de cada fabricante. Se esses 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 essa informao usa as mesmas regras que o cliente.
170
Drivers
CAMPO QUALIDADE
DESCRIO
0 - 63
Ruim
Incerta
A qualidade do valor
incerta pelas razes
indicadas no substatus.
(Reservado)
Boa
64 - 127
128 - 191
192 - 255
Um servidor que no suporta informao de qualidade retorna 192 sempre (Bom). Tambm
aceitvel que um servidor retorne simplesmente Ruim ou Bom (0 ou 192) e sempre retorne 0
para o substatus e para o limite.
DESCRIO
LIMITE
Sem Limite
Baixo
Alto
Constante
No
especfico
O valor
ruim, mas
nenhuma
razo
especifica
conhecida.
Erro de
Configurao
H algum
4
problema de
configurao
especfico no
servidor. Por
exemplo, o
item em
questo pode
ter sido
apagado.
Drivers
171
SUBSTATUS
DESCRIO
LIMITE
Sem Limite
Baixo
Alto
Constante
No
Conectado
A entrada
8
deveria estar
logicamente
conectada a
algo, mas no
est. Esta
qualidade
pode refletir
que no h
valor
disponvel
neste
momento,
por razes
como o valor
pode no ter
sido
fornecido
pela fonte de
dados.
10
11
Falha de
Dispositivo
Uma falha de 12
dispositivo foi
detectada.
13
14
15
Falha de
Sensor
Uma falha de 16
sensor foi
detectada (o
campo Limite
pode prover
informao
adicional).
17
18
19
ltimo valor
conhecido
Comunicao 20
em falha.
Entretanto, o
ultimo valor
conhecido
est
disponvel.
Note que a
idade do
valor pode
ser
determinada
pela
propriedade
TimeStamp.
21
22
23
172
Drivers
SUBSTATUS
DESCRIO
LIMITE
Sem Limite
Baixo
Alto
Constante
Falha de
Comunicao
Comunicae 24
s esto em
falha. No h
ltimo valor
conhecido
disponvel.
25
26
27
Fora de
Servio
O Bloco est
fora de scan
ou trancado.
29
30
31
N/A
No utilizado. 32 - 63
28
Drivers
DESCRIO
No
especfico.
LIMITE
Sem Limite
Baixo
Alto
Constante
64
65
66
67
173
SUBSTATUS
DESCRIO
LIMITE
Sem Limite
ltimo valor
utilizvel
O dispositivo 68
que estava
providencian
do o valor
parou de fazlo. O valor
retornado
deve ser
considerado
velho. Note
que isso
difere de um
valor Ruim
com o
Substatus 5
(ltimo valor
conhecido).
Aquele
estado
associado
com uma
falha
detectvel de
comunicao
num 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
174
Baixo
Alto
Constante
69
70
71
Drivers
SUBSTATUS
DESCRIO
LIMITE
Sem Limite
Baixo
Alto
Constante
Sensor
impreciso
O Valor est
80
colado em um
dos limites do
sensor (nesse
caso o campo
Limite deve
estar
configurado
para 1 ou 2)
ou o sensor
est de algum
modo
conhecido
fora de
calibrao via
algum
diagnstico
interno
(nesse caso o
campo Limite
deve ser 0).
81
82
83
Unidade de
engenharia
excedida
O valor
84
retornado
est fora dos
limites
definidos
para esse
parmetro.
Note que
nesse caso o
valor do
campo Limite
indica quais
limites foram
excedidos,
mas no
necessariam
ente implica
que o valor
no possa ir
mais alm da
faixa
especificada.
85
86
87
Drivers
175
SUBSTATUS
DESCRIO
LIMITE
Sem Limite
Subnormal
O valor
88
derivado de
mltiplas
fontes e h
um nmero
menor do que
o requerido
de fontes
boas.
No utilizado
No utilizado. 92 - 127
Baixo
Alto
Constante
89
90
91
DESCRIO
LIMITE
Sem Limite
Baixo
Alto
Constante
192
193
194
195
217
218
219
No
especfico
O valor
bom. No h
condies
especiais.
No utilizado
Forado
localmente
Tipicamente
indica que a
entrada foi
desconectad
a e um valor
entrado
manualment
e foi forado.
No
especfico
216
176
Drivers
DESCRIO
No Limitado
Limite Inferior
Limite Superior
Constante
Drivers
177
CAPTULO
Servidor de Dados
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 XObjects. Para utilizar
este recurso, siga este procedimento:
1. Clique com o boto direito do mouse sobre o 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.
178
Servidor de Dados
Servidor de Dados
179
180
Servidor de Dados
Servidor de Dados
181
182
Servidor de Dados
Servidor de Dados
183
184
Servidor de Dados
Servidor de Dados
185
CAPTULO
6.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
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.
186
DESCRIO
Nome
Largura
Altura
As opes Largura e Altura estaro inicialmente preenchidas com o tamanho que a Tela deve
ter para poder ser exibida no Divisor escolhido sem que aparea a barra de rolagem. Se algum
dos valores for negativo, isto indica que o Divisor no estar visvel em tempo de execuo,
em funo da configurao do Viewer e dos tamanhos 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 sero discutidos no prximo captulo (ActiveX); os demais
objetos citados sero apresentados neste captulo.
187
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, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes.
NOTA: A qualidade grfica de uma Tela pode ser modificada, em tempo de execuo,
utilizando-se o menu contextual do Viewer e selecionando uma das opes do menu
Qualidade (esta tela). Para maiores informaes, veja a propriedade RenderQuality da Tela
no Manual de Scripts do E3.
As primitivas do editor grfico disponveis no sistema so listadas nas prximas sees. 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.
6.2.1 Linha
Permite o desenho de retas, ligando dois pontos especificados na sua criao. Para utilizar
este objeto, siga estes procedimentos:
1. Selecione a Linha
2. Clique na Tela para criar o ponto de origem da reta e arraste o mouse at seu ponto final.
6.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 no boto
da barra de ferramentas Tela, os objetos anteriormente citados mostraro seus pontos
de conexo, como na figura a seguir.
189
DESCRIO
Conectado a
Para editar ou excluir um ponto criado, clique com o boto direito do mouse sobre o ponto e
escolha 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 sobre ele com a tecla
190
CTRL pressionada.
6.2.3 Retngulo
Permite o desenho de retngulos, criados a partir de dois vrtices. Para utilizar este objeto,
siga estes procedimentos:
1. Selecione o Retngulo
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.
3. No canto superior esquerdo do objeto, aparecer o ponto responsvel pelo fator de
arredondamento do retngulo. Arraste-o mais para o centro ou mais para as bordas para
determinar a curva de seus vrtices.
6.2.5 Elipse
Permite o desenho de crculos e elipses. Para utilizar este objeto, siga estes procedimentos:
1. Selecione a Elipse
191
2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o mouse em qualquer
direo tantas vezes quantas forem necessrias para completar o desenho desejado.
6.2.8 Polgono
Permite o desenho de polgonos com lados retos. Para utilizar este objeto, siga estes
procedimentos:
1. Selecione o Polgono
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, d um clique simples no mouse. Quando
desejar finaliz-lo, clique duas vezes.
2. Clique na Tela para estabelecer o vrtice inicial do desenho e arraste o mouse em qualquer
192
direo tantas vezes quantas forem necessrias para completar o desenho desejado.
3. Quando desejar trocar a direo do desenho, d um clique simples no mouse. Quando
desejar finaliz-lo, clique duas vezes.
6.2.10 Figura
Permite mostrar imagens que estejam armazenadas em arquivos, que podem ou no
pertencer aplicao. A Figura pode ser redimensionada livremente, porm a rotao s
efetiva quando esta for um metafile convertido para smbolo. Os seguintes formatos de
arquivo so suportados: .bmp, .gif, .jpg, .ico, .wmf e .emf. Para utilizar este objeto, siga estes
procedimentos:
1. Selecione a Figura
2. Clique na Tela para criar o vrtice de origem do retngulo e arraste o mouse diagonalmente
at seu vrtice final.
3. O sistema abrir uma caixa para seleo do arquivo de imagem, conforme figura a seguir.
193
6.2.11 Texto
Permite a criao de um texto que ser exibido na Tela. Para utilizar este objeto, siga estes
procedimentos:
1. Selecione o Texto
6.2.12 Display
Permite criar um objeto que utilizado para mostrar os valores dos tags em tempo de
execuo. Para utilizar este objeto, siga estes procedimentos:
1. Selecione o Display
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, escolha o tag a ser associado propriedade Value do Display.
6.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
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, escolha o tag a ser associado propriedade Value do SetPoint.
6.2.14 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
2. Clique na Tela para criar o vrtice de origem do objeto e arraste o mouse diagonalmente
at seu vrtice final.
194
6.3.1 Alinhamento
Permite alinhar os objetos de Tela entre si ou em relao Tela. As opes de alinhamento
disponveis so:
Opes de alinhamento para objetos de Tela
CONE
OPO
DESCRIO
Alinhar Esquerda
Alinhar Direita
Alinhamento Superior
Alinhamento Inferior
Alinhamento Central
Horizontal
195
CONE
196
OPO
DESCRIO
Mesma Largura
Mesma Altura
Mesmo Tamanho
Centralizar Horizontalmente
Centralizar Verticalmente
Distribuir Horizontalmente
Distribuir Verticalmente
Espelhar Horizontalmente
Espelhar Verticalmente
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
A partir da verso 4.0, 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.
6.3.2 Grade
Conjunto de linhas horizontais e verticais que servem como referncia de posicionamento
para objetos na Tela. Ela visualizada somente no E3 Studio, e no em tempo de execuo.
No E3 Studio, possvel mostrar ou esconder a grade atravs do menu Arranjar - Grade, ou na
barra de ferramentas Alinhamento
As propriedades da Grade podem ser configuradas atravs do menu Arranjar - Edio da Grade.
Ao selecionar esta opo, a seguinte janela mostrada:
Propriedades da Grade
As opes disponveis so as seguintes:
197
DESCRIO
Pontilhada
Linhas pontilhadas
Comprimento
Largura
Cor
6.3.3 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 no boto Rotacionar
.
2. Clique nos objetos conforme a ordenao desejada. O nmero com a ordem de navegao
aparecer no canto superior esquerdo do objeto.
3. Quando o Domnio for executado, a navegao entre estes objetos ser feita conforme a
ordem especificada.
198
4. Para editar um objeto contido em um grupo, clique com o boto direito do mouse no objeto
e selecione a opo Editar Grupo.
199
NOTA: A partir da verso 4.0, 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 ser aplicado a cada um dos objetos dentro do grupo, podendo ser
desfeito utilizando-se a combinao de teclas CTRL + Z.
6.3.6 Animao
Recurso que aplica movimento a um objeto em tempo de execuo. Disponvel na barra de
ferramentas Tela. Os tipos de movimentos disponveis no sistema so:
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 no boto
Translao
Animao com Rotao: O objeto que recebe este recurso faz movimentos circulares de
acordo com o centro de rotao do objeto e seu ngulo. Para habilitar esta opo, siga estes
procedimentos:
1. Selecione o objeto na Tela e clique no boto
2. Quando o objeto criado, seu centro de rotao padro definido como o centro do
objeto, com uma inclinao de 0 graus de posio da horizontal em relao a esse centro.
Neste momento, os vrtices do objeto selecionado so indicados por pequenos crculos e
seu centro por dois crculos circunscritos.
3. Ao passar o mouse sobre o centro ou vrtices, possvel modificar o centro arrastando ou
rotacionando o objeto de um de seus vrtices em relao ao centro.
200
Rotao
201
6.3.8 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 boto 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
CTRL + ASTERISCO (*) ou CTRL + ZERO (0): Volta para o zoom padro (100%)
CTRL + Roda do mouse para cima: Aumenta o zoom
CTRL + Roda do mouse para baixo: 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.
202
6.3.9 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 configurao (no E3
Studio) quanto em execuo (no E3 Viewer) pode estar com nenhuma, uma, vrias ou todas as
camadas ativas. Isso 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 a partir do boto Camadas. As
opes disponveis so:
Opes disponveis no boto Camadas
OPO
DESCRIO
Camada
Todas as camadas
Nenhuma camada
Editar camadas
Edio de Camadas
Telas e Objetos de Tela
203
, para a criao de
ou
DESCRIO
Nome
Zoom Baixo
Zoom Alto
Fonte
204
6.3.10 Travar
Ao escolher 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, basta clicar com o boto direito do mouse sobre o objeto desejado
e escolher a opo Travar
Objeto travado
Para desabilitar esta opo, basta clicar novamente com o boto direito do mouse no objeto
e selecionar a opo Destravar.
205
6.3.12 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
seguintes opes:
Opes disponveis na barra de ferramentas Sombra
OPO
DESCRIO
Habilita ou desabilita o efeito de sombra no
objeto.
Desloca a sombra abaixo do objeto.
Desloca a sombra acima do objeto.
206
OPO
DESCRIO
Desloca a sombra esquerda do objeto.
Desloca a sombra direita do objeto.
Configura a cor da sombra do objeto.
6.3.13 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.
As opes disponveis nesta barra de ferramentas so:
Cor do Fundo: permite selecionar a cor de fundo da Tela ou do objeto de Tela a partir de
uma lista de cores pr-estabelecidas, ou criar uma nova cor personalizada.
Cor da Frente: permite selecionar a cor de frente da Tela ou do objeto de Tela a partir de
uma lista de cores pr-estabelecidas, ou criar uma nova cor personalizada.
Cor da Borda: permite selecionar a cor da borda do objeto de Tela a partir de uma lista
de cores pr-estabelecidas, ou criar uma nova cor personalizada.
Estilo da Borda: permite escolher o tipo de borda exibida pelo objeto de Tela a partir de
uma lista com estilos pr-estabelecidos: uma linha contnua, diferentes tipos de pontilhados
e tracejados, ou simplesmente nenhuma borda.
Espessura da Linha: permite escolher a espessura da linha da borda do objeto de Tela a
partir de uma lista com espessuras pr-estabelecidas entre 0 e 2,5 milmetros.
Estilo do Preenchimento: permite escolher o tipo de preenchimento exibido pela Tela ou
pelo objeto de Tela, isto , como se dar a combinao entre as cores de fundo e de frente do
objeto. Ao selecionar esta opo, a seguinte janela aberta:
207
Efeitos de preenchimento
As opes disponveis nesta janela so:
Opes disponveis na janela Preenchimento
OPO
DESCRIO
Estilos
Cor da frente
Cor do fundo
Amostra
Opaco/transparente
208
Cores
209
O boto Outra permite que o usurio selecione uma cor de qualquer parte da tela, dentro ou
fora do E3 Studio. Basta clicar no boto e aps clicar sobre a cor desejada que ela ser
capturada para a janela de cores.
Para personalizar uma cor, pode-se combinar duas metodologias: RGB (componentes de
vermelho, verde e azul) e HSL (componentes de matiz, saturao e luminosidade).
Cor personalizada
A escala RGB descreve uma cor atravs da mistura de trs cores bsicas, a saber:
Red (vermelho): indica a quantidade do componente primrio vermelho na composio da
cor
Green (verde): indica a quantidade do componente primrio verde na composio da cor
Blue (azul): indica a quantidade do componente primrio azul na composio da cor
Cada um destes elementos da cor podem ter um grau de intensidade que vai de 0 a 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 que 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
210
Estes elementos tambm podem ter seu grau de intensidade configurado entre 0 e 255.
Assim, basta especificar o valor para cada um dos itens, conforme a tonalidade da cor
desejada, ou escolher a cor desejada diretamente com o 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 Red, Green e Blue podem assumir valores de 0 a 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 nmericos, calculados atravs da frmula acima. A ferramenta Procurar/Substituir
utiliza esse 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 dado na propriedade Value alterado
de acordo com o tipo de formatao desejada.
211
terceiro campo utilizado quando o valor numrico for zero. Finalmente, o quarto campo
utilizado quando o dado for do tipo texto.
Sempre que mais de um campo for definido, o campo anterior ser considerado, mesmo que
esteja vazio. No caso de um formatador de campo vazio, o valor formatado ser sempre um
texto vazio. Note que isso difere do formato Geral, que apenas um formato vazio, sem o uso
dos separadores de campo (ponto e vrgula).
Para inserir caracteres que sero mostrados pelo formatador pode-se coloc-los entre aspas
duplas ou aps uma barra invertida. Exemplos (vlidos para todos os tipos de formatadores):
Entrada de Texto
FORMATADOR
SADA FORMATADA
"0#?"
0#?
\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:
Formatador e Sada Formatada
VALOR
FORMATADOR
SADA FORMATADA
"Positivo";"Negativo";"Zero"," Positivo
Texto"
-1
"Positivo";"Negativo";"Zero"," Negativo
Texto"
"Positivo";"Negativo";"Zero"," Zero
Texto"
"Abcd"
"Positivo";"Negativo";"Zero"," Texto
Texto"
Alm disso, 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
213
de dgitos apresentados:
Formatadores Numricos
OPO
DESCRIO
0 (zero)
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.
Independentemente 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 ser de acordo com a configurao regional do sistema. Exemplos:
Opes disponveis
DADO
FORMATADOR
SADA FORMATADA
12000
#,
12
1234567
#,#.0
1,234,567.0
FORMATADOR
SADA FORMATADA
1000
#E+00
1E+03
1000
##e-00
10e02
214
COMANDO
AO
Abc
@@
Abc Abc
xyZ
Nome: "xyZ"
FORMATADOR
SADA FORMATADA
255
"0x"XXX
0x0FF
12345
oooo\o
30071o
987
1111011011
12
BBBB - BBBB
0000 - 1100
215
FORMATADOR
SADA FORMATADA
1234.56789
dd/MMMM/yyyy
18/maio/1903
0.56789
hh:mm:ss.000 tt
01:37:45.696 PM
12.345678
hh\hmm\mss.000\s
NOTA: Os valores armazenados nas propriedades dos objetos que se referem a datas so os
valores nmericos, calculados atravs da frmula acima. A ferramenta Procurar/Substituir
utiliza esse valor armazenado no processo de pesquisa, e no os valores formatados como
data/hora mostrados na lista de propriedades.
216
CAPTULO
ActiveX
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 outra seo deste captulo.
NOTA: Para objetos ActiveX no pr-instalados pelo E3, necessrio que estes objetos
sejam instalados em todos os computadores onde a aplicao ir rodar, especialmente em
Viewers Remotos.
Alm destes, pode-se inserir qualquer outro objeto ActiveX. Para registrar um objeto ActiveX
no E3, siga estes procedimentos:
1. Acesse o menu Ferramentas - Gerenciar ActiveX. O sistema mostrar a caixa de dilogo a
seguir.
217
OPO
DESCRIO
Controles registrados no E3
Registrar
Remover
Procurar
Atualizar
Fechar
2. Clique no boto Procurar. O sistema abre uma caixa de dilogo para localizao do arquivo
que contm o ActiveX.
218
Ac tiveX
Ac tiveX
219
220
Ac tiveX
7.1.5 Texto
Exibe mensagens de texto que no podem ser editadas pelo usurio, como descries de
controles ou legendas. inserido na Tela atravs do boto
7.1.6 Lista
Exibe uma lista de itens dentre os quais o usurio pode escolher um ou mais. inserido na
Tela atravs do boto
.
Ac tiveX
221
DESCRIO
222
Ac tiveX
Ac tiveX
223
CAPTULO
Quadros
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 ocuparo
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 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
Principal ter valores que definem explicitamente o seu posicionamento, ficando o Divisor
Secundrio com o valor restante.
Assim, quando o Divisor subdividido horizontalmente, sua propriedade SplitDockPosition
recebe o valor dockTop; do mesmo modo, se a subdiviso for vertical, esta propriedade
receber o valor dockLeft. A propriedade do Divisor Secundrio receber, ento, o valor
dockRemaining, significando que este ocupar o espao que sobra.
Os cones dos objetos no Organizer identificam exatamente o posicionamento de cada
Divisor.
Posicionamento do Divisor
CONE
DESCRIO
dockBottom: este Divisor est posicionado
na parte inferior do Divisor Pai.
dockTop: este Divisor est posicionado na
parte superior do Divisor Pai.
dockLeft: este Divisor est posicionado
esquerda do Divisor Pai.
dockRight: este Divisor est posicionado
direita do Divisor Pai.
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 sobre o Quadro aberto e selecione uma das opes:
Dividir Horizontalmente ou Dividir Verticalmente, conforme o tipo de diviso desejada.
Quadros
225
2. Para remover um Divisor, clique com o boto direito do mouse sobre o Quadro aberto e
selecione a opo Remover Quadro.
3. possvel inverter a seleo original dos Divisores (transformar o Divisor Principal em
Divisor Secundrio, e vice-versa) atravs deste mesmo menu. No caso de um Divisor
Principal, clique com o boto direito do mouse no Quadro e selecione a opo Configurar
como Divisor Secundrio; no caso de um Divisor Secundrio, selecione a opo Configurar
como Divisor Principal. A propriedade SplitDockPosition dos Divisores ser
automaticamente configurada para refletir esta mudana.
4. Com a opo Selecionar Tela ou Quadro, possvel escolher a Tela ou Quadro que ser
associada propriedade SplitLink do Divisor selecionado. A escolha feita atravs de uma
janela do AppBrowser.
5. Pode-se inserir vrios Divisores no Quadro.
Divisores do Quadro
6. Para configurar os Divisores do Quadro, clique com o boto direito do mouse no Organizer
sobre o Divisor desejado e selecione a opo Propriedades.
226
Quadros
Configuraes do Quadro
As opes disponveis so as seguintes:
Opes disponveis na aba Quadro
OPO
DESCRIO
Link
Posio
Valor
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, basta localiz-la na Lista de Propriedades e fazer os devidos
ajustes. Para maiores informaes, consulte o Manual de Referncia de Scripts.
Quadros
227
CAPTULO
Associaes
Associaes (ou conexes) so ligaes feitas entre propriedades e objetos ou outras
propriedades. As Associaes trazem grande facilidade ao criar animaes e outros tipos de
lgicas comuns, minimizando a utilizao de scripts.
Pode-se acessar a aba Associaes clicando-se com o boto direito do mouse no objeto e
selecionando a opo Propriedades. Nesta aba, so mostradas as propriedades do objeto que
podem ser associadas, bem como os tipos de Associaes existentes e suas fontes.
Aba Associaes
As opes disponveis na aba Associaes so as seguintes:
Opes disponveis na aba Associaes
OPO
Propriedades
228
DESCRIO
Lista as propriedades do objeto que podem
ser associadas.
Assoc ia es
OPO
DESCRIO
Conexo
Fonte
Ao especificar a fonte da Associao, o seu texto aparecer 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 aparecer
em vermelho. Nestes casos, a opo de Verificar Domnio ir informar os locais que
necessitam de correo ou reviso. Os tipos de Associaes disponveis sero explicados nos
tpicos a seguir.
Assoc ia es
229
Associao Simples
Para utilizar este recurso, siga estes procedimentos:
1. Selecione o objeto desejado para a Associao.
2. Acesse as propriedades deste objeto atravs do clique com o boto direito do mouse e
selecione a opo Propriedades.
3. Clique na aba Associaes e selecione a propriedade para a qual deseja fazer a Associao.
O sistema indicar vrios tipos de Associaes.
4. No campo Fonte, selecione a Associao desejada e clique no boto do AppBrowser para
indicar a propriedade que deseja referenciar, ou escreva a expresso neste campo.
230
Assoc ia es
Associao Bidirecional
Para utilizar este recurso, siga estes procedimentos:
1. Selecione o objeto desejado para a Associao.
2. Acesse as propriedades deste objeto atravs do clique com o boto direito do mouse e
selecione a opo Propriedades.
3. Clique na aba Associaes e selecione a propriedade para a qual deseja fazer a Associao.
O sistema indicar vrios tipos de Associaes.
4. No campo Fonte, selecione a Associao desejada e clique no boto do AppBrowser para
indicar a propriedade que deseja referenciar, ou escreva a expresso neste campo.
Assoc ia es
231
Associao Digital
As opes disponveis nesta Associao so as seguintes:
Opes disponveis para a Associao Digital
OPO
DESCRIO
Ligado
Desligado
Pisca
232
Assoc ia es
OPO
DESCRIO
Associao Analgica
Assoc ia es
233
DESCRIO
Valor na Fonte
Valor na Propriedade
234
Assoc ia es
DESCRIO
Insere uma nova linha na tabela.
Remove a linha selecionada da tabela.
Min
Max
Valor
Pisca
235
Associao Reversa
236
Assoc ia es
Associao Mltipla
As opes disponveis nesta Associao so as seguintes:
Opes disponveis para a Associao Mltipla
OPO
DESCRIO
Insere uma nova linha na tabela.
Remove a linha selecionada da tabela.
Min
Max
Fonte
Assoc ia es
237
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.
238
Assoc ia es
De acordo com o tipo de linha, temos as seguintes informaes dispostas nas colunas:
Opes disponveis na janela Editar Associaes
OPES
DESCRIO
Nome do objeto
Propriedade / Evento
Conexo
Fonte
DESCRIO
Nome do objeto
Propriedade / Evento
Conexo
Fonte
DESCRIO
Nome do objeto
Propriedade / Evento
Conexo
Fonte
239
O boto
permite a remoo da Associao selecionada. A opo Mostrar janela de
propriedades das associaes determina se os minidialogs das Associaes sero mostrados
quando a linha estiver selecionada. Se esta janela estiver visvel, permitida a edio das
propriedades das Associaes. Seu valor padro habilitado.
240
Assoc ia es
Edio de eventos
As opes disponveis so as seguintes:
Opes disponveis na janela Editar Eventos
OPO
DESCRIO
Propriedade ou expresso
Repetir o evento
Assoc ia es
241
242
Assoc ia es
CAPTULO
10
Viewer
NOTA: A qualidade grfica das Telas pode ser modificada, em tempo de execuo, utilizandose 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
Scripts do E3.
V iew er
243
10.1.1 Visualizador
Atravs da aba Visualizador, so configuradas as opes do Viewer quanto a ttulo, Tela e
zoom, conforme explicado a seguir.
Aba Visualizador
Cada campo da aba Visualizador possui uma propriedade correspondente. As opes
disponveis so as seguintes:
Opes disponveis na aba Visualizador
OPO
Ttulo
244
DESCRIO
Determina o ttulo do Viewer. Este campo
equivale propriedade Caption do objeto
Viewer.
V iew er
OPO
Tela ou Quadro Inicial
DESCRIO
Determina a Tela ou Quadro que o Viewer ir
iniciar. Clicando no boto
, o sistema
abre uma janela de configurao, pela qual
chamar o AppBrowser, onde ser
especificada a Tela inicial de visualizao do
sistema. Este campo equivale propriedade
InitialScreen do objeto Viewer.
Zoom
V iew er
245
10.1.2 Configurao
Atravs da aba Configurao, pode-se editar as opes relativas janela, ao ttulo e
resoluo do Viewer.
Aba Configurao
Cada campo da aba Configurao possui uma propriedade correspondente. As opes
disponveis so as seguintes:
246
V iew er
DESCRIO
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
Barra de ttulo
Boto de fechar
Boto de minimizar
Boto de maximizar
Borda
Opo de redimensionar
Opo de mover
V iew er
247
OPO
DESCRIO
Resoluo da Tela
Avanado
Configuraes avanadas
As opes disponveis nesta janela so as seguintes:
248
V iew er
DESCRIO
V iew er
DESCRIO
Habilita ou desabilita a visualizao dos
erros de comunicao.
249
OPO
DESCRIO
Texto
Cor da letra
Cor de fundo
importante salientar que a associao para o Viewer deve levar o nome real do Viewer (ex:
Viewer1) e no simplesmente Application. Em scripts, ainda vale o uso de Application,
que uma propriedade de todos os objetos que retornam o Viewer.
250
V iew er
Objeto _top
2. Para configurar as propriedades do objeto Top, clique com o boto direito do mouse sobre
o mesmo 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.
V iew er
251
252
V iew er
CAPTULO
11
Banco de Dados
253
NOTA: o objeto Banco de Dados pode ser configurado para funcionar como rea de Alarme.
DESCRIO
Banco de Dados
Arquivo MDB
Senha do BD
254
Banc o de Dados
OPO
DESCRIO
Usurio
Senha
Testar conexo
Banc o de Dados
255
DESCRIO
Seleciona o tipo de Banco de Dados em uso
no projeto:
0: stAccess
1: stOracle
2: stSqlServer
Conexo
256
Banc o de Dados
OPO
DESCRIO
Usurio
Senha
Testar conexo
Banc o de Dados
257
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.
Banc o de Dados
259
DESCRIO
Banco de Dados
Servidor
Nome do servidor.
Banco de Dados
Biblioteca de Rede
Biblioteca de rede utilizada pelo ADO: 0 Padro; 1 - Named Pipes; 2 - Winsock TCP/IP, 3
- SPX/IPX; 4 - Banyan Vines; ou 5 - MultiProtocol (RCP).
Usurio
Senha
Testar conexo
260
Banc o de Dados
4. Caso seja necessrio, configure as opes Usurio e Senha de acordo com as definies do
SQL Server. Tais itens podem ficar em branco; neste caso, o sistema assume as
configuraes padro do E3.
5. Clique no boto OK para finalizar as configuraes.
261
O uso desse tipo de acesso deve ser restrito a casos onde no exista outra soluo. O E3
disponibiliza recursos que visam minimizar o uso desses acessos via script. Entretanto,
eventualmente o uso desse recurso pode ser necessrio.
PERMISSES
Frmulas
Permisso completa.
Histrico de usurio
Histrico
Permisso completa.
Servidor de Alarmes
Permisso completa.
Nas permisses, a expresso Permisso completa significa que o usurio ter permisses
para:
Criar ou remover tabelas existentes
Criar ndices e chaves
Inserir e excluir dados nas tabelas criadas
Consultas sobre as tabelas resultantes
262
Banc o de Dados
Banc o de Dados
263
CAPTULO
12
Alarmes
264
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 Explorer, e escolha 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
265
266
Alarmes
DESCRIO
Verificar alarmes
Campos do usurio
Alarmes
267
ActiveHighAlarms
ActiveHighNACKAlarms
ActiveLowAlarms
ActiveLowNACKAlarms
ActiveMedAlarms
ActiveMedNACKAlarms
ActiveNACKAlarms
Alarm
AlarmVerify
268
Alarmes
Alarmes
269
DESCRIO
Nome da Tabela
270
Alarmes
OPO
DESCRIO
Campos
Gerar Tabela
Alarmes
271
DESCRIO
Acked
AckRequired
AckTime
AckTimeDbl
ActorID
AlarmSourceName
272
Alarmes
OPO
DESCRIO
Area
ChangeMask
ConditionActive
ConditionName
Cookie
CurrentValue
Alarmes
273
OPO
DESCRIO
Enabled
EventCategory
EventCLSID
EventTime
EventTimeDbl
EventTimeUTC
274
Alarmes
OPO
DESCRIO
EventType
FormattedValue
FullAlarmSourceName
InTime
InTimeDbl
Message
OutTime
OutTimeDbl
Alarmes
275
OPO
Quality
DESCRIO
Qualidade do valor de Fonte de alarme no
momento do evento. Este campo assume os
seguintes valores numricos:
0 - 63: qualidade ruim
64 - 127: qualidade incerta
128 - 191: valor no definido
192 - 255: qualidade boa
Se o evento no for um alarme (por exemplo,
se ele estiver usando o mtodo
LogTrackingEvent do Servidor de Alarmes),
este campo ser igual a uma String vazia.
Exemplo: Ruim (0); Incerta (64); ?? (128); Boa
(192).
Severity
Source
276
Alarmes
OPO
SubConditionName
DESCRIO
Nome da subcondio, 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,
se ele estiver usando o mtodo
LogTrackingEvent do Servidor de Alarmes),
este campo ser igual a uma String vazia. O
limite deste campo, quando armazenado no
Banco de Dados, de 100 caracteres.
Campos do Usurio
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 sero usados quando for necessrio registrar o tempo (em ms) 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
Alarmes
277
Tabela Fields
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 em sua aplicao.
278
Alarmes
DESCRIO
Campo
Identificador do campo.
Nome
Tipo
Tamanho
Fonte
NOTA: O objeto Fonte de Alarme pode ser criado dentro de qualquer objeto do Servidor.
Alarmes
279
280
Alarmes
Fontes de Alarmes
Ao abrir a janela de Propriedades de qualquer Fonte de Alarme e escolher a aba Fonte, a
seguinte janela aberta:
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), basta clicar na caixa de
seleo correspondente acima. Todas as Fontes de Alarme possuem as seguintes
propriedades gerais:
Texto da Mensagem: Esta mensagem ser armazenada no campo Mensagem do evento de
alarme enquanto ele estiver ativo. Ou seja, poder ser visualizada no E3Alarm (sumrio de
alarmes), armazenada no Banco de dados, etc. O limite do texto da mensagem de 200
caracteres
Alarmes
281
H vrios tipos de Fontes de Alarme que podem ser inseridas em objetos do Servidor. As
opes disponveis so descritas nas prximas sees.
12.3.1 Analgico
Permite monitorar uma varivel analgica, pela especificao de at quatro nveis de alarme,
que so o LoLo (Muito Baixo), Lo (Baixo), Hi (Alto) e HiHi (Muito Alto).
Aba Analgico
As opes disponveis so as seguintes:
Opes disponveis na aba Analgico
OPO
DESCRIO
Limite
282
Alarmes
OPO
DESCRIO
Texto da mensagem
Severidade
Pede Ack
Evento
Espera
Banda morta
Volta ao normal
12.3.2 Digital
Permite monitorar uma varivel digital, pela especificao de alarme na borda de subida (em
-1 ou Verdadeiro) ou na borda de descida (em 0 ou Falso).
Aba Digital
Alarmes
283
DESCRIO
Alarme Digital
Valor
Texto da mensagem
Severidade
Pede Ack
Espera (ms)
Volta ao normal
Banda morta
Este tipo de alarme interessante quando a referncia (SetPoint) varivel, e tambm
284
Alarmes
DESCRIO
SetPoint
BM
Valor
Texto da mensagem
Severidade
Pede Ack
Alarmes
285
OPO
DESCRIO
Espera (ms)
Volta ao normal
DESCRIO
TDV
Variao p/seg
286
Alarmes
OPO
DESCRIO
Texto da mensagem
Severidade
Pede Ack
Espera (ms)
Volta ao normal
12.3.5 Discreto
Permite monitorar uma varivel pela especificao de mltiplas subcondies.
Aba Discreto
As opes disponveis nesta aba so as seguintes:
Opes disponveis na aba Discreto
OPO
Boto
Alarmes
DESCRIO
Adiciona uma nova Subcondio no alarme.
287
OPO
DESCRIO
Boto
Nome
Nome da Subcondio.
Habilitado
Descrio
Descrio da Subcondio.
Valor
Texto da mensagem
Tipo
Severidade
Pede Ack?
Espera (ms)
Volta ao normal
288
Alarmes
CAPTULO
13
E3Alarm
E3Alarm
Para utilizar este objeto, siga estes procedimentos:
1. Insira este objeto no projeto atravs do clique com o boto direito do mouse em uma Tela
ou na rea de trabalho e selecione a opo Inserir - E3Alarm, ou ento atravs da barra de
ferramentas Objeto, selecionando o boto
E3Alarm
E3Alarm.
289
Inserindo um E3Alarm
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, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes.
Aba Geral
290
E3Alarm
Cada campo da aba Geral possui uma propriedade correspondente. As opes disponveis so
as seguintes:
Opes disponveis na aba Geral
OPO
DESCRIO
E3Alarm
291
Aba Colunas
A lista Campos disponveis mostra todos os campos da Fonte de Alarme. Atravs do boto
Adicionar, pode-se acrescentar campos individualmente no E3Alarm. Atravs do boto
Propriedades, possvel configurar as propriedades do campo do alarme.
Propriedades da coluna
As opes disponveis so as seguintes:
292
E3Alarm
DESCRIO
Largura (pixels)
Formatador
Renomear para
Permite reconhecer
FORMATADOR
SADA FORMATADA
Severidade Alta
;;;
Alta
Severidade Mdia
"A";"M";"B"
E3Alarm
293
DADO
Severidade Baixa
FORMATADOR
;;;
SADA FORMATADA
Baixa
FORMATADOR
SADA FORMATADA
Verdadeiro
"OK";"No OK"
OK
Falso
"OK";"No OK"
No OK
Verdadeiro
"AAA"
AAA
Falso
"AAA"
No
Verdadeiro
Sim
Falso
No
Para remover algum campo indesejado, basta selecion-lo e clicar no boto Remover.
Aba Ordenao
Cada campo da aba Ordenao possui uma propriedade correspondente. As propriedades
294
E3Alarm
disponveis so as seguintes:
Opes disponveis na aba Ordenao
OPO
DESCRIO
Pelo campo
Ascendente
Descendente
E3Alarm
295
Aba Cores
Clicando no boto
possvel selecionar a cor para o tipo de alarme selecionado. A
seguinte janela mostrada:
DESCRIO
Cor de fundo
Cor do texto
296
E3Alarm
OPO
DESCRIO
No pisca
possvel tambm escolher as cores por severidade, para cada tipo de alarme.
297
DESCRIO
Redefinir pisca
Aba Fonte
As opes disponveis so referentes a tipo, tamanho e efeitos da fonte.
298
E3Alarm
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, isso
pode ser dividido em dois casos:
Se a opo Pede Ack da Fonte de Alarme estiver em Falso, o alarme ser considerado
reconhecido desde a sua ativao, sem a necessidade de reconhecimento. Neste caso, o
alarme ficar 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 sair da lista do E3Alarm quando as duas condies forem satisfeitas
E3Alarm
299
DESCRIO
Somente os alarmes selecionados sero
reconhecidos.
Reconhece todos os alarmes do filtro corrente Todos os alarmes visveis neste E3Alarm
sero reconhecidos.
Reconhece globalmente todos os alarmes
300
E3Alarm
Exemplo de ordenao
Na figura anterior, os alarmes esto ordenados primeiro por rea, de forma ascendente, e
depois por data e hora (Entrada), tambm de forma ascendente.
E3Alarm
301
CAPTULO
14
Histricos
302
Histric os
Opes do Histrico
As opes disponveis so as seguintes:
Opes disponveis na view do Histrico
BOTO
DESCRIO
Adiciona campos na tabela do Histrico.
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 sero 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. Acesse as propriedades do Histrico. Para tanto, clique com o boto direito do mouse
sobre o objeto e acesse 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, basta localiz-la
na Lista de Propriedades e fazer os devidos ajustes. Demais informaes sobre as
funcionalidades das propriedades deste objeto podem ser encontradas no Manual de
Referncia de Scripts do E3, no captulo referente ao objeto Histrico.
NOTA: O objeto Histrico pode ser configurado para funcionar como rea de Alarme.
Histric os
303
304
Histric os
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 do boto
ou clicando no cone
DESCRIO
Nome do ndice
Nome do campo
Ordenao
Tipo
Histric os
305
Clicando no boto OK, confirma-se que o campo determinado uma chave primria da tabela.
Para cancelar a configurao, clique no boto Cancelar. Pode-se tambm atribuir um ndice
tabela.
14.1.2 ndices
Um ndice um campo ou conjunto de campos que sero 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 ele encontre os registros relevantes. Quanto maior a tabela, maior ser
o custo dessa 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, no entanto, mais rpido acess-los
sequencialmente, pois isto evitaria 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
conforme figura a seguir:
306
Histric os
DESCRIO
Nome
Campos
Adicionar
Editar
Remover
Histric os
307
Adicionando ndices
As opes disponveis deste item so as seguintes:
Opes disponveis na adio de ndices
OPO
DESCRIO
Nome do ndice
Nome do campo
Ordenao
Tipo
308
Histric os
Aba Histrico
Cada campo da aba Histrico possui uma propriedade correspondente. As opes disponveis
so as seguintes:
Opes disponveis na aba Histrico
OPO
DESCRIO
Nome da tabela
Histric os
309
OPO
DESCRIO
<Tabela Principal>
<Tabela de Backup>
Gerar Tabela
Histric os
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.
Campos
Os campos disponveis na tabela do Histrico so os seguintes:
Campos da tabela do Histrico
CAMPOS
DESCRIO
FieldDeadBand
Banda morta.
FieldDeadBandUnit
FieldDescription
Descrio do campo.
FieldEU
Unidade de Engenharia.
FieldHighEng
FieldID
FieldLowEng
FieldMaxRecTime
Histric os
311
CAMPOS
DESCRIO
FieldMinRecTime
FieldName
FieldQuality
FieldSize
Tamanho do campo.
FieldSource
FieldType
Tipo do campo.
312
Histric os
Mensagem do sistema
Clicando em Cancel, os campos configurados na tabela iro permanecer com as configuraes
atuais. J clicando em OK, todos os campos, ndices e chaves primrias definidas no Histrico
sero substitudos pelos dados da tabela selecionada.
Quando este item utilizado, outros dois botes so habilitados:
vnculos diretos com tabela existente e
Quando a opo Manter Histrico sem vnculos diretos com tabela existente
o sistema mostra a seguinte mensagem:
habilitada,
Histrico aps a habilitao da 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:
Histric os
313
314
Histric os
CAPTULO
15
Storage
O Storage um mdulo alternativo de gravao dos dados histricos. Atravs dele, possvel
transformar dados de produo, processos, outras coletas e informaes gerenciais. Este
mdulo permite que diversas informaes sejam coletadas atravs de servidores OPC,
drivers 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
houver uma variao significativa, definida pelo usurio. A verificao das variaes
analisada pelo algoritmo BoxCar/BackSlope, que permite uma compactao de at 93% nos
dados, com uma recuperao total das informaes realmente teis, dependendo da banda
morta definida.
A recuperao dos dados no ambiente do E3 pode ser feita atravs de uma ferramenta de
consulta padronizada, que permite montar sua estrutura de consulta de forma grfica (similar
ao existente nas ferramentas Microsoft Access ou SQL Server) ou ainda editar diretamente
as consultas SQL. Os dados extrados podem ser visualizados em formato tabular (E3Browser),
em grfico (E3Chart), ou ainda em relatrios que permitem visualizao em tela (propriedade
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 nas sees a seguir.
Grfico sem compactao
A informao processada contm vrios pontos.
Storage
315
316
Storage
NOTA: O objeto Storage pode ser configurado para funcionar como rea de Alarme.
Storage
317
DESCRIO
Adiciona campos na tabela do Storage.
Remove o campo selecionado na tabela do
Storage.
Determina as configuraes da tabela do
Storage.
Gera a estrutura no Banco de Dados.
Nome
Fonte
318
Storage
OPO
DESCRIO
Tipo
MinRecTime
MaxRecTime
Varredura
Banda Morta
Unidade
Storage
319
Propriedades.
2. Atravs do clique com o boto direito do mouse sobre o objeto no Organizer e selecionando
a opo Propriedades.
Campos do Storage
Cada campo da aba Storage possui uma propriedade correspondente. As opes disponveis
so as seguintes:
Opes disponveis na aba Storage
OPO
DESCRIO
Nome da tabela
320
Storage
OPO
DESCRIO
Gerar Tabela
Aps definir as configuraes da tabela, necessrio clicar no boto Gerar Tabela. Esta ao
cria a estrutura da tabela no banco de dados.
A estrutura de tabelas do Storage semelhante estrutura do Histrico: uma tabela de
definies, uma tabela principal de dados e uma tabela de backup (se escolhida pelo
usurio). Para que se possa identificar externamente que uma tabela compactada, s
verificar se foi criada a tabela _Fields.
Storage
321
Tabela Fields
Esta tabela possui os seguintes campos:
Campos da tabela _Fields
CAMPOS
DESCRIO
FieldDeadBand
Banda morta.
FieldDeadBandUnit
FieldDescription
Descrio do campo.
FieldEU
Unidade de Engenharia.
FieldHighEng
FieldID
FieldLowEng
FieldMaxRecTime
FieldMinRecTime
FieldName
Nome do campo.
FieldQuality
Qualidade do campo.
FieldScanTimeMs
322
Storage
CAMPOS
DESCRIO
FieldSize
Tamanho do campo.
FieldSource
FieldType
Tipo do campo.
FieldVARTYPE
323
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 esse 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
ter 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 ser 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.
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).
324
Storage
Storage
325
SampledData: Retorna, para um ou mais Tags, os valores interpolados (ou seja, estimados)
entre os instantes definidos pelas variveis StartTime e EndTime, a intervalos fixos
definidos pela varivel TimeInterval. As variveis tambm podem ser definidas em
execuo a partir da chamada do mtodo SetVariableValue da Consulta
CalculatedData: Retorna, para um ou mais Tags, o resultado de operaes matemticas
aplicadas aos dados entre os instantes definidos pelas variveis StartTime e EndTime
, a intervalos fixos definidos pela varivel TimeInterval. Os tipos de clculos so: Total,
Mnimo, Mximo, Desvio Padro, Amplitude, Mdia e Mediana. As variveis tambm
podem ser definidas em execuo a partir da chamada do mtodo SetVariableValue da
Consulta
Para todas as opes possvel indicar se os dados com qualidade Ruim sero includos ou
no na resposta, atravs da caixa de seleo Incluir Qualidade Ruim.
Funes
15.2.3 Utilizao
Se a funo escolhida possui algum filtro, ento necessrio informar o valor dos filtros antes
de executar a consulta, seja na prpria caixa de dilogo de configurao (atravs da aba
Visualizar) ou atravs de scripts, usando o mtodo SetVariableValue. Exemplos:
326
Storage
FUNO QUERY
STORED PROCEDURE
LastValue
E3LastValue
ArchivedValue
E3Archive, E3ArchiveInterpolate
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 feito para
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
Storage
327
15.2.4.1 E3LastValue
Retorna o ltimo valor de um determinado Tag que est armazenado no Banco de Dados. A
descrio formal :
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, 2: Analgico)
@bQuality: se diferente de 0, 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.2 E3Archive
Retorna um valor armazenado em relao a um instante, conforme o exposto na funo
ArchivedValue. usada somente para os SubTipos Prev (0), Next (2) e ExactTime (3). A
descrio formal :
E3Archive(@iSubType int,
@strTableName varchar(100),
@dData float,
@strFieldName VARCHAR(100),
@strFilter VARCHAR(500),
@type int,
@bQuality int)
Onde:
@iSubType: subtipo da funo, sendo 0: Prvio, 2: Prximo, 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
328
Storage
15.2.4.3 E3ArchiveInterpolate
Retorna os pontos imediatamente anteriores e posteriores a um instante, conforme exposto
para a funo ArchivedValue, porm somente para o Subtipo Interpolado. A descrio formal
:
E3ArchiveInterpolate(@strTableName varchar(100),
@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.4 E3NCompData
Equivale funo CompressedDataNValues. A descrio formal :
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
Storage
329
15.2.4.5 E3CompData
Equivale funo CompressedDataStartEndTime. A descrio formal :
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
15.2.4.6 E3SampledData
Equivale funo SampledData. A descrio formal :
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
@dEndData: a data final, em formato Float
@strFields: lista de campos
330
Storage
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
15.2.4.7 E3CalculatedData
Equivale funo CalculatedData. A descrio formal :
E3CalculatedData(@iSubType int,
@strTableName varchar(100),
@iModMin int,
@dStartDate float,
@dEndDate float,
@strFields VARCHAR(1000),
@strWhere VARCHAR(4000),
@type int,
@bQuality int)
Onde:
@iSubType: subtipo do clculo, sendo 0: Total, 1: Mnimo, 2: Mximo, 3: Desvio Padro, 4:
Amplitude, 5: Mdia e 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
Storage
331
CAPTULO
16
Consultas
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 vo buscar dados do 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 num Banco de Dados, so enviados comandos no formato SQL (Structured Query
Language). A consulta apresenta uma interface amigvel, que permite a construo das
consultas numa 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 faz 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 sobre a Tela do projeto e selecione as opes Inserir Consulta.
Antes de definir a Consulta, deve-se informar o Servidor de Banco de Dados no qual a Consulta
ir buscar os dados. Para tanto, selecione o servidor na caixa de listagem Nome do Servidor:
332
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, basta localiz-la na Lista de Propriedades e fazer os devidos ajustes. Para
maiores informaes, consulte o Manual de Referncia de Scripts do E3.
Consultas
333
Adio de tabela
3. Selecione as tabelas que faro parte da consulta e clique no boto OK.
4. Depois de definidas as tabelas, a janela de definio da Consulta mostrada, contendo
quatro abas:
Campos
Variveis
Visualizar
SQL
334
Consultas
Configurao da Consulta
Estas abas so descritas nas prximas sees.
Consultas
335
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.
336
Consultas
rea de colunas
Cada coluna mostra as seguintes propriedades para cada campo da tabela ou tabelas
selecionadas.
Opes disponveis para a configurao de colunas
OPO
DESCRIO
Colunas
Ttulos
Tabela
Mostrar
Ordenao
Ordem
Agrupado por
Funo
Filtro
Ao definir um filtro, a janela a seguir ser mostrada, permitindo que se defina o tipo de
comparao e o valor a ser comparado.
Consultas
337
Definindo um filtro
O tipo de dado de comparao pode ser definido ao clicar na caixa de seleo correspondente
e selecionando um dos tipos na lista de opes (Empty, NULL, Boolean, Byte, Integer, Long,
Currency, Single, Double, Date e String).
'<%
#<%
338
Consultas
O valor da varivel pode ser definido na aba Variveis ou atravs do mtodo SetVariableValue,
chamado via script.
Aba Variveis
As colunas desta aba so descritas na tabela a seguir.
Opes disponveis na aba Variveis
OPO
DESCRIO
Nome
Valor
Consultas
339
Visualizao da Consulta
340
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.
Consultas
341
342
Consultas
CAPTULO
17
E3Browser
E3Browser
Para utilizar este recurso, siga estes procedimentos:
1. Insira um E3Browser no projeto atravs do clique com o boto direito do mouse na rea de
trabalho, e selecionando o objeto 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, basta localiz-la na
Lista de Propriedades e fazer os devidos ajustes. Demais informaes sobre as
funcionalidades das propriedades deste objeto podem ser encontradas no Manual de
Referncia de Scripts do E3, em seu captulo respectivo.
E3Brow ser
343
A aba Consulta mostra os campos disponveis na consulta. Tais campos podem ser acessados
atravs do boto Configurar, que abre o assistente de configurao da consulta.
344
E3Brow ser
Aba Consulta
Para maiores informaes sobre a Consulta, veja o captulo Consultas.
E3Brow ser
345
DESCRIO
Estilo de grade
Altura do cabealho
Aba Opes
346
E3Brow ser
DESCRIO
Atualizao
Tipo de seleo
DESCRIO
Propriedades
Conjunto de cores
E3Brow ser
347
OPO
DESCRIO
Paleta de Cores
348
E3Brow ser
CAPTULO
18
E3Chart
E3Chart
349
350
E3Chart
Aba Item
Cada campo da aba Item possui uma propriedade correspondente. As opes disponveis so:
Opes disponveis na aba Item
OPO
DESCRIO
Nome
Documentao
E3Chart
351
Aba Posio
Cada campo da aba Posio possui uma propriedade correspondente. As opes disponveis
so as seguintes:
Opes disponveis na aba Posio
OPO
DESCRIO
Posio X
Posio Y
Largura
Altura
352
E3Chart
Aba Geral
Cada campo da aba Geral possui uma propriedade correspondente. As opes disponveis so
as seguintes:
Opes disponveis na aba Geral
OPO
DESCRIO
Mostrar ttulo
E3Chart
353
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 no boto
Adicionar, criado um novo Eixo no grfico e aberta uma janela de configurao que permite
determinar as propriedades do objeto Eixo. Esta janela possui duas abas, Geral e Escala, e
tambm pode ser acessada ao clicar o boto Configurar.
A aba Geral contm a informao que identifica a Pena no sistema.
354
E3Chart
Propriedades do Eixo
Cada campo da aba Geral possui uma propriedade ou mtodo correspondente. As opes
disponveis so as seguintes:
Opes disponveis na aba Geral
OPO
DESCRIO
Nome
Posio
Espelhar o eixo
E3Chart
355
OPO
DESCRIO
Ttulo do eixo
Cor da escala
Visvel
Estilo da linha
Automtico
Nmero de subdivises
Clique em Apply para visualizar as modificaes feitas nesta janela, e em OK para salv-las.
A aba Escala define as configuraes da escala do Eixo.
356
E3Chart
DESCRIO
Define o Eixo como sendo uma escala
numrica. Este campo 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
E3Chart
357
OPO
DESCRIO
Inverter Escala
Formatao
Clique em Apply para visualizar as modificaes feitas nesta janela, e em OK para salv-las.
358
E3Chart
Aba Penas
As opes disponveis so as seguintes:
Opes disponveis na aba Penas
OPO
DESCRIO
Adiciona uma Pena. Mostra um menu que
permite escolher o tipo de Pena que ser
criada: Tempo Real, Histrica ou Tempo Real
& Histrica.
Remove as Penas selecionadas.
Abre a janela de propriedades da Pena
selecionada (essa operao s permitida
se apenas uma Pena estiver selecionada).
Move a Pena selecionada uma posio para
cima (essa operao s permitida se
apenas uma Pena estiver selecionada).
Move a Pena selecionada uma posio para
baixo (essa 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. Basta clicar com o boto direito do mouse na Pena desejada (ou
nas Penas selecionadas, em caso de mltipla seleo) e selecionar a opo Copiar (CTRL + C).
No E3Chart de destino, basta abrir a janela de Propriedades e, na aba Penas, clicar com o
boto direito do mouse na listagem de Penas e selecionar 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.
Algumas propriedades da Pena podem ser configuradas diretamente na lista mostrada na
aba Penas. Na coluna Estilo, ao clicar em
E3Chart
DESCRIO
Cor principal
Cor do fundo
Tipo de desenho
Estilo do trao
Espessura da linha
Amostra
360
E3Chart
Propriedades da Pena
Cada campo da aba Geral possui uma propriedade correspondente. As opes disponveis so
as seguintes:
Opes disponveis na aba Geral
OPO
DESCRIO
Nome da Pena
Cor principal
Visvel
E3Chart
361
OPO
Unidade de Engenharia
DESCRIO
Indica a unidade de engenharia utilizada
pela Pena. Este campo equivale
propriedade EU da Pena.
362
DESCRIO
Determina o tipo de Pena sendo utilizada.
Este campo equivale propriedade
DataSourceType da Pena.
E3Chart
OPO
DESCRIO
Consulta local
Consulta externa
Eixo vertical
E3Chart
363
OPO
DESCRIO
Eixo horizontal
Estilo da Pena
Cada campo da aba Estilo possui uma propriedade correspondente. As opes disponveis so
as seguintes:
Opes disponveis na aba Estilo
OPO
Tipo de desenho
364
DESCRIO
Indica o tipo de desenho da Pena. Este
campo equivale propriedade PenType da
Pena.
E3Chart
OPO
DESCRIO
Estilo do trao
Espessura da linha
Cor do fundo
Documentao
Cor de alarme
E3Chart
365
366
E3Chart
DESCRIO
E3Chart
367
OPO
DESCRIO
368
E3Chart
Estatsticas
Cada campo da aba Estatsticas possui uma propriedade correspondente. As opes
disponveis so as seguintes:
Opes disponveis na aba Estatsticas
OPO
DESCRIO
E3Chart
369
370
E3Chart
DESCRIO
Mostrar Legenda
Tamanho
Cor do fundo
Colunas disponveis
Colunas selecionadas
Adicionar
Propriedades
Remover
Sobe/Desce
E3Chart
371
DESCRIO
Cor da Pena
Descrio da Pena
DifX
DifY
EscalaX
EscalaY
Estado
FimX
FimY
InicioX
InicioY
MaximoY
MediaY
MinimoY
Nome da Pena
Nome do tagX
Nome do tagY
Unidade
Valor do tagX
372
E3Chart
OPO
Valor do tagY
DESCRIO
Mostra o valor da pesquisa no Eixo Y.
Propriedades da coluna
Cada campo da caixa de dilogo Propriedades da coluna possui uma propriedade
correspondente. As opes disponveis so as seguintes:
Opes disponveis na janela Propriedades da coluna
OPO
DESCRIO
Largura inicial
Ttulo da coluna
Alinhamento do texto
Formatador
E3Chart
373
DESCRIO
Consultas
Configurar
Adicionar
Remover
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.
374
E3Chart
Aba Fonte
As opes disponveis so referentes a tipo, tamanho e efeitos da fonte.
E3Chart
375
Sub CommandButton1_Click()
Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Disconnect()
End Sub
376
E3Chart
E3Chart
377
3. Crie dois botes na Tela. No primeiro, mude a propriedade Caption para "Desabilitar
Visualizao da Pena".
4. Acesse as propriedades deste boto e selecione a aba Scripts. No evento Click do boto de
comando, escreva o seguinte script:
Sub CommandButton1_Click()
Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Visible = False
End Sub
378
E3Chart
DESCRIO
Caixa de zoom
Mover
Mover horizontalmente
Pesquisar
E3Chart
379
OPO
DESCRIO
Pesquisar Intervalos
Menos Zoom
Mais Zoom
Enquadrar tudo
Enquadrar verticalmente
Enquadrar horizontalmente
Enquadrar Pena
380
E3Chart
NOTA: Para obter maiores informaes sobre as colunas Valor do Tag X e Valor do Tag Y, veja
o tpico Configuraes da Legenda.
Pesquisa de intervalos
E3Chart
SIGNIFICADO
No houve conexo da parte de tempo real
da Pena. Verifique o nome dos Tags nas
propriedades YLink e XLink da Pena.
381
MENSAGEM
Info: Tempo real n pts
SIGNIFICADO
Mostra o nmero total de pontos da parte de
tempo real.
SIGNIFICADO
Info: n pts
Info: Carregando
382
E3Chart
SIGNIFICADO
Cursor ocupado
Erro desconhecido
E3Chart
383
CAPTULO
19
E3Playback
384
E3Play bac k
E3Play bac k
385
Tela UpperMenu
5. D um duplo-clique no Stopwatch, adicione o pick Abrir Tela no evento Click, para abrir a
TelaPlayback no Quadro principal e configure-o conforme as figuras a seguir.
386
E3Play bac k
387
finalmente clique sobre o cone Stopwatch. Neste momento deve aparecer a tela de
playback.
Tela de playback
7. Aperte o boto para entrar no modo online. Os primeiros dados de playback sero
carregados, e o relgio de playback ser posicionado no centro dos dados disponveis.
388
E3Play bac k
E3Play bac k
389
390
COMANDO
AO
Pausa
Reproduzir
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).
E3Play bac k
CONE
COMANDO
AO
Mais Rpido
Dobra a velocidade de
playback. O valor mximo
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/Hora Atual
Mostrar/esconder a Lista de
Eventos
Iniciar/parar gravao de
vdeo
Capturar a tela do
E3Playback
E3Play bac k
391
DESCRIO
Mostra o local e o nome do arquivo de vdeo
que ser salvo. Pode ser utilizado o boto
para navegar pelas pastas do
computador.
392
E3Play bac k
OPO
DESCRIO
Compressor
Qualidade de compresso
Sobre
Gravar udio
Dispositivo
Formato
Atributos
E3Play bac k
393
Linha de tempo
Possui os seguintes componentes:
Componentes da Linha de Tempo
COMPONENTE
DESCRIO
Rgua
Cursor
394
E3Play bac k
COMPONENTE
Barra de Consultas
DESCRIO
Mostra os perodos de tempo que j tem
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 sero
necessrias se o cursor for movido para
cima do perodo
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
Caso tenha sido selecionada a opo Mostrar grfico na Linha de Tempo de um tag na Lista de
Eventos ou na Lista de Tags, ser 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 ficar 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
E3Play bac k
395
19.3.3 Marcadores
Os Marcadores so utilizados para sinalizar ocorrncias na linha de tempo do E3Playback.
COMANDO
Adicionar marcador no
timestamp selecionado
AO
Adiciona um nome ao
marcador na linha de tempo,
na data e hora selecionadas.
396
Remover o marcador
Remove o marcador
selecionado na linha de
tempo.
Remover todos os
marcadores
Seleciona o marcador
imediatamente frente na
linha de tempo e na lista de
eventos, simultaneamente.
E3Play bac k
CONE
COMANDO
Mover para o marcador
seguinte
Clicando no boto
Adicionar, ou no boto
AO
Seleciona o prximo
marcador na linha de tempo
e na lista de eventos,
simultaneamente.
DESCRIO
Data/hora/ms
Nome
Comentrios
Quando um marcador criado, ele mostrado na Linha de Tempo, como pode ser observado
na figura seguinte, e tambm na Lista de Eventos.
E3Play bac k
397
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 Read-Only, isto , no permitido o
envio de comandos e valores para o servidor do 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 ir falhar, abortando o script
Devido s vrias limitaes de acesso ao servidor, erros de script ocorridos dentro do
E3Playback no geram uma mensagem de erro, 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
398
E3Play bac k
E3Play bac k
399
Lista de Eventos
A lista possui trs colunas:
Campos da Lista de Eventos
CAMPO
Data/hora
400
DESCRIO
Mostra a data e a hora do evento, conforme
est registrado no banco de dados.
E3Play bac k
CAMPO
DESCRIO
Caminho do Tag
Evento
E3Play bac k
COMANDO
AO
Evento Anterior
Posiciona o relgio de
playback no evento anterior
ao evento selecionado na
lista, pulando os eventos
com timestamp igual ao
timestamp atual.
Prximo Evento
Posiciona o relgio de
playback no prximo evento
com timestamp maior que o
timestamp atual.
Filtrar Eventos
Filtrar marcadores
Mostra apenas os
marcadores criados.
401
Ao clicar com o boto direito do mouse sobre um evento, um menu contextual mostrado
com as seguintes opes.
Opes do menu contextual dos eventos
OPO
DESCRIO
Lista de Tags
As colunas so as seguintes:
Colunas da Lista de Tags
COLUNA
DESCRIO
Caminho do Tag
Tabela
Estado
Valor
402
E3Play bac k
COLUNA
DESCRIO
Data/hora
Qualidade
Evento Anterior
Prximo Evento
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.
E3Play bac k
403
E3Play bac k
405
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 (zero ou mais das seguintes opes):
Sumrio de alarmes anterior (estado de cada Fonte de Alarme na data/hora inicial da
consulta)
Eventos de alarmes no perodo
Sumrio de alarmes posterior (prximo evento de cada Fonte de Alarme aps a data/
hora final do perodo)
406
E3Play bac k
19.5.1 Storage
A nica recomendao para o Storage que a coluna Fonte no deve conter expresses, pois
elas no podero ser utilizadas no playback.
O E3 j cria automaticamente nas tabelas de Storage os ndices necessrios para otimizar as
consultas do E3Playback.
19.5.2 Alarmes
Para fazer playback de alarmes, siga estes procedimentos:
1. Habilite ou configure o registro de alarmes em disco.
2. Selecione os seguintes campos para registro (obrigatrio).
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
E3Play bac k
407
Message
Severity
Source
SubConditionName
CurrentValue
19.5.3 Histricos
O formato de arquivo Histrico no o ideal para playback, pois normalmente muitos dados
duplicados esto armazenados. As consultas de playback tem 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 pela 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 False (se esta propriedade ficar em True, a tabela
_Fields deste histrico no ser gerada, e este histrico no ser 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)
408
E3Play bac k
A figura a seguir mostra como deve ser a configurao do ndice do campo E3TimeStamp:
19.5.4 Licenciamento
A Elipse fornece dois pacotes de playback de acordo com as suas ferramentas:
Playback Bsico
Playback Avanado: consiste no Playback Bsico mais as ferramentas de Gravao de Vdeo
e Captura de Tela
409
modo Avanado sem limite de pontos, porm limitado a mostrar apenas as ltimas seis horas
de dados armazenados no banco.
410
E3Play bac k
CAPTULO
20
Frmulas
NOTA: O objeto Frmula pode ser configurado para funcionar como rea de Alarme.
Frmulas
411
DESCRIO
Banco de Dados
Tabela
412
Frmulas
Frmulas
413
20.2 Templates
A primeira aba na view de Frmulas chama-se Templates. Os templates definem o tipo de
dado que poder ser armazenado em cada varivel da Frmula, alm de suas restries.
Aba Templates
As opes disponveis so as seguintes:
Opes disponveis na aba Templates
OPO
DESCRIO
Nome
Tipo
Restries
414
, para a
Frmulas
DESCRIO
Limite Irrestrito
Limite Restrito
Limite Absoluto
Limite Percentual
Frmulas
415
OPO
DESCRIO
Valores fixos acima ou abaixo do valor prdefinido. Por exemplo, colocando os limites
em 10 e 50 para o valor 50, os valores
permitidos variam de 40 e 100. simbolizado
pela letra D na view Templates (e os valores
configurados no campo).
20.3 Unidades
A segunda aba na view de Frmulas chama-se Unidades. As unidades definem os Tags que
sero associados aos templates da Frmula. possvel criar vrias unidades, ou seja, vrios
grupos de Tags que podero receber os valores da Frmula.
Aba Unidades
As opes disponveis so as seguintes:
Opes disponveis na aba Unidades
OPO
DESCRIO
Nome
Unidade
, para a
Renomear , para a troca do nome da unidade selecionada. Para cada nova unidade,
solicitado um nome:
416
Frmulas
Aba Valores
As opes disponveis so as seguintes:
Opes disponveis na aba Valores
OPO
DESCRIO
Nome
Valor
Frmulas
, para a criao
417
20.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
chame a tabela de Produo.
418
Frmulas
Templates
4. Na prxima etapa, sero 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 seu
Servidor de Dados uma Pasta chamada Formula, e dentro dela outras duas Pastas
chamadas Maquina1 e Maquina2. Dentro delas crie trs Tags Internos para cada uma.
Criando Tags
5. Crie na Frmula duas unidades chamadas Maquina1 e Maquina2. Associe cada campo
destas unidades aos Tags criados anteriormente.
Frmulas
419
420
Frmulas
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. Pode-se acessar esta opo a partir do Windows Explorer.
9. Crie um boto na Tela com o ttulo "Carregar valores". Este boto ir mostrar 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
Frmulas
421
Onde Texto16 o nome do ltimo SetPoint inserido na Tela. Este comando ir carregar o
conjunto de valores especificado no SetPoint para a unidade Maquina1. Ao ser executado,
este mtodo ir buscar pelo conjunto de valores em disco. Caso encontre, ir carreg-lo
seguindo o padro de restries definido no template da Frmula. Os campos com restries
abertas podero 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.
422
Frmulas
Alterao de valor
No entanto existe uma alternativa, o mtodo LoadFormulaValuesQuiet, localizado nos
mtodos do objeto Viewer. Ser feita uma opo pelo modo silencioso na Tela, utilizando
para isto, o objeto Caixa de Seleo.
Crie um objeto Caixa de Seleo na Tela
Coloque um texto de identificao ao seu lado, com o texto "Silencioso"
Volte no script do boto OK e mude o cdigo para:
Sub CommandButton2_Click()
If Screen.Item("CheckBox1").Value = true Then
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 far com que se o objeto estiver
habilitado, seja utilizado o mtodo LoadFormulaValuesQuiet. Caso contrrio, ser 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 dever ficar parecida
com a figura a seguir.
Frmulas
423
424
Frmulas
CAPTULO
21
Bibliotecas
Bibliotecas no Organizer
Bibliotec as
425
21.1 Galeria
A Galeria pode ser acessada atravs do boto
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: 3D ISA Symbols, Ar Condicionado, Arquitetura,
Setas, ASHRAE (Controles e Equipamentos), ASHRAE (Dutos), ASHRAE (Canos), Formatos
Bsicos, Sopradores e Ventiladores, Prdios, Processos Qumicos, Computadores,
Contineres, Controladores, Esteiras e Linhas de Produo, Dutos, Eltrica, Tubos Flexveis,
Medidores de Vazo, Smbolos Gerais, Aquecimento, HVAC, cones e Bitmaps, Miscelnea
Industrial, Smbolos Internacionais, Smbolos ISA, Mapas e Bandeiras, Manuseio de Materiais,
Canos, Misturadores, Motores, Natureza, Interfaces Homem Mquina, Painis, Acessrios
Industriais, Dispositivos de Potncia, Resfriamento de Processos, Aquecimento de Processos,
Bombas, Segurana, Escalas, Canos Segmentados, Sensores, Cortes em Tanques, Texturas,
Vlvulas, Veculos, gua e Abastecimento, Fios e Cabos, Botes 3D, Caldeiras, Teclas de
Computador, Acabamento, Comida, Laboratrio, Maquinrio, Minas, Papel e Polpa.
Para utilizar este recurso, siga estes procedimentos:
1. Clique no boto
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, basta clicar no objeto
desejado e arrast-lo 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 propriedades OverrideFillMode, OverrideFillColor
e OverrideLineColor, sem a necessidade de transformar o objeto em um objeto grfico do
E3.
426
Bibliotec as
Bibliotec as
427
Bibliotec as
21.2.1 XControls
O XControl define uma interface grfica com o usurio, que pode ser composta de quaisquer
objetos do E3, e ter o propsito de ser multiplicada facilmente por seu projeto. Pode-se criar
um XControl clicando com o boto direito do mouse sobre o arquivo LIB criado em seu
Domnio, escolhendo a opo Inserir - XControl.
XControls
Ao inserir um XControl, aberta a view 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
sero exportadas pelo objeto e podero 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 atravs do boto e excludos atravs da tecla DELETE do teclado ou atravs do
boto
Nome
Bibliotec as
DESCRIO
Determina o nome da varivel do XControl.
429
OPO
Tipo
DESCRIO
Determina o tipo de dado suportado pela
varivel. Note que outros objetos de Dados
(XObjects) podem ser declarados como
Tipos. Desta forma, pode-se criar um objeto
de dados que possui como propriedade
outro objeto de dados. Os objetos de dados
podem funcionar neste caso como uma
struct ou classe, como utilizado nas
linguagens C/C++. Quando for especificado
um tipo de objeto (por exemplo DemoTag,
IOTag, XObject, etc.), esta propriedade ter o
seguinte comportamento:
Caso o ElipseX esteja inativo: A
propriedade funciona como um String, que
especifica o caminho da instncia de um
objeto do tipo configurado
Caso o ElipseX esteja ativo: Na escrita, a
propriedade funciona como o caso
anterior, porm na leitura a propriedade
retorna o objeto especificado, caso ele
exista. Se o caminho no aponta para um
objeto existente no momento, a
propriedade retorna Nothing
Habilita ou desabilita a visibilidade da
varivel fora da biblioteca, isto , determina
se a varivel ser ou no pblica.
Determina se a propriedade retentiva ou
no. No caso de XControls, as propriedades
no podem ser retentivas.
Valor
Texto de ajuda
NOTA: interessante observar que podem ser declarados como Tipos, os objetos de Dados
(XObjects).
A edio do objeto grfico pode ser feita da mesma forma como feita 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 sobre a Tela ou XControl de destino, escolhendo a opo Inserir
, como mostrado a seguir. A partir de um XControl em desenvolvimento (dentro da biblioteca),
430
Bibliotec as
possvel inserir outro XControl dentro dele, clicando com o boto direito do mouse sobre o
XControl de destino, e escolhendo a opo Inserir.
21.2.2 XObjects
Alm dos Objetos grficos XControls, pode-se criar uma biblioteca de dados, denominada
XObject. Com ela, pode-se definir uma estrutura de dados, que ser executada no servidor.
Tal estrutura poder 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 e escolha a
opo Inserir XObject em e logo aps o nome da biblioteca desejada.
Bibliotec as
431
XObjects
Ao inserir um XObject, aberta a view deste objeto, onde podem ser inseridas variveis.
Estas variveis so as propriedades a serem exportadas pelo objeto, que podero ser
associadas a um tag ou outra propriedade qualquer de uma aplicao quando o objeto
estiver sendo usado numa aplicao.
As variveis a serem exportadas podem ser inseridas pressionando-se a tecla INSERT do
teclado ou atravs do boto e excludos atravs da tecla DELETE ou do boto
disponveis deste item so as seguintes:
. As opes
432
DESCRIO
Determina o nome da varivel do XObject.
Bibliotec as
OPO
Tipo
DESCRIO
Determina o tipo de dado suportado pela
varivel. Note que outros objetos de Dados
(XObjects) podem ser declarados como
Tipos. Desta forma, pode-se criar um objeto
de dados que possui como propriedade
outro objeto de dados. Os objetos de dados
podem funcionar neste caso como uma
struct ou classe, como utilizado nas
linguagens C/C++. Quando for especificado
um tipo de objeto (por exemplo DemoTag,
IOTag, XObject, etc.), esta propriedade ter
os seguinte comportamento:
Caso o ElipseX esteja inativo: A
propriedade funciona como um String, que
especifica o caminho da instncia de um
objeto do tipo configurado
Caso o ElipseX esteja ativo: Na escrita, a
propriedade funciona da mesma maneira
de quando o objeto est desativado.
Porm, na leitura a propriedade retorna o
objeto especificado, caso ele exista. Se o
caminho no aponta para um objeto
existente no momento, a propriedade
retorna Nothing
Habilita ou desabilita a visibilidade da
varivel fora da biblioteca, isto , determina
se a varivel ser ou no pblica.
Determina se a propriedade retentiva ou
no.
Valor
Texto de ajuda
Apenas propriedades de tipos simples (Variant, String, Date, Double, etc.) podem ser
retentivas (a view ir desmarcar automaticamente a coluna
se o tipo de uma propriedade
for alterado para um tipo de objeto), e apenas propriedades de XObjects podem ser
retentivas.
Bibliotec as
433
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 XObjects, nmero de propriedades
retentivas em cada XObject, e a quantidade destas propriedades que possuem o seu valor
alterado (se a propriedade nunca for alterada, o valor retentivo dela fica zerado).
Podem ser inseridos num 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 poder ser facilmente replicado quantas vezes forem necessrias em um
aplicativo.
IMPORTANTE: Veja que tanto os XControls quanto os XObjects s podero se relacionar com
o mundo externo atravs das propriedades (ou ainda atravs do mouse e teclado, no caso
dos XControls). Isso significa que no se pode acessar dados internos de um XObject ou
XControl seno de dentro do prprio objeto.
Pode-se inserir os XObjects em qualquer Servidor de Dados, clicando com o boto direito do
mouse sobre o Servidor de Dados no modo Domnio, escolhendo 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 sobre o Servidor de Dados do projeto, selecione a opo Inserir
e logo aps o nome do XObject desejado.
434
Bibliotec as
NOTA: Deve-se cuidar para no apagar uma propriedade de um XControl ou XObject que
possua uma associao. Essas propriedades, uma vez apagadas, no aparecem mais na lista
de propriedades do objeto, e por isso no podero ser editadas. Quando for executada a
operao Verificar Domnio, ser feita uma procura por essas propriedades e o usurio
consultado se deseja remover essa associao ou no.
Mensagem do sistema
Bibliotec as
435
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.
Logo, o uso de biblioteca recomendado para a maioria das aplicaes. Entretanto, existem
alguns critrios para indicar a necessidade da construo de objetos no Elipse.
Repetio no uso: se um mesmo equipamento ou processo ser 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. Isso comum no caso de
integradores de servios ou fabricantes de mquinas
Uso de controladores: um controlador de processo, cujo mapeamento de memria fixo,
pode ser implementado com todas as funcionalidades disponveis. A flexibilidade
disponvel para a construo e uso dos objetos no E3 permite que sejam utilizadas
posteriormente apenas as variveis de interesse, desprezando-se as demais
NOTA: Para exemplos de criao de ElipseX e maiores informaes sobre estes objetos,
consulte o Manual de Referncia de Scripts.
436
Bibliotec as
CAPTULO
22
Relatrios
Inserindo um Relatrio
2. Caso necessite, configure as propriedades do objeto.
Relatrios
437
Sees do relatrio
O relatrio define tipos de seo, que sero explicados nas sees a seguir.
NOTA: Um Report Header pode estender-se por mltiplas pginas. Para isto, basta inserir
um objeto Quebra de Pgina em seu contedo.
438
Relatrios
22.2.6 Detail
A seo Detail o corpo do relatrio, que imprime uma vez para cada registro da fonte de
dados.
Menu do Relatrio
Relatrios
439
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
OPO
Insert
DESCRIO
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
Reorder Groups
440
Relatrios
OPO
DESCRIO
Cut
Copy
Paste
Bring to Front
Send to Back
Align
Size
Relatrios
441
OPO
Horizontal Spacing
DESCRIO
Determina o espaamento horizontal do
objeto no relatrio. As opes disponveis
so as seguintes:
Make Equal: Espaamento igual entre os
objetos
Increase: Incrementa o espaamento do
objeto em um passo
Decrease: Decrementa o espaamento do
objeto em um passo
Vertical Spacing
Format Border
Relatrios
DESCRIO
Presets
Line Styles
Preview
Color
Shadow
Relatrios
443
22.3.1 Preview
Atravs desta opo, possvel visualizar uma prvia da impresso do relatrio. Assim
possvel verificar configuraes de margem, figuras, etc.
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.
444
Relatrios
CONE
DESCRIO
Menos zoom na pgina.
Mais zoom na pgina.
Porcentagem de zoom na pgina.
Pgina anterior e Prxima pgina.
Configuraes do relatrio
As opes disponveis deste item so as seguintes:
Opes de configurao do PageSetup
ITEM
DESCRIO
Top Margin
Bottom Margin
Left Margin
Relatrios
445
ITEM
DESCRIO
Right Margin
Gutter
Mirror Margins
DESCRIO
Paper Size
Width
Height
446
Relatrios
ITEM
DESCRIO
Orientation
Collate
Ordena a impresso.
Duplex
Duplica a impresso.
PaperBin
Configuraes da grade
As opes disponveis deste item so as seguintes:
Opes de configurao do Grid Setting (grade)
ITEM
DESCRIO
Show Grid
Relatrios
447
ITEM
DESCRIO
Grid Columns
Grid Rows
Ruler Units
DESCRIO
448
Relatrios
que est
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 ocorrer a ao.
Relatrios
449
22.3.6.1 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 na Tela, o objeto ser chamado de Line.
22.3.6.2 Retngulo
O objeto Retngulo permite o desenho de retngulos, utilizando toda a largura ou altura do
objeto. Criado a partir de dois vrtices.
Retngulo
Aps ser inserido na Tela, o objeto ser chamado de Shape.
Retngulo arredondado
Aps ser inserido na Tela, o objeto ser chamado de Shape.
450
Relatrios
22.3.6.4 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 na Tela, o objeto ser chamado de Shape.
22.3.6.5 Texto
O objeto Texto possibilita a criao de um texto. Ao definir a rea na Tela, podemos digitar
diretamente o texto desejado, que aceita tambm mltiplas linhas.
Texto
Aps ser inserido na Tela, o objeto ser chamado de Label.
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.
Figura
Relatrios
451
Campo de Dados
Aps ser inserido na Tela, o objeto ser chamado de Field.
452
Relatrios
Caixa de seleo
Aps ser inserido na Tela, o objeto ser chamado de CheckBox.
Cdigo de barras
Aps ser inserido na Tela, o objeto ser chamado de BarCode.
Relatrios
453
22.3.6.10 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.
Quebra de pgina
454
Relatrios
22.3.6.12 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 o texto, grficos e tabelas animadas
como em uma pgina em HTML.
Quadro
Aps ser inserido na Tela, o objeto ser chamado de Frame.
Essas duas reas podem ser acessadas clicando com o boto direito do mouse no relatrio e
acessando a opo Insert.
Relatrios
455
, disponvel
Para tanto, necessrio direcionar o servidor de Banco de Dados do projeto para o arquivo
MDB da pasta onde foi salvo o exemplo.
456
Relatrios
Relatrios
457
Sub Retangulo3_Click()
Set report = Application.LoadReport("[Relatrio3]")
Select Case _
Application.SelectMenu("PDF|Excel|HTML|RTF|Texto|_
TIFF|Texto(CSV)")
Case 1
Report.Export "PDF", "C:\correio\reports\report.pdf"
MsgBox "Exportado para PDF!"
Case 2
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
458
Relatrios
A nica exceo para a Data/Hora que ser um campo padro com a propriedade DataField
igual a "=CLng(E3TimeStamp*288)/288".
ReportFooter: Em branco (ou outro valor qualquer)
Se a consulta for entre 00:00 de um dia e outro, o resultado sero 288 linhas impressas com a
mdia dos campos a cada cinco minutos.
Relatrios
459
CAPTULO
23
Segurana
Atravs desta opo, possvel controlar o acesso a Telas, Alarmes, Domnios e Viewer em
uma lista de usurios e grupos. Conforme a opo configurada, o sistema permitir 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 estes procedimentos:
1. Abra o menu Arquivo - Usurios. O sistema mostrar uma caixa de dilogo para configurao
das permisses, dos usurios e dos grupos no sistema.
460
Seguran a
23.1 Usurios
Atravs da aba Usurios possvel configurar as informaes referentes aos usurios que
tero ou no acesso ao sistema. Para utilizar este recurso, clique no menu Arquivo - Usurios,
e selecione a aba Usurios.
Aba Usurios
As opes disponveis desta aba so as seguintes:
Opes disponveis na aba Usurios
OPO
DESCRIO
Nome
Boto Novo
Boto Editar
Boto Remover
Seguran a
461
OPO
DESCRIO
Grupos disponveis
Pertence a
Boto Adicionar
Boto Remover
462
Seguran a
DESCRIO
Nome
Autenticao do Windows
Seguran a
463
OPO
DESCRIO
Autenticao do E3
Senha
Confirme a senha
Nome completo
464
Seguran a
OPO
DESCRIO
Ao efetuar o login do usurio (pelo mtodo Login do Viewer ou pelo menu Arquivo - Login),
abre-se a seguinte caixa de dilogo:
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 ao domnio de rede, clique em Outro usurio.
Selecionando o modo de autenticao E3, basta preencher 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
poder, 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.
465
23.2 Grupos
A aba Grupos permite que sejam configuradas as informaes referentes aos grupos. Cada
grupo define caractersticas que sero 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, criando uma referncia circular.
Para utilizar este recurso, clique no menu Arquivo - Usurios e selecione a aba Grupos.
Aba Grupos
As opes disponveis desta aba so as seguintes:
466
Seguran a
DESCRIO
Nome
Boto Novo
Boto Editar
Boto Remover
Grupos disponveis
Pertence a
Boto Adicionar
Boto Remover
Adicionar grupo
As opes disponveis so as seguintes:
Seguran a
467
DESCRIO
Nome do grupo
468
Seguran a
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 ser 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 Telas,
Alarmes, Domnios e Viewer. Uma verificao de permisso consiste em uma informao que
o membro do grupo tem sobre um comando que atua sobre um objeto especfico.
Seguran a
DESCRIO
Esta opo lista os usurios ou grupos de
usurios configurados no sistema.
469
OPO
DESCRIO
Usurios
Grupos
Permisses
Para cada item de segurana existe uma srie de permisses que podem ser configuradas
para cada usurio ou grupo. As opes disponveis so as seguintes:
Opes disponveis para Telas
OPO
Abrir Tela
470
DESCRIO
Habilita a abertura de Telas.
Seguran a
DESCRIO
Reconhecer alarme
DESCRIO
Executar Domnio
Parar Domnio
Para o Domnio.
Editar Domnio
Configurar usurios/grupos
DESCRIO
Habilita o acesso de escrita ao servidor.
Cada item da lista de permisses pode estar configurado com um dos estados a seguir:
Seguran a
471
No caso das Telas, possvel que a configurao de permisso seja feita por Tela
especificamente. No caso de Alarmes, essa configurao pode ser feita 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, o sistema pedir o
login do usurio e aps, mostrar a Tela de abertura.
Com relao a permisses para o 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 ser exigida
identificao (usurio ser 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 ser exigida
identificao (no ser permitido o acesso como usurio annimo)
NOTA: A nomenclatura e descrio das opes de restrio pode ser acessada 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.
472
Seguran a
Seguran a
473
Proteo
Esta opo 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
O boto Adicionar proteo permite configurar uma senha de proteo para o sistema.
474
Seguran a
Adicionar proteo
O boto Alterar senha altera a senha de proteo do E3 Studio para o arquivo.
Seguran a
475
Adicionar proteo
O boto Alterar senha altera a senha de proteo de execuo para o arquivo.
476
Seguran a
CAPTULO
24
E3 Viewer e E3 WebViewer
477
478
importante lembrar que, no caso de no haver usurio logado no Viewer (usurio annimo),
ser aplicada a restrio de acesso, desde que pelo menos um ou mais usurios tenha 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 viceversa) 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,
independentemente da licena em uso, j que o usurio annimo sempre assume a restrio
mxima configurada.
479
-readonly ou /readonly: Permite ao usurio especificar que o Viewer deve tentar conectar
apenas no modo Somente Leitura. Quando isto for feito, o Viewer ir sempre utilizar uma
licena Viewer Only
Viewer [nome_do_servidor] readonly
480
-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
-help: Mostra uma caixa de dilogo com exemplos de uso das opes de linha de comando
do Viewer, como na figura a seguir
481
E3 Viewer
Se o E3 Server estiver na mesma mquina do E3 Viewer, selecione a opo Servidor Local. Caso
eles 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.
482
Para:
var Domain = "IP externo do servidor IIS";
Caso se queira permitir ao usurio informar uma tela inicial vlida, diferente da configurada
no Domnio, deve-se alterar a linha abaixo, colocando em Nome_da_tela um nome de Tela
vlido na aplicao:
<param name='Screen' value='Nome_da_tela'>
Caso se queira informar a necessidade de se executar o comando ping para o servidor antes
de tentar a conexo, deve-se alterar a linha abaixo. O valor pode ser True ou False.
<param name='Ping' value='TRUE'>
483
Caso seja preciso que o WebViewer procure por outros servidores na rede se no conseguir
conectar-se ao servidor especificado no parmetro Domain, deve-se alterar a linha a seguir.
Se o parmetro no for informado, o WebViewer tentar se conectar apenas ao servidor
especificado no parmetro Domain, que o comportamento padro do WebViewer (valor
True). A alterao do valor para False s ir funcionar para servidores e WebViewers que
estejam na mesma rede.
<param name= 'useservers' value='FALSE'>
484
485
NOTA: A verso do cliente tem que ser a mesma do servidor. Para isto, o instalador (e3w2kwebviewer.exe) que fica no servidor deve ser sempre o mais atual.
486
CAPTULO
25
Hot-Standby
IMPORTANTE: Para rodar uma aplicao redundante no E3, necessrio que todos os
servidores rodem 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 feitas 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
Hot-Standby
487
mquinas envolvidas.
Se o usurio de um E3 Studio ou Hot-Standby administrador da mquina remota onde o E3
Server est rodando, ele pode controlar o servio remotamente usando o aplicativo services.
msc, atravs da opo Action - Connect to another computer.
E3 Admin
4. Na aba Servidores, adicione os servidores principal e backup. Configure as opes Nome do
servidor e Identificao do servidor na rede. Por exemplo:
Nome do servidor: Servidor1
Identificao do servidor em rede: \\Computer1
488
Hot-Standby
Configurao do Servidor
5. Na aba Opes, marque o item Hot-Standby - Habilitar. No campo Servidor principal,
selecione o servidor principal do seu projeto e no campo Servidor de backup, selecione o
servidor de backup. O E3 ir buscar o servidor principal por ordem alfabtica.
6. Defina a opo Endereos para PING de integridade de rede. Esta opo especifica uma
terceira entidade de rede (as outras so os servidores principal e 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 altera seu estado para Standby (modo de espera).
7. Habilite a opo Ativar backup em caso de falha local. Esta opo serve para habilitar 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
ReportFailure. A troca de servidores s feita se o servidor backup estiver sem falhas.
Hot-Standby
489
Hot-Standby
Domnio pode ser iniciado tambm atravs do E3 Studio. Para tanto, basta abrir o Domnio e
clicar no boto .
Hot-Standby
491
492
Hot-Standby
CAPTULO
26
Configuraes Avanadas
493
CAPTULO
27
Este captulo destina-se ao esclarecimento das dvidas mais frequentes encontradas no E3.
Tambm so mostrados os erros que podem ocorrer e quais as solues para eles.
494
495
SOLUO
Mudar o nome do objeto.
496
SOLUO
Isto seria considerado um erro apenas se persistisse nos logs da aplicao.
Error = ORA-00001: restrio exclusiva (SYSTEM.E3INDEX) violada
POSSVEL CAUSA
Sempre que for feita uma tentativa de escrita de um registro onde o campo definido como
chave primria tiver o valor repetido, a escrita ser recusada e a mensagem anterior ser
exibida. interessante verificar que o nome da chave mostrado (neste caso, a chave
SYSTEM.E3INDEX) no formato Usurio.NomeChave. Dependendo do projeto, esse erro
esperado, mas na grande maioria das vezes, importante verificar se a chave a mais
adequada. Para ilustrar essa afirmao, veja estes dois casos:
Sistema de Telemedio de Energia: Visando gravar todos os dados de um dia, as rotinas
usadas para coletar dados admitem tolerncias a mais ou a menos no horrio a ser
coletado. Assim, alguns dos registros tero de ser escritos mais de uma vez. Neste caso, a
ocorrncia desse erro esperada
Manuteno de alarmes: Para esse caso, pode haver mais de um erro por segundo no
sistema. Se o campo E3TimeStamp for usado como chave primria, pode haver a perda de
algumas ocorrncias de alarme, o que prejudica a anlise posterior dos eventos. Neste
caso, re-estudar a chave-primria pode ser a soluo adequada
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.
497
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.
Como criar um temporizador no E3?
Com um Tag Demo do tipo Square. O Tag deve ter a propriedade Enabled igual a False e a
propriedade Period igual a duas vezes o tempo limite em milissegundos. A atribuio do valor
True propriedade Enabled iniciar a contagem do tempo. Para executar um script qualquer
no trmino do temporizador, basta criar um evento associado propriedade Value do Tag
Demo, que seja executado quando a propriedade alterar o seu valor. Neste script tambm se
deve desabilitar o Tag Demo, ou seja, atribuir propriedade Enabled o valor False, para que
ele no continue variando. Recomenda-se usar o mtodo Reset do Tag Demo antes de atribuir
propriedade Enabled o valor True.
498
27.8 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 a seo 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 ir prosseguir, ignorando apenas
este erro de nmero de colunas. O Alarme cujas colunas esto incorretas no ser
importado
Sim (Todos): A importao dos Alarmes ir prosseguir, ignorando todos os demais Alarmes
com erro no nmero de colunas que possam existir no arquivo CSV
No: A importao ser 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.
Como mostrar o campo E3TimeStamp com milissegundos no E3Browser e no E3Alarm?
Use o formato Outros, digitando "dd/MM/yyyy HH:mm:ss.000". Esta configurao para o
E3Browser feita na aba Fontes de Dados, na coluna Formato de cada campo. Para o E3Alarm,
tal configurao feita na aba Colunas, clicando no boto Propriedades de cada campo.
499
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.9 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.
500
SOLUO
Certifique-se de que existe apenas um Servidor de Alarmes no seu Domnio e que todos os
Alarmes esto configurados corretamente. Confira tambm se a rea configurada existe.
Como fazer um filtro por duas ou mais reas no E3Alarm?
Primeiro, agrupe as reas em uma rea principal. Depois, use nomes com os mesmos
caracteres iniciais. Exemplo: ALM1MEC, ALM1ELE, ALM2MEC, ALM2ELE, etc.
Como reconhecer Alarmes com duplo-clique?
Habilite a opo Reconhecer Alarme, localizada nas propriedades da coluna desejada no
objeto E3Alarm, na aba Colunas.
27.10 E3Browser
Como limitar o nmero de registros que vo aparecer no E3Browser?
Este item pode ser configurado na consulta do E3Browser. s habilitar 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.11 E3Chart
possvel no plotar o valor de um Tag quando a qualidade estiver ruim, em um E3Chart
histrico?
Sim. Via scripts, possvel configurar o E3Chart para isto.
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 ser sempre plotado, independente da qualidade do Tag.
27.12 Histrico
Como no gravar os registros de histricos por scan?
Configure a opo Gravar um novo script a cada, da aba Histrico, nas Propriedades do
Histrico, com valor 0. Se desejar faz-lo por script, a propriedade a ScanTime. Com isto, os
valores no sero registrados automaticamente, sendo necessrio fazer o registro via script
utilizando o mtodo WriteRecord.
501
27.13 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.
Como mudar a cor de um objeto ao passar o mouse sobre ele?
Criando uma Associao Digital entre as propriedades ForegroundColor e MouseOver de um
objeto. A propriedade MouseOver do tipo Booleana, e assume o valor True quando o mouse
estiver sobre objeto e False quando o mouse estiver fora da rea do objeto.
Como criar uma aplicao multilngue?
H duas formas de se fazer isto. Uma delas criar um Tag Interno no Viewer para cada String e
associar estes Tags s propriedades que devem ser traduzidas (ou utilizar os Tags por script
no caso de usar um Msgbox). Depois, crie uma tabela com todas as Strings da aplicao, onde
a primeira coluna o nome do Tag Interno criado no Viewer, e cada coluna seguinte contm a
String correspondente a um idioma. Esta tabela pode ser no Access, por exemplo. Ao abrir o
Viewer e definir o idioma, carregue os Tags Internos do Viewer com as Strings da tabela
correspondente ao idioma escolhido. Isto pode ser feito utilizando um objeto Consulta na
Tela. Segue um exemplo de script:
Sub Tela1_OnPreShow(Arg)
Set rs = Item("Query1").GetADORecordset()
rs.MoveFirst
For i = 1 To rs.RecordCount
Application.Item(rs.Fields("NomeTag").Value).Value = _
rs.Fields(Arg).Value
' Arg um parmetro passado para a Tela contendo o nome
' da coluna referente ao idioma selecionado
rs.MoveNext
Next
End Sub
Outra maneira criar uma Associao por Tabela em todas as propriedades que possurem
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 MsgBox, usar o
mesmo Tag como condio para escolher qual String ser utilizada.
27.14 Viewer
No consigo conectar um Viewer remoto ao Servidor. Por qu isso est acontecendo?
POSSVEL CAUSA
Existe um firewall bloqueando o acesso ao servidor.
502
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 esse comportamento pode ser
alterado conforme descrito no item Execuo do E3 Viewer - Execuo atravs do Menu Iniciar
.
Windows XP
1. V ao menu Iniciar - Painel de Controle.
2. Clique em Central de Segurana.
3. Clique em Firewall do Windows.
4. Selecione a aba Excees e clique no boto Adicionar Porta.
5. Digite um nome e o nmero da porta a ser liberada. Deixe a opo Protocolo selecionada
como TCP.
6. Clique em OK para salvar as alteraes.
Windows Vista
1. V ao menu Iniciar - Painel de Controle.
2. Clique em Firewall do Windows.
3. Selecione a aba Excees e clique no boto Adicionar Porta.
4. Digite um nome e o nmero da porta a ser liberada. Deixe a opo Protocolo selecionada
como TCP.
5. Clique em OK para salvar as alteraes.
Windows 7
1. V ao menu Iniciar - Painel de Controle.
2. Clique em Firewall do Windows.
3. Clique na opo Configuraes Avanadas.
4. Selecione a opo Regras de Sada.
503
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 num computador remoto onde o Viewer no foi
previamente instalado, a instalao ser iniciada automaticamente.
27.15 Bibliotecas
Ao abrir uma Tela, aparece uma mensagem dizendo que um objeto no pode ser carregado
corretamente
POSSVEL CAUSA
Foi apagado algum XControl da Biblioteca que estava sendo usada dentro desta Tela ou ento
foi removido do Domnio a Biblioteca que contm este XControl.
SOLUO
No primeiro caso, se foi apagado o XControl, no h mais como recuper-lo. Para corrigir o
erro, s apagar o objeto ElipseX que ficou dentro da Tela (pelo Organizer pode-se ver um
ponto de interrogao sobre o cone do objeto. Na Tela aparece um quadrado preto com um
X). No segundo caso, basta adicionar a Biblioteca ao Domnio.
504
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, voc deve ter o arquivo OCX que contm a Biblioteca.
Ao inserir um ActiveX na minha Tela ocorreu um erro 80040112. O qu isto significa?
POSSVEL CAUSA
Este erro indica que o ActiveX a ser inserido no est licenciado em sua mquina. Durante o
instanciamento, o controle procura no Registro do Windows por sua chave de licena (
HKEY_CLASSES_ROOT\Licenses) e, caso no encontre, retorna este erro. Existem chaves de
licena para os objetos ActiveX, tanto para ambientes de desenvolvimento quanto para
tempo de execuo.
SOLUO
Para resolver este problema, preciso adquirir a licena deste ActiveX e registr-lo em seu
computador.
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, ficando as duas com
o mesmo identificador. Por isto, ser necessrio remover uma delas do Domnio.
27.16 Relatrios
Como colocar a data e a hora atual em um Relatrio do E3?
Existem pelo menos duas alternativas para solucionar isso:
Coloque um Texto na seo PageHeader e, no evento OnFormat da seo PageHeader, escreva
o seguinte script:
Report.Sections("PageHeader").Controls("Label1")._
Caption = Now
505
pode ser feito clicando com o boto direito do mouse sobre o 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 fazer
isto via script dentro do grfico. As penas configuradas no E3Chart em Tela so do tipo Real.
Como fazer um filtro por datas no Relatrio?
Crie uma Consulta SQL no Relatrio filtrando por data inicial e final. Na Tela onde se deseja
gerar este Relatrio, deve-se executar a Consulta SQL configurada passando os valores de
data inicial e final. O script do boto na Tela onde gerado o Relatrio, por exemplo, pode ser
implementado assim:
DataInicial = CDate(Screen.Item("TextoDataInicial").Value)
DataFinal = CDate(Screen.Item("TextoDataFinal").Value)
Set Report1 = Application.LoadReport("Report1")
Set Consulta = Report1.Item("Query1")
Consulta.SetVariableValue "DataInicial", (DataInicial)
Consulta.SetVariableValue "DataFinal", (DataFinal)
Report1.PrintPreview()
Depois, associe dois Tags Internos aos Setpoints da Tela onde so especificadas as datas.
Associe estes Tags aos Setpoints no Relatrio.
506
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.
507
Onde a sintaxe das variveis o sinal de maior que, o sinal de percentual entre o nome da
varivel e o sinal de menor que. var1 e var2 so as variveis que a Stored Procedure est
esperando (por exemplo, data inicial e final). Caso a Stored Procedure no esteja esperando
nenhuma varivel, basta criar o comando SQL sem as variveis. Para executar esta Consulta,
basta utilizar o mtodo Execute.
509
Conectar um Domnio a um
Domnio em Hot-Standby
Atravs dos Domnios Remotos essa arquitetura possvel. Tem-se um Domnio de
Comunicao, em Hot-Standby, comunicando com os dispositivos. Esses dados seriam lidos
por um outro Domnio, tambm em Hot-Standby, que seriam o servidor para os computadores
510
clientes (Viewers).
511
Matriz
Filial MG
E-mail: elipse@elipse.com.br
E-mail: elipse-mg@elipse.com.br
Filial SP
Filial PR
05422-001 So Paulo - SP
80240-000 Curitiba - PR
E-mail: elipse-sp@elipse.com.br
E-mail: elipse-pr@elipse.com.br
Filial RJ
USA
E-mail: elipse-rj@elipse.com.br
E-mail: info@elipse-software.com
Alemanha
Taiwan
E-mail: elipse@elipse.de
w w w .elipse.c om.br
elipse@elipse.c om.br