Elipsepowermanual PTB

Manual do Usuário do Elipse
Power
Copyright © 1999 - 2021 Elipse Software Ltda. Todos os direitos reservados.

Versão 6.0.215 (10/12/2021)
Sumário
1 Introdução ................................................................................................................................................... 1
1.1 Descrição Geral ..................................................................................................................................... 1
1.2 Arquitetura ............................................................................................................................................ 1
1.3 Diagrama de Blocos ............................................................................................................................. 3
1.4 Estrutura de Domínio ........................................................................................................................... 3
1.5 Modelagem Elétrica .............................................................................................................................. 4
1.6 Estruturação de Dados ......................................................................................................................... 4
1.7 Ferramentas Elétricas ........................................................................................................................... 4
1.8 Limitações do Modo Demonstração .................................................................................................. 6
2 Elipse Power Studio .................................................................................................................................... 7
2.1 Iniciando um Projeto ............................................................................................................................ 7
2.2 Área de Trabalho .................................................................................................................................. 7
2.3 Configuração ......................................................................................................................................... 8
2.4 Barra de Ferramentas ........................................................................................................................ 15
2.5 Atalhos de Teclado ............................................................................................................................. 32
2.6 Organizer ............................................................................................................................................. 36
2.7 Importação e Exportação .................................................................................................................. 40
2.8 Lista de Propriedades ........................................................................................................................ 62
2.9 Galeria .................................................................................................................................................. 64
2.10 AppBrowser ...................................................................................................................................... 65
2.11 Conectar A ........................................................................................................................................ 68
3 Domínios ................................................................................................................................................... 70
3.1 E3 Server .............................................................................................................................................. 70
3.2 E3Run ................................................................................................................................................... 70
3.3 E3 Admin ............................................................................................................................................. 71
3.4 IOServer ............................................................................................................................................... 72
3.5 Elipse Power Studio ............................................................................................................................ 72
3.6 Elipse Power Viewer ........................................................................................................................... 72
3.7 Componentes ...................................................................................................................................... 72
3.8 Criando um Domínio .......................................................................................................................... 73
3.9 Configurações ..................................................................................................................................... 79
3.10 Outras Opções da Área de Notificação ....................................................................................... 104
3.11 Domínios Remotos ........................................................................................................................ 111
3.12 Gerando Logs no Elipse Power ..................................................................................................... 116
4 Objeto Configuração do Power ............................................................................................................ 118
4.1 Definição de Padrões ....................................................................................................................... 118
4.2 Modelador Elétrico ........................................................................................................................... 134
4.3 Ferramentas ...................................................................................................................................... 154
5 Sincronização de Objetos de Dados ..................................................................................................... 158
5.1 Sincronização de Objetos de Dados Existentes ............................................................................ 161
I
5.2 Configuração SCADA ....................................................................................................................... 162
6 Drivers ..................................................................................................................................................... 175
6.1 Driver de Comunicação ................................................................................................................... 175
6.2 Servidor OPC ..................................................................................................................................... 187
6.3 Driver de Comunicação OPC ........................................................................................................... 188
6.4 Driver de Comunicação OPC UA ..................................................................................................... 199
6.5 Qualidade .......................................................................................................................................... 210
7 Quadros ................................................................................................................................................... 216
8 Viewer ..................................................................................................................................................... 220
8.1 Configuração .................................................................................................................................... 220
8.2 Variáveis no Viewer ......................................................................................................................... 226
8.3 Objeto _top ....................................................................................................................................... 226
8.4 Pasta do Viewer ................................................................................................................................ 226
9 PowerExplorer ........................................................................................................................................ 228
10 Telas e Objetos de Tela ....................................................................................................................... 231
10.1 Tela .................................................................................................................................................. 231
10.2 Barra de Ferramentas .................................................................................................................... 233
10.3 Objetos de Tela .............................................................................................................................. 236
10.4 Configurações Gerais .................................................................................................................... 244
10.5 Formatação de Cores ..................................................................................................................... 252
10.6 Formatação de Valores ................................................................................................................. 254
11 Associações .......................................................................................................................................... 258
11.1 Simples ............................................................................................................................................ 259
11.2 Bidirecional ..................................................................................................................................... 259
11.3 Digital .............................................................................................................................................. 260
11.4 Analógica ........................................................................................................................................ 261
11.5 Por Tabela ....................................................................................................................................... 262
11.6 Reversa ............................................................................................................................................ 263
11.7 Múltipla ........................................................................................................................................... 263
11.8 Edição de Associações ................................................................................................................... 264
11.9 Propriedades do Tipo Texto com Associações ........................................................................... 268
12 Bibliotecas ............................................................................................................................................ 269
12.1 Galeria ............................................................................................................................................. 269
12.2 Biblioteca do Usuário (ElipseX) .................................................................................................... 270
12.3 Quando Criar um ElipseX .............................................................................................................. 280
13 Importação para Telas ........................................................................................................................ 281
13.1 Personalização de Bibliotecas ...................................................................................................... 289
14 ActiveX .................................................................................................................................................. 293
14.1 Objetos Microsoft Forms .............................................................................................................. 295
14.2 Elipse KeyPad ................................................................................................................................. 296
15 Servidor de Dados ............................................................................................................................... 298
II
15.1 Impressora de Linha ...................................................................................................................... 298
15.2 Pasta de Dados ............................................................................................................................... 300
15.3 Tag Contador .................................................................................................................................. 301
15.4 Tag Demo ....................................................................................................................................... 302
15.5 Tag Interno ..................................................................................................................................... 303
15.6 Tag Timer ........................................................................................................................................ 304
16 Banco de Dados ................................................................................................................................... 306
16.1 Access .............................................................................................................................................. 306
16.2 Oracle .............................................................................................................................................. 308
16.3 SQL Server ....................................................................................................................................... 311
16.4 Objetos do Elipse Power e Permissões ........................................................................................ 314
17 Consultas .............................................................................................................................................. 315
17.1 Criando uma Consulta ................................................................................................................... 316
17.2 Uso dos Filtros da Consulta através de Scripts .......................................................................... 323
17.3 Uso de Recordsets de uma Consulta através de Scripts ........................................................... 323
18 Alarmes ................................................................................................................................................. 324
18.1 Configuração de Alarmes ............................................................................................................. 324
18.2 Filtro de Alarmes ........................................................................................................................... 326
18.3 Fontes de Alarme ........................................................................................................................... 332
18.4 Servidor de Alarmes ...................................................................................................................... 340
19 E3Alarm ................................................................................................................................................ 349
19.1 Configurações ................................................................................................................................ 349
19.2 Características Específicas de Tempo de Execução .................................................................... 358
20 Storage .................................................................................................................................................. 364
20.1 Configurações ................................................................................................................................ 366
20.2 Configuração da Tabela ................................................................................................................ 367
20.3 Objeto Fields ................................................................................................................................... 377
20.4 Campo do Storage ......................................................................................................................... 377
21 Histórico ............................................................................................................................................... 379
21.1 Configurações ................................................................................................................................ 380
21.2 Objeto Fields ................................................................................................................................... 385
21.3 Objeto Indexes ............................................................................................................................... 387
21.4 Objeto PrimaryKey ........................................................................................................................ 388
22 E3Browser ............................................................................................................................................ 391
22.1 Objeto Consulta no E3Browser .................................................................................................... 392
22.2 Outras Configurações .................................................................................................................... 393
23 E3Chart ................................................................................................................................................. 397
23.1 Configurações ................................................................................................................................ 397
23.2 Exemplos de Utilização ................................................................................................................. 423
23.3 Características Específicas de Tempo de Execução .................................................................... 425
24 TrendAnalysis ...................................................................................................................................... 430
III
24.1 Aba Exibições ................................................................................................................................. 431
24.2 Aba Marcadores ............................................................................................................................. 436
24.3 Aba Conexões ................................................................................................................................. 437
24.4 Área de Exibições ........................................................................................................................... 437
24.5 Atalhos de Teclado ........................................................................................................................ 441
25 E3Playback ............................................................................................................................................ 443
25.1 Objeto E3Playback ......................................................................................................................... 443
25.2 Interface de Usuário ...................................................................................................................... 443
25.3 Banco de Dados de Playback ........................................................................................................ 452
25.4 Configuração dos Objetos de Banco de Dados do Elipse Power .............................................. 454
26 Fórmulas ............................................................................................................................................... 457
26.1 Configurações ................................................................................................................................ 457
26.2 Templates ....................................................................................................................................... 459
26.3 Unidades ......................................................................................................................................... 461
26.4 Conjunto de Valores ...................................................................................................................... 461
26.5 Criação de uma Fórmula ............................................................................................................... 462
27 Relatórios ............................................................................................................................................. 467
27.1 Objeto Consulta ............................................................................................................................. 467
27.2 Componentes ................................................................................................................................. 467
27.3 Configurações ................................................................................................................................ 469
27.4 Criando um Relatório no Elipse Power ........................................................................................ 480
27.5 Exemplos de Utilização ................................................................................................................. 481
28 Segurança ............................................................................................................................................. 484
28.1 Usuários .......................................................................................................................................... 484
28.2 Grupos ............................................................................................................................................. 489
28.3 Permissões ...................................................................................................................................... 494
28.4 Proteção de Arquivos .................................................................................................................... 497
29 Elipse Power Viewer e WebViewer .................................................................................................... 501
29.1 Viewer Only (Modo Somente Leitura) ........................................................................................ 501
29.2 Execução do Elipse Power Viewer ................................................................................................ 502
29.3 Logs do Elipse Power Viewer ........................................................................................................ 505
29.4 Execução do WebViewer ............................................................................................................... 505
30 Hot-Standby ......................................................................................................................................... 509
30.1 Configurando ................................................................................................................................. 509
30.2 Executando um Domínio Redundante ........................................................................................ 510
30.3 Parando um Domínio Redundante .............................................................................................. 510
30.4 Parando um dos Servidores do Domínio .................................................................................... 511
30.5 Tempo de Troca entre Servidores ................................................................................................ 511
30.6 Reconexão de Elipse Power Viewers ........................................................................................... 511
30.7 Utilizando Bancos de Dados com Hot-Standby ......................................................................... 511
31 Configurações Avançadas .................................................................................................................. 512
IV
32 Biblioteca E3DataAccess ..................................................................................................................... 513
32.1 Eventos ............................................................................................................................................ 513
32.2 Métodos .......................................................................................................................................... 513
32.3 Propriedades .................................................................................................................................. 515
33 Dúvidas mais Frequentes ................................................................................................................... 517
33.1 Alarmes ........................................................................................................................................... 517
33.2 Associações .................................................................................................................................... 518
33.3 Bibliotecas ...................................................................................................................................... 519
33.4 Domínios e Projetos ...................................................................................................................... 519
33.5 Domínios Remotos ........................................................................................................................ 520
33.6 Drivers de Comunicação ............................................................................................................... 523
33.7 E3Alarm .......................................................................................................................................... 524
33.8 E3Browser ....................................................................................................................................... 524
33.9 E3Chart ............................................................................................................................................ 524
33.10 Histórico ....................................................................................................................................... 525
33.11 Impressora de Linha .................................................................................................................... 525
33.12 Objetos de Tela ............................................................................................................................ 525
33.13 Ordem da Tabulação ................................................................................................................... 525
33.14 Relatórios ..................................................................................................................................... 525
33.15 Servidor de Banco de Dados Oracle .......................................................................................... 526
33.16 Servidor de Banco de Dados SQL Server ................................................................................... 527
33.17 Servidor de Dados ....................................................................................................................... 528
33.18 Sobreposição de Animações nos Objetos ................................................................................. 528
33.19 Stored Procedure ......................................................................................................................... 529
33.20 Elipse Power Viewer .................................................................................................................... 529
V
CAPÍTULO
Introdução
1
O Elipse Power é uma ferramenta de desenvolvimento de aplicações de supervisão, controle e análise de Sistemas de
Energia Elétrica. Seu objetivo é reunir em apenas uma ferramenta diversos sistemas de apoio à operação do sistema
elétrico com toda a estrutura SCADA, facilitando desta forma a interação entre os diversos setores operacionais da
empresa.
O desenvolvimento é baseado no framework do Elipse Power, herdando desta forma todas as facilidades que este já
dispõe, como toda a base de Drivers de Comunicação, Telas, objetos de dados, etc.
1.1 Descrição Geral

O Elipse Power pode ser executado nas plataformas Windows 7 SP1, Windows 8, Windows 8.1, Windows 10,
Windows 10 Enterprise LTSB ou LTSC, Windows Server 2008 R2 SP1, Windows Server 2012, Windows Server 2012
R2, Windows Server 2016 ou Windows Server 2019, utilizando alguns recursos disponíveis nestes sistemas
operacionais. A interface gráfica com o usuário pode também ser executada através da Internet ou intranet via Internet
Explorer.
As funções básicas do software estão divididas em módulos independentes, capazes de processar atividades
específicas. O gerenciamento do tráfego de informações entre os módulos é coordenado por um módulo principal
(E3 Admin), utilizando a tecnologia de objetos distribuídos, permitindo que os componentes possam ser executados
tanto na mesma máquina quanto em outros computadores.
Em linhas gerais, o Elipse Power é composto de um núcleo (kernel) responsável por unir e coordenar o trabalho de
vários outros módulos, que também são servidores de informações. A partir daí são geradas as interfaces gráficas
com o usuário, disponíveis através dos clientes, tanto locais como pela Internet.
O Elipse Power possui quatro programas principais, descritos a seguir.
1.1.1 E3 Server
É o Servidor de Aplicações, onde os principais processos são executados, incluindo a comunicação em tempo real
com os equipamentos de controle. O servidor também é responsável por enviar dados e Telas aos clientes
conectados em qualquer parte da rede (intranet e Internet). O servidor pode executar vários projetos ao mesmo
tempo e conversar com outros E3 Servers para realizar um fail-over (standby) ou distribuir cargas de processamento
entre as máquinas.
1.1.2 Elipse Power Studio

Ferramenta única de configuração, agindo como plataforma universal de desenvolvimento, que possui um ambiente
moderno e amigável, incluindo um completo editor gráfico e de scripts (VBScript). Permite que um projeto seja
editado por várias pessoas ao mesmo tempo ou que vários Elipse Power Studios estejam conectados ao mesmo
servidor remoto, com múltiplas configurações.
1.1.3 Elipse Power Viewer

Permite operar as aplicações residentes no servidor a partir de qualquer computador com o programa executável
Elipse Power Viewer ou com um navegador de Internet. Em ambos os casos, não é necessário instalar a aplicação na
máquina cliente, pois é realizado o download e o registro de todos os componentes (Telas, bibliotecas e controles
ActiveX).
1.1.4 E3 Admin
É o módulo responsável pela interface do E3 Server e de outros módulos do Elipse Power com o usuário. Através
dele o usuário pode enviar comandos ao E3 Server, utilizando o ícone na Área de Notificações do Windows, e
controlar o Domínio pela linha de comando.
1.2 Arquitetura
Para supervisionar um determinado processo com um sistema SCADA, geralmente é construída uma aplicação que
contém a definição das variáveis envolvidas, com nomes e endereçamentos, Telas, definições de alarmes e outros, a
qual se chama Banco de Dados da Aplicação.
1 Introdução
Quando este processo exige o uso de dois ou mais computadores, é preciso que cada aplicação em cada
computador troque dados com as outras. A maioria dos sistemas SCADA tradicionais baseiam-se em uma arquitetura
comum para realizar esta tarefa:
· Cada servidor SCADA deve ter uma cópia (parcial ou não) da aplicação configurada na base de dados local
· Cada servidor SCADA possui e executa somente uma base de dados ao mesmo tempo
Isto leva a alguns problemas de gerenciamento, como aplicar mudanças a todos os servidores, controlar versões da
aplicação ou então trabalhar com diferentes fabricantes de software e hardware.
O Elipse Power resolve este problema usando o conceito de Domínio, que inclui, em um único ambiente, a definição
dos computadores executando tarefas em tempo real (servidores) e as bases de dados de projeto que devem ser
executadas nestes servidores, com a possibilidade de execução de vários projetos em cada servidor. Também é
possível inserir, apagar ou modificar projetos durante a execução, sem afetar as outras partes do Domínio em
execução.
Cada projeto pode conter qualquer tipo de objeto, como Telas, Drivers de Comunicação, Alarmes, Históricos,
Relatórios, Fórmulas e Bancos de Dados, dentre outros. Quando dois ou mais projetos estão dentro de um mesmo
Domínio, estes podem acessar as propriedades e objetos entre si como se estivessem residentes em uma única base
de dados. Isto é possível através do uso de Associações (conexões) que um objeto pode criar com qualquer outro. Se
ambos os objetos existem e estão executando, a conexão está ativa e qualquer mudança de valor é enviada
assincronamente entre as partes, dependendo do tipo da conexão. Se um dos objetos é destruído ou parado a
conexão é quebrada, então a aplicação é notificada e pode indicar seu estado em uma forma definida pelo usuário.
A estrutura do Domínio é restrita aos servidores e afins, como as máquinas servidoras, projetos, usuários e senhas. A
interface do cliente para operação e visualização, chamada Elipse Power Viewer, pode se conectar diretamente a
qualquer servidor Elipse Power (com licenças suficientes de Elipse Power Viewer). O Elipse Power Viewer possui três
destaques especiais:
· Os projetos da aplicação residem somente no servidor
· O Internet Explorer pode ser usado como interface de operação, sem nenhuma mudança
· A interface do cliente é capaz de alternar de um servidor desligado ou com falha para o próximo servidor
disponível, sem interromper o monitoramento do processo
Como alternativa ao uso do Elipse Power Viewer na máquina cliente, é possível utilizar a tecnologia Terminal Service.
Este serviço surgiu no Windows NT 4.0 e sua função é permitir o acesso remoto entre computadores, através de um
protocolo chamado RDP (Remote Desktop Protocol). Este protocolo permite a interação entre uma estação cliente e
uma máquina servidora, que é acessada remotamente. O Elipse Power Viewer é executado em uma nova sessão de
usuário criada na máquina servidora, que por sua vez transfere para a máquina cliente os dados de vídeo e recebe de
volta os eventos de mouse e teclado.
Arquitetura do Elipse Power

É possível observar que, em todos os casos, o Elipse Power Viewer continua sendo a interface de operação e
visualização. A diferença está no local de execução, que pode ser na máquina cliente (operação normal do Elipse
Introdução 2
Power Viewer) ou na máquina servidora, com o operador fisicamente junto à máquina ou através dos Terminal
Services. Com o Elipse Power Viewer sendo executado diretamente na estação cliente, existe um tráfego inicial maior
para o download de Telas e objetos. Este tráfego diminui substancialmente à medida que somente as mudanças nos
dados são reportadas do servidor para o Elipse Power Viewer, o que traz vantagens em termos de desempenho e
qualidade de apresentação gráfica.
O Terminal Service, por outro lado, possui maior alcance e exige menor capacidade de processamento da máquina
cliente quando existem poucos efeitos gráficos e visuais, além da possibilidade de operar o Elipse Power em outras
plataformas de software que não são suportadas pelo Elipse Power Viewer, como o Windows CE e o Linux ou Unix.
Entretanto, o RDP possui a limitação de exibir somente 256 cores, o que aumenta consideravelmente o tráfego
quando existem muitas animações ou efeitos piscantes nas Telas. Para verificar qual a melhor maneira de implementar
múltiplos acessos a um E3 Server, é importante estudar caso a caso, para poder definir a melhor alternativa para a
aplicação. Para utilizar o RDP com múltiplos usuários, é necessário uma licença de Windows 2003 Server SP2, além do
mesmo número de Elipse Power Viewers disponíveis no Servidor.
1.3 Diagrama de Blocos

A arquitetura interna do Elipse Power é totalmente escalável, com cada tarefa principal sendo executada por um
serviço separado. O diagrama a seguir mostra uma visão geral dos principais blocos.
Diagrama dos blocos que compõem o Elipse Power

Detalhadamente, o E3 Server é responsável por criar um processo de execução (E3Run) que vai efetivamente executar
a aplicação. Dentro do E3Run encontram-se outros servidores, que expõem serviços utilizados por outros módulos.
1.4 Estrutura de Domínio

Cada grupo de servidores é composto por um E3 Server operando isoladamente ou dois E3 Servers em configuração
de Hot-Standby. Cada Elipse Power Viewer, de fato, se conecta a um Domínio ao invés de somente a um servidor.
Depois da conexão, servidor e cliente trocam informações e verificam a existência de objetos do sistema registrados e
atualizados na máquina cliente. Caso negativo, o servidor carrega as definições dos objetos, como bibliotecas do
usuário, conforme a necessidade para abrir cada uma das Telas.
Do ponto de vista do cliente, o download começa na primeira Tela (interface gráfica), incluindo quaisquer objetos
internos que são salvos em um diretório de cache. Este processo pode levar alguns segundos, dependendo da
aplicação, mas traz mais benefícios na próxima vez que se abre a mesma Tela, pois o Elipse Power Viewer realiza um
cache em disco e em memória. Se o Elipse Power Viewer não é fechado, a partir da segunda vez que uma Tela é
aberta (e não for reconfigurada) ela já está criada em memória, reduzindo portanto o tempo de paginação. Se a Tela
é modificada, o Elipse Power Viewer deve executar um novo download, reiniciando o processo.
Depois de abrir uma Tela, o servidor e o cliente trocam somente dados em tempo real e consultas ao banco de
dados em um sistema de mensagens TCP/IP, com um alto desempenho se comparado ao Terminal Services,
dependendo da aplicação. Isto é possível porque enquanto o Elipse Power Viewer recebe e envia apenas valores e
dados em tempo real, um cliente Terminal Services envia mensagens de teclado e mouse e recebe imagens, o que
gera um tráfego muito maior de informações. Um Elipse Power Viewer conectado a um Domínio isolado pode obter
informações residentes somente dentro do servidor ativo, de acordo com os direitos de acesso do usuário.
3 Introdução
1.5 Modelagem Elétrica
Todos os sistemas de apoio são executados a partir de um modelo elétrico que descreve exatamente a configuração
utilizada em campo. Este modelo é cadastrado através de uma ferramenta de Modelagem Elétrica. Trata-se de uma
ferramenta gráfica capaz de criar e manter todo o sistema elétrico, configurando todas as informações elétricas e
conectividade do sistema.
1.6 Estruturação de Dados

Todos os equipamentos de campo são modelados em objetos nativos, representando de forma fiel a estrutura do
sistema. Esta modelagem facilita a estruturação do sistema, visando sua padronização, e mantendo assim bem
definida a estrutura hierárquica, além de manter em apenas um local todas as informações referentes a cada
equipamento.
1.7 Ferramentas Elétricas

Baseado na modelagem elétrica, o Elipse Power executa módulos matemáticos de apoio à operação do sistema.
Estes módulos interagem, em tempo real, diretamente com a aplicação SCADA, buscando informações do cenário
atual e retornando o resultado de cada um destes módulos de análise elétrica. Os módulos são os seguintes:
· Fluxo de Potência: Informa a capacidade de transferência de carga, os limites operacionais, além de estimar
valores de P, Q, I e V (potência ativa, potência reativa, corrente e tensão, respectivamente) em pontos onde não
existe medição
· Processador Topológico: Informa o estado dos trechos, se estão energizados ou desenergizados, qual a carga
desatendida, ilhas elétricas, etc.
· Descarte de Cargas: Calcula continuamente o equilíbrio entre a oferta e o consumo de energia, além de
determinar a sequência de desligamento de cargas, caso o fornecedor (produtor ou linha de transmissão) venha
a falhar. O cálculo considera a prioridade das cargas, capacidade de instalações e o estado topológico atual
· Estimador de Estados: Corrige medidas, em tempo real, que podem estar corrompidas por erros de sinal
invertido ou de prefixo multiplicador. Também permite estimar grandezas para as quais não há medição direta
· Modelagem de Cargas para Distribuição: Calcula a potência ativa e reativa para cada Transformador da
Distribuição, considerando a demanda mensal de energia dos consumidores e a tipologia da carga
· Autorrecuperação: Executa funções automáticas de isolamento e restauração de carga através de algoritmos de
simulação e velocidade computacional, de forma a avaliar a capacidade dos circuitos disponíveis e reduzir
significativamente o impacto de faltas nos índices de qualidade das empresas
· Leitura Externa: Permite que Chaves, Disjuntores, Chaves Fusíveis ou Religadores que não tenham sua Medida
SwitchPosition instanciada no objeto de dados recebam o valor informado por este módulo. Também permite
customizar a forma como este módulo fornece o valor para a Medida
Para acessar as configurações de armazenamento do módulo Autorrecuperação, clique com o botão direito do
mouse no módulo, em Objetos de Servidor - Power - Configuração - ConfiguracaoPower, selecione o item
Propriedades e clique na aba Autorrecuperação. A janela da figura a seguir é mostrada.
Introdução 4
Aba Autorrecuperação
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Autorrecuperação
OPÇÃO DESCRIÇÃO
Armazenar eventos em banco de dados Habilita ou desabilita o armazenamento de eventos em
um banco de dados. Esta opção corresponde à
propriedade Logging
Servidor de Banco de Dados Indica o objeto Banco de Dados utilizado para criação de
tabelas. Esta opção corresponde à propriedade
DBServer
Prefixo do nome das tabelas Define um prefixo para os nomes das tabelas utilizadas
no banco de dados. Esta opção corresponde à
propriedade TableName
Descartar dados da tabela principal Habilita ou desabilita o descarte de dados após um certo
tempo. Esta opção corresponde à propriedade
EnableDiscard
Descartar dados mais antigos que Determina o intervalo de tempo, em minutos, horas, dias
ou meses, durante o qual os dados são mantidos na
tabela principal. Se um dado da tabela é mais antigo que
o intervalo de tempo desta opção, este é descartado.
Este campo equivale à propriedade DiscardInterval e o
campo de seleção da unidade de tempo do intervalo
equivale à propriedade DiscardTimeUnit
Realizar o descarte a cada Determina o intervalo, em minutos, horas, dias ou meses,

de descarte de dados antigos da tabela. Este campo
equivale à propriedade VerificationUnit
Mover para a tabela de backup os dados descartados Habilita ou desabilita o armazenamento dos dados
descartados na tabela secundária ou de backup. Este
campo equivale à propriedade EnableBackupTable
5 Introdução
OPÇÃO DESCRIÇÃO
Descartar do backup dados mais antigos que Determina o intervalo máximo de tempo, em minutos,
horas, dias ou meses, dos dados na tabela de backup até
serem descartados, independente do tempo que os
dados permanecem na tabela principal. Por exemplo,
para manter os dados por 24 meses na tabela principal e
mais seis meses na tabela de backup, o valor desta
opção deve ser de 30 meses. Este intervalo deve ser
sempre maior que o configurado no item Descartar
dados mais antigos que da tabela principal. Este campo
equivale à propriedade BackupDiscardInterval e o
campo de seleção da unidade de tempo do intervalo
equivale à propriedade BackupDiscardTimeUnit
Gerar tabelas Gera a estrutura das tabelas no Banco de Dados
1.8 Limitações do Modo Demonstração

Sem a utilização de uma chave de produto, o Elipse Power pode ser executado em modo Demonstração (ou Demo),
o que é útil para avaliação do software. Neste caso, as seguintes limitações se aplicam:
· Permite salvar projetos com até 20 Tags de Comunicação
· Não permite trabalhar com servidores em modo Hot-Standby
· Não permite trabalhar com Domínios Remotos
· Só permite a comunicação com um Driver de Comunicação de nível 0 (zero), sem limite de Tags. Drivers com nível
maior do que 0 (zero) não são permitidos
· Não permite acesso às configurações do Domínio, disponíveis no menu contextual Domínio - Opções do ícone
do E3 Admin na Área de Notificações do Windows
· Somente a primeira imagem de cada categoria da Galeria de Símbolos está disponível
· Só permite a abertura de um Elipse Power Viewer ou WebViewer
· O tempo máximo de execução de um Domínio é de duas horas
· Só permite a gravação de no máximo 20 Tags de Comunicação em um objeto Storage
· Permite acesso como OPC Server
· Permite executar o playback das últimas seis horas de dados, em relação à hora atual do servidor, com um
número ilimitado de Tags e com todos os recursos de playback habilitados
· Não permite utilizar a ferramenta de Exportação de Usuários do E3 Admin
· Não permite utilizar a ferramenta de Importação e Exportação do Elipse Power Studio
· Permite utilizar até 100 Medidas
· Permite modelos elétricos com até 20 entradas do módulo Fluxo de Potência
· Permite modelos elétricos com até cinco Disjuntores participantes no módulo Descarte de Cargas
· Não permite utilizar o módulo Estimador de Estados
· Não permite utilizar o módulo Modelagem de Cargas para Distribuição
· Não permite utilizar o módulo Autorrecuperação
· Permite utilizar até duas Subestações
· Permite utilizar até quatro Alimentadores
· Permite utilizar até dois Inversores
· Permite utilizar até quatro Arranjos Fotovoltaicos
· Permite salvar modelos elétricos, ou seja, arquivos em formato EDB, com até 20 equipamentos
Introdução 6
CAPÍTULO
Elipse Power Studio
2
O Elipse Power Studio é o ambiente de desenvolvimento do Elipse Power. Neste ambiente é possível criar e manter
Domínios, projetos e bibliotecas.
Para iniciar uma aplicação no Elipse Power Studio, selecione-o no menu Iniciar do Windows ou clique duas vezes no
ícone criado na Área de Trabalho do Windows durante a instalação.
O dispositivo de proteção deve estar conectado na porta de comunicação adequada, no caso de uma edição local, ou
a máquina deve estar na mesma rede local que outra com o E3 Server já previamente instalado, e com um dispositivo
de proteção presente.
2.1 Iniciando um Projeto

Ao iniciar o Elipse Power Studio, abre-se uma caixa de diálogo com algumas opções do projeto, conforme a figura a
seguir.
Janela Iniciar o Elipse Power Studio

As opções disponíveis nesta caixa de diálogo estão descritas na tabela a seguir.
Opções disponíveis na janela Iniciar o Elipse Power Studio
OPÇÃO DESCRIÇÃO
Iniciar o Elipse Power Studio Não abre nenhum Domínio
Criar um Domínio novo Requisita um nome e um caminho para este novo

Domínio
Abrir um Domínio existente Ao clicar em Outros Arquivos, tem-se a opção de

localizar um Domínio em um diretório específico ou
selecionar na lista uma das últimas aplicações editadas
2.2 Área de Trabalho

O Elipse Power Studio já vem com uma série de menus e uma barra de ferramentas configurados, que são
mostrados ao executá-lo pela primeira vez. Ao utilizar uma interface gráfica mais moderna, similar a programas como
o Microsoft Office, os menus e a barra de ferramentas podem ser modificados pelo usuário. Quando não existe uma
aplicação aberta, a tela apresenta menos opções habilitadas na barra de menu e na barra de ferramentas, mas sua
aparência permanece a mesma. A figura a seguir mostra a aparência do Elipse Power Studio após a criação de um
novo projeto.
7 Elipse Power Studio

Área de trabalho do Elipse Power Studio
A Barra de Título mostra o caminho e o nome da aplicação, ou o nome do objeto cujo Editor esteja sendo mostrado
na área de trabalho.
A Barra de Status mostra informações de ajuda a respeito da área da tela sobre a qual está o ponteiro do mouse.
A Barra de Ferramentas mostra os recursos que podem ser utilizados no Elipse Power.
A Área de Trabalho é onde os Editores são mostrados.
2.3 Configuração
O Elipse Power permite personalizar alguns recursos do Elipse Power Studio, tais como barras de ferramentas,
teclado, menus, mouse, etc.
2.3.1 Aparência
Para personalizar a aparência do Elipse Power Studio, clique no menu Visualizar - Personalizar. As opções
disponíveis deste item estão descritas a seguir.
Aba Comandos
Esta aba define ícones adicionais para a barra de ferramentas Padrão ou para a barra de menus. Para isto, clique no
ícone na lista Comandos e arraste-o para a barra de ferramentas Padrão ou para a barra de menus.
Elipse Power Studio 8

Aba Comandos
Opções disponíveis na aba Comandos
OPÇÃO DESCRIÇÃO
Categorias Mostra as categorias disponíveis para a barra de
ferramentas Padrão ou para a barra de menus do Elipse
Power Studio
Comandos Mostra os itens que compõem a categoria selecionada
Descrição Breve descrição da opção selecionada
Aba Barras de Ferramentas

Esta aba configura a barra de ferramentas Padrão e a barra de menus do Elipse Power Studio.
Aba Barras de ferramentas

As opções disponíveis nesta aba estão disponíveis na tabela a seguir.

Opções disponíveis na aba Barras de ferramentas
OPÇÃO DESCRIÇÃO
Barras de ferramentas Lista as barras de ferramentas disponíveis
Restaurar Restaura as opções padrão para o item selecionado na

lista Barras de ferramentas
Restaurar tudo Restaura as opções padrão tanto para a barra de

ferramentas Padrão quanto para a barra de menus
Nova Cria uma nova barra de ferramentas. Esta opção não tem
efeito e é mantida no Elipse Power por questões de
compatibilidade
Renomear Muda o nome da barra de ferramentas selecionada. Esta

opção não tem efeito e é mantida no Elipse Power por
questões de compatibilidade
Remover Remove a barra de ferramentas selecionada. Esta opção

não tem efeito e é mantida no Elipse Power por
questões de compatibilidade
Mostrar legendas Mostra uma legenda nas opções da barra de

ferramentas Padrão. Esta opção não está disponível para
a barra de menus
Aba Menus
Esta aba configura os menus do Elipse Power.
Aba Menus
Opções disponíveis na aba Menus
OPÇÃO DESCRIÇÃO
Mostra menus para Exibe um menu pré-definido da aplicação. Esta opção
não tem efeito e é mantida no Elipse Power por questão
de compatibilidade
Restaurar Restaura o menu definido na opção anterior. Esta opção

não tem efeito e é mantida no Elipse Power por questão
de compatibilidade

OPÇÃO DESCRIÇÃO
Animação dos menus Seleciona o tipo de animação usada nos menus. As
opções disponíveis são Nenhuma (padrão do Elipse
Power), Desdobrar, Deslizar, Fade ou [Default] (padrão
do Windows)
Menus com sombra Define se um menu apresenta o efeito de sombreado ou

não
Aba Aparência
Esta aba altera a aparência das janelas e barras de ferramentas no Elipse Power Studio.
Aba Aparência
Opções disponíveis na aba Aparência
OPÇÃO DESCRIÇÃO
Windows Nativo Configura a aparência do Elipse Power Studio com o
estilo usado no esquema de cores do Windows
atualmente instalado
Office 2000 Configura a aparência do Elipse Power Studio com o

estilo usado no esquema de cores Office 2000
Office XP Configura a aparência do Elipse Power Studio com o

estilo usado no esquema de cores Office XP
Office 2003 Configura a aparência do Elipse Power Studio com o

estilo usado no esquema de cores Office 2003
VS.Net 2005 Configura a aparência do Elipse Power Studio com o

estilo usado no esquema de cores Visual Studio .NET
2005
Office 2007 (Prata) Configura a aparência do Elipse Power Studio com o

estilo usado no esquema de cores Office 2007 Prata
VS 2008 Configura a aparência do Elipse Power Studio com o

estilo usado no esquema de cores Visual Studio 2008
VS 2010 Configura a aparência do Elipse Power Studio com o

estilo usado no esquema de cores Visual Studio 2010

OPÇÃO DESCRIÇÃO
Office 2010 (Prata) Configura a aparência do Elipse Power Studio com o
estilo usado no esquema de cores Office 2010 Prata
Aba Opções
Esta aba configura as especificações gerais de um projeto. Neste item é possível habilitar ou desabilitar as opções da
barra de ferramentas Padrão ou da barra de ferramentas de uma Tela.
Aba Opções
Opções disponíveis na aba Opções
OPÇÃO DESCRIÇÃO
Mostrar descrições Habilita o Elipse Power a mostrar uma breve descrição
nas opções da barra de ferramentas Padrão e nas
barras de ferramentas de uma Tela quando o ponteiro
do mouse é posicionado sobre um item
Incluir teclas de atalho Mostra ou não os atalhos de teclado na descrição de

uma opção
Ícones grandes Habilita ícones grandes na barras de ferramentas Padrão

e nas barras de ferramentas de uma Tela
2.3.2 Outras Configurações

Pode-se configurar o Editor de Scripts do Elipse Power, bem como outras opções dos arquivos do Domínio, através
do menu Ferramentas - Opções, onde tem-se acesso à janela de configurações mostrada nas figuras a seguir.
A aba Geral configura comportamento gerais de Editores de objetos e Domínios.

Aba Geral
Opções disponíveis na aba Geral
OPÇÃO DESCRIÇÃO
Ativar o Editor de Scripts Ativa a aba Scripts do Editor do objeto na ocorrência de
um duplo-clique do mouse
Abrir a Janela de Propriedades Abre a Janela de Propriedades de um objeto na

ocorrência de um duplo-clique do mouse. NOTA: A Janela
de Propriedades também pode ser aberta utilizando os
atalhos de teclado ALT + ENTER ou ALT + Duplo-clique
do mouse
Mostrar botão de fechar na aba ativa Permite fechar a aba ativa ao clicar no seu respectivo
botão de fechar. Desmarcar esta opção posiciona o
botão de fechar à direita do Editor
Pedir confirmação ao parar o Domínio Se esta opção está selecionada, mostra uma mensagem
de confirmação de parada do Domínio ao usar a opção
Rodar ou Parar Domínio (SHIFT + F9) na barra de
ferramentas Padrão
Mostrar mensagens de advertência da janela Se esta opção está selecionada, todas as mensagens
Procurar/Substituir mostradas em caixas de diálogo durante as operações de
procura e substituição da janela Procurar e Substituir
são sempre mostradas. NOTA: Se esta opção está em um
estado indeterminado , isto indica que em algumas
mensagens o usuário desmarcou a opção Sempre
mostrar esta mensagem da caixa de diálogo e em outras
mensagens não
A aba Editor de Scripts destina-se à configuração do Editor de Scripts do Elipse Power.

Aba Editor de Scripts
Opções disponíveis na aba Editor
OPÇÃO DESCRIÇÃO
Abrir-e-Fechar blocos do texto Permite ocultar ou mostrar os blocos de código no script
Tamanho da margem Tamanho da margem da marcação do bloco de código
Numeração da linha Habilita a numeração de linha no editor de scripts
Tamanho da margem Tamanho da margem que contém a numeração de linha
Tamanho da tabulação Determina o número de espaços de tabulação
Fonte Determina o nome da fonte a ser usada no editor de

scripts
Tamanho Determina o tamanho da fonte a ser usada no editor de

scripts
NOTA
Feche os editores de scripts abertos para que as modificações sejam aplicadas.
A aba Arquivos permite habilitar ou desabilitar a verificação de CRC (Cyclic Redundancy Check ou Verificação de
Redundância Cíclica).

Aba Arquivos
Toda vez que um projeto ou uma biblioteca é criado, o Elipse Power grava internamente um código CRC dos dados
deste arquivo. Cada vez que um arquivo é aberto, é feita uma verificação deste CRC. Caso esta verificação falhe, ou
seja, o CRC não coincida com os dados, a carga do arquivo é abortada, indicando uma corrupção dos dados do
arquivo. Isto pode ser causado por falhas diversas de hardware, tais como memória, rede ou dispositivos de
armazenamento, entre outras.
Porém, se um projeto criado na versão atual é modificado em uma versão anterior à versão 1.00.019 build 203, o CRC
não é atualizado. Com isto, o arquivo não pode ser aberto novamente com as versões atuais, pois a verificação de
CRC falha, mesmo que o arquivo não esteja efetivamente corrompido. Para solucionar esta questão, é necessário
habilitar a opção Ignorar verificação de CRC. Assim, um projeto pode ser aberto em uma versão atual.
Neste caso, a opção deve permanecer habilitada até que todos os objetos editados na versão antiga tenham sido
salvos com a versão atual, o que atualiza o CRC.
NOTA
Não é recomendável que arquivos de projeto sejam editados em versões mais antigas do Elipse Power e depois
abertos novamente em versões atuais, pois não há garantia de que com este procedimento não sejam perdidas as
configurações destes arquivos.
2.4 Barra de Ferramentas

A Barra de Ferramentas do Elipse Power contém opções que permitem a execução de determinadas tarefas
rapidamente sem utilizar os menus, como por exemplo abrir o Organizer. A tabela a seguir mostra as opções
disponíveis na barra de ferramentas Padrão do Elipse Power Studio.
Opções disponíveis na barra de ferramentas Padrão
COMANDO AÇÃO
Novo Cria um novo projeto (CTRL + N)
Abrir Projeto Abre um projeto existente (CTRL + O)
Salvar Salva um projeto (CTRL + S)
Salvar Tudo Salva todo o Domínio (CTRL + SHIFT + S)

COMANDO AÇÃO
Registrar Bibliotecas Registra todas as bibliotecas carregadas (CTRL + SHIFT
+ L)
Recortar Remove a informação selecionada e a move para a Área

de Transferência (SHIFT + DELETE)
Copiar Copia a informação selecionada e a move para a Área

de Transferência (CTRL + C)
Colar Cola a informação selecionada da Área de Transferência

(CTRL + V)
Desfazer Desfaz a última ação executada (ALT + BACKSPACE)
Refazer Refaz a última ação desfeita pela opção Desfazer (CTRL

+ Y)
Organizer Mostra ou esconde o Organizer (CTRL + SHIFT + O)
Galeria Mostra ou esconde a Galeria (CTRL + SHIFT + G)
Lista de Propriedades Mostra ou esconde a Lista de Propriedades (CTRL +

SHIFT + P)
Verificação de Domínio Verifica se o Domínio atual contém erros (CTRL + SHIFT

+ V)
Mostrar no Editor Mostra um objeto no Editor deste objeto, se este estiver

selecionado no Organizer (ENTER)
Mostrar no Organizer Mostra um objeto no Organizer, se este estiver

selecionado no Editor do objeto
Executar Aplicativo Salva todos os projetos e bibliotecas, executa o Domínio

e abre o Elipse Power Viewer (F9)
Rodar ou Parar Domínio Executa ou para o Domínio corrente (SHIFT + F9)
Executar ou Parar Elipse Power Viewer Executa ou para o Elipse Power Viewer (CTRL + F9)
Desfragmentar Arquivos Desfragmenta o arquivo especificado
Criar Pacote de Bibliotecas Cria um arquivo compactado com as bibliotecas

disponíveis no Domínio
Procurar Procura todas as ocorrências de um determinado texto

em todo o Domínio (CTRL + SHIFT + F)
Substituir Substitui todas as ocorrências de um determinado texto

em todo o Domínio (CTRL + SHIFT + H)
Contagem de Objetos do Domínio Mostra uma janela com as quantidades de objetos

disponíveis no Domínio, separados por classes
ordenadas alfabeticamente ou agrupadas por módulos
(CTRL + SHIFT + C)
Documentação de Scripts Gera a documentação dos scripts
Relatório de Versões Mostra as versões dos projetos e bibliotecas
WatchWindow Mostra ou edita os valores de Tags e de propriedades

no Elipse Power Studio em tempo de execução (CTRL +
SHIFT + W)
2.4.1 Contagem de Objetos do Domínio

A ferramenta Contagem de Objetos do Domínio permite visualizar a quantidade de objetos existentes em um
Domínio, separados por classes ordenadas alfabeticamente ou agrupadas por módulos. A contagem também pode
ser realizada contextualmente a um objeto, clicando com o botão direito do mouse no objeto desejado e
selecionando a opção Contagem de Objetos .

Janela Contagem de Objetos do Domínio
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Contagem de Objetos do Domínio
OPÇÃO DESCRIÇÃO
Ordenar por Categoria Mostra a contagem de objetos organizando-os pelo
módulo
Ordenar Alfabeticamente Mostra a contagem de objetos organizando-os em

ordem alfabética
Atualizar Atualiza a contagem de objetos. NOTA: A atualização

não é automática, exceto quando o objeto removido é o
objeto base do contexto de contagem ou ao fechar o
Domínio
Contar Filhos de Instâncias de ElipseXs Inclui na contagem os filhos internos das instâncias de
um XControl, XFolder ou XObject
Procurar Permite filtrar a listagem pelo nome ou parte do nome

de um objeto
NOTAS
· O menu contextual Contagem de Objetos não está disponível no Organizer em modo Domínio para os itens
Configuração, Servidores, Arquivos e Domínios Remotos.
· Os arquivos individuais do item Arquivos no Organizer em modo Domínio permitem utilizar o menu contextual
Contagem de Objetos.
· No caso de arquivos protegidos por senha, é necessário que estes arquivos estejam abertos para que sejam
incluídos na contagem.
2.4.2 Criar Pacote de Bibliotecas

A ferramenta Criar Pacote de Bibliotecas permite criar um arquivo compactado contendo uma ou mais bibliotecas do
Domínio atual. Ao selecionar esta opção, a janela da figura a seguir é aberta.

Janela Criar Pacote de Bibliotecas
Opções disponíveis na janela Criar Pacote de Bibliotecas
OPÇÃO DESCRIÇÃO
Bibliotecas disponíveis Listagem com todas as bibliotecas registradas no
Domínio atual
Bibliotecas selecionadas Listagem com todas as bibliotecas selecionadas para o

pacote de bibliotecas
Adicionar Adiciona a biblioteca selecionada na listagem Bibliotecas

disponíveis na listagem Bibliotecas selecionadas
Remover Remove a biblioteca selecionada na listagem Bibliotecas

selecionadas, movendo-a de volta para a listagem
Bibliotecas disponíveis
Criar Abre uma caixa de diálogo Salvar Como, que permite

selecionar onde salvar o pacote com as bibliotecas
selecionadas em um arquivo com a extensão .e3pkg
O pacote criado usando esta opção não é automaticamente adicionado ao Domínio corrente. Para isto, clique com o
botão direito do mouse no pacote no modo Explorer do Organizer e selecione a opção Adicionar ao Domínio .
As bibliotecas que compõem um pacote não são visíveis no modo Domínio, somente no modo Explorer, e não
podem ser removidas do pacote.
Os pacotes de bibliotecas contêm uma opção Extrair Bibliotecas no menu contextual, que permite extrair todos os
recursos adicionados aos pacotes. Estes recursos não são adicionados ao Domínio corrente.
NOTA
Deve-se ter cuidado ao tentar incluir as bibliotecas ou recursos extraídos de um pacote de bibliotecas ao Domínio
atual, pois se já houver uma biblioteca com o mesmo identificador, esta situação impede a utilização destas
bibliotecas até que uma delas seja removida do Domínio.
2.4.3 Documentação de Scripts

A ferramenta Documentação de Scripts serve para auxiliar o usuário na organização e documentação dos scripts da
aplicação. Esta ferramenta pode ser acessada das seguintes formas:

· Através da opção Documentação de Scripts da barra de ferramentas Padrão. Utilizando esta opção, são
gravados no arquivo todos os scripts do Domínio
· Clicando com o botão direito do mouse no nome do projeto ou objeto e selecionando a opção Documentar
scripts. Utilizando esta opção, apenas os scripts do objeto selecionado e de seus filhos são gravados no arquivo
Esta ferramenta gera um arquivo texto que pode ser editado em qualquer programa de edição de textos. A
formatação do arquivo de documentação é realizada através de um assistente chamado Assistente de
Documentação de Scripts. Este assistente é responsável por guiar o usuário na configuração do arquivo de
documentação de scripts.
Assistente de Documentação de Scripts

Na janela Arquivo de documentação são definidas as informações referentes ao arquivo que guarda os scripts da
aplicação.
No item Nome do arquivo, especifique o nome do arquivo onde é gerada a documentação dos scripts. Especifique o
local onde este arquivo é salvo no item Salvar o arquivo na pasta, e caso haja necessidade, clique em Procurar.

Arquivo de documentação de scripts
Clique em Avançar para ir à próxima janela.
A janela Detalhamento do arquivo permite que se formate o arquivo que contém as informações de scripts. É
possível selecionar entre uma documentação simplificada, contendo apenas os nomes dos scripts, ou uma
documentação completa, onde todo o código dos scripts é gravado no arquivo.
Detalhamento do arquivo
Por exemplo, considere o script a seguir.
Sub TelaInicial_KeyDown(KeyCode, Shift)
If (KeyCode = 27) Then
Application.Exit
End Sub
Se a opção selecionada é Apenas os nomes dos scripts, o texto a seguir é gravado no arquivo.
TelaInicial_KeyDown(KeyCode, Shift)

Se é selecionada a opção Todo o script, então todo o código é gravado com a mesma formatação realizada pelo
usuário no Editor de Scripts, como por exemplo indentação e linhas em branco.
Independente do tipo de formatação selecionada, antes do script é gravado um identificador contendo o nome
completo do objeto, para evitar conflitos. Considere por exemplo os objetos a seguir.
TelaInicial
CommandButton1
Tela1
CommandButton1
Ambos os scripts (considerando um mesmo evento, Click) seriam gravados como CommandButton1_Click(). Assim, a
gravação do primeiro objeto no arquivo seria no formato a seguir.
<TelaInicial.CommandButton1:CommandButton1_Click()>
Sub CommandButton1_Click()
...
End Sub
E para o segundo objeto seria no formato a seguir.

<Tela1.CommandButton1:CommandButton1_Click()>
...
End Sub
Isto permite a identificação correta de cada script. Clique em Avançar para ir à próxima janela.
Na janela Separador de scripts é possível definir o texto que é gravado entre um script e outro no arquivo de
documentação. É possível selecionar entre linhas em branco ou personalizadas, e ainda informar quantas linhas do
tipo selecionado são inseridas no arquivo.
Separador de scripts
Pode-se optar entre uma Linha em branco ou uma Linha personalizada. Selecionando a opção Linha em branco, o
arquivo de documentação tem uma linha em branco entre um script e outro. Selecionando a opção Linha
personalizada, pode-se informar um ou mais caracteres para compor a linha que é usada como separador. Os
caracteres são informados no campo Entre com o texto da linha. Se a opção selecionada é Repetir até o final da
linha, os caracteres informados são repetidos até o limite de tamanho da linha, que é de 80 caracteres. Pode-se
também utilizar mais de uma linha como separador, seja em branco ou personalizada. para isto, informe um número
entre 1 (um) e 100 no campo Entre com o número de linhas do separador. Clique em Avançar para finalizar a
configuração. Logo após, o assistente mostra uma mensagem indicando a finalização da configuração e a geração do
arquivo que contém a documentação dos scripts.

Mensagem de finalização da geração do arquivo que contém os scripts
Algumas observações relevantes:
· Os scripts de XControls, XFolders e XObjects são gravados apenas uma vez no arquivo, pois são encontrados
durante a pesquisa na biblioteca. Scripts de instâncias são gravados quando o objeto pai da instância é
pesquisado
· Picks são internamente scripts. Logo, também são documentados
· A gravação no arquivo é realizada em ordem alfabética do nome do objeto, dentro de cada projeto ou biblioteca
· Não é possível adicionar scripts a um arquivo já existente, via Assistente. Sempre que o Assistente é iniciado, um
novo arquivo é criado ou, caso já exista, é sobrescrito
· Esta ferramenta pode demorar algum tempo para gerar o arquivo de documentação, caso a aplicação seja
grande e a pesquisa envolva muitos tipos de objetos. Para agilizar a pesquisa, é interessante gerar um arquivo
para cada tipo de objeto do Elipse Power
2.4.4 Procurar e Substituir

A ferramenta Procurar busca por ocorrências de um determinado texto, de forma parcial ou completa. Ao final da
busca é apresentada ao usuário uma lista de resultados indicando o objeto ou objetos onde a ocorrência foi
encontrada, a localização dentro deste objeto ou objetos, como por exemplo se é uma propriedade ou Associação, e
o texto que contém a ocorrência. Para utilizar esta ferramenta, selecione a opção Procurar na barra de
ferramentas Padrão, selecione o item Procurar no menu Ferramentas do Elipse Power Studio ou utilize o atalho de
teclado CTRL + SHIFT + F. Nestes casos a procura é sempre iniciada para todo o Domínio atual. Ao clicar com o botão
direito do mouse em um objeto e selecionar a opção Procurar, que é equivalente ao atalho de teclado CTRL + F, a
procura é sempre iniciada a partir do objeto selecionado e os respectivos filhos, se houver.

Janela Procurar
Opções disponíveis na janela Procurar
OPÇÃO DESCRIÇÃO
Procurar por Texto a ser procurado
Olhar em Procura em todo o Domínio, nas janelas Resultados de

Procura 1 (um) ou 2 (dois) ou somente no objeto
selecionado
Diferenciar maiúsculas de minúsculas Procura pelo texto especificado exatamente como foi
escrito, diferenciando maiúsculas de minúsculas
Palavra inteira Procura pelo texto especificado como uma palavra

inteira, sem considerar se este texto está contido em
outro texto
Usar expressões regulares Procura pelo texto especificado utilizando o recurso de

expressões regulares, descrito mais adiante
Tudo Procura pelo texto especificado em propriedades dos

objetos, Associações, scripts e Picks
Incluir Dados das Fórmulas Inclui na procura os dados no banco de dados das
Fórmulas
Propriedades Procura pelo texto especificado apenas nos valores das

propriedades dos objetos

OPÇÃO DESCRIÇÃO
Apenas Nomes Procura pelo texto especificado apenas em propriedades
que representam os nomes dos objetos, como por
exemplo Name e ConnectionName
Associações Procura pelo texto especificado apenas nas Associações

dos objetos
Apenas Fontes Procura pelo texto especificado apenas nas fontes das
Associações dos objetos
Scripts e Picks Procura pelo texto especificado apenas em scripts e Picks

dos objetos
Resultados de Procura 1 e 2 Mostra os resultados da procura nas janelas Resultados

de Procura 1 (um) ou 2 (dois)
Acrescentar Resultados Permite executar uma procura sem remover os

resultados das buscas anteriores
Procurar Executa a procura usando as opções selecionadas
Ao selecionar a opção Usar expressões regulares, é possível utilizar padrões de combinações de caracteres,
conhecidos como Expressões Regulares, para localizar texto. Por exemplo, utilizar a expressão "a*c" permitiria
encontrar os textos "abc", "abbc" ou "a123c". A tabela a seguir contém alguns exemplos de combinações mais comuns
em expressões regulares.
Combinações comuns em expressões regulares
COMBINAÇÃO DESCRIÇÃO
a Encontra apenas o caractere "a"
. (ponto) Encontra qualquer sequência de caracteres, exceto nova

linha
[a-c] Encontra apenas os caracteres "a", "b" ou "c"
\n, \t Encontra os caracteres de nova linha ou tabulação,

respectivamente
NOTAS
· O Elipse Power utiliza a sintaxe ECMAScript nas expressões regulares. Para mais informações, consulte o tópico
Expressões Regulares no Microsoft Docs.
· Selecionar a opção Usar expressões regulares habilita a opção ao lado da opção Procurar por, que permite
selecionar as expressões regulares mais comuns de busca.
A figura a seguir mostra a janela Resultados de Procura 1 (um) de uma operação de procura.

Janela Resultados de Procura 1
Opções disponíveis na janela Resultados de Procura 1 ou 2
OPÇÃO DESCRIÇÃO
Selecionar Anterior Seleciona o resultado anterior na lista de resultados
(CTRL + SHIFT + F8)
Selecionar Próximo Seleciona o próximo resultado na lista de resultados

(CTRL + F8)
Ir para Resultado Seleciona o objeto que contém o resultado no

Organizer
Apagar Grupos Selecionados Apaga o grupo de resultados de procura selecionado

(DELETE)
Limpar Lista de Resultados Remove todos os resultados de procura da lista de

resultados
Filtro Permite filtrar os resultados usando as colunas Objeto,

Localização ou Resultado
Objeto Caminho completo do objeto onde o texto foi

encontrado
Localização Mostra onde o texto foi encontrado, de acordo com as

opções selecionadas no grupo Avançado da janela
Procurar
Resultado Mostra a expressão onde o texto foi encontrado
NOTA
Os grupos de resultados nas janelas Resultados de Procura 1 (um) e 2 (dois) podem ser expandidos ou recolhidos
para melhor organizar os resultados de busca, especialmente ao selecionar a opção Acrescentar Resultados.
A ferramenta Substituir substitui as ocorrências encontradas por outro texto especificado. Para utilizar esta
ferramenta, selecione a opção Substituir na barra de ferramentas Padrão, selecione o item Substituir no menu
Ferramentas do Elipse Power Studio ou utilize o atalho de teclado CTRL + SHIFT + H. Nestes casos a substituição é
sempre realizada para todo o Domínio atual. Ao clicar com o botão direito do mouse em um objeto e selecionar a
opção Substituir, que é equivalente ao atalho de teclado CTRL + H, a substituição é sempre realizada a partir do
objeto selecionado e os respectivos filhos, se houver.

Janela Substituir
Opções disponíveis na janela Substituir
OPÇÃO DESCRIÇÃO
Procurar por Texto a ser procurado para substituição
Substituir por Texto a ser utilizado na substituição
Olhar em Realiza a substituição em todo o Domínio, nas janelas

Resultados de Procura 1 (um) ou 2 (dois) ou somente no
objeto selecionado
Diferenciar maiúsculas de minúsculas Realiza a substituição pelo texto exatamente como foi
escrito, diferenciando maiúsculas de minúsculas
Palavra inteira Realiza a substituição do texto especificado como uma

palavra inteira, sem considerar se este texto está contido
em outro texto

OPÇÃO DESCRIÇÃO
Usar expressões regulares Realiza a substituição do texto especificado utilizando o
recurso de expressões regulares, descrito na ferramenta
Procurar
Tudo Realiza a substituição do texto especificado em

propriedades dos objetos, Associações, scripts e Picks
Incluir Dados das Fórmulas Inclui na substituição os dados no banco de dados das
Fórmulas
Propriedades Realiza a substituição do texto especificado apenas nos

valores das propriedades dos objetos
Apenas Nomes Realiza a substituição do texto especificado apenas em

propriedades que representam os nomes dos objetos,
como por exemplo Name e ConnectionName
Associações Realiza a substituição do texto especificado apenas nas

Associações dos objetos
Apenas Fontes Realiza a substituição do texto especificado apenas nas

fontes das Associações dos objetos
Scripts e Picks Realiza a substituição do texto especificado apenas em

scripts e Picks dos objetos
Resultados de Procura 1 e 2 Mostra os resultados da substituição nas janelas

Resultados de Procura 1 (um) ou 2 (dois)
Acrescentar Resultados Permite executar uma substituição sem remover os

resultados das substituições anteriores
Procurar Executa a procura usando as opções selecionadas sem

executar a substituição
Substituir Executa a substituição usando as opções selecionadas do

primeiro resultado da procura nas janelas Resultados de
Procura 1 (um) ou 2 (dois)
Substituir Tudo Executa a substituição usando as opções selecionadas de

todos os resultados da procura
Substituir Seleção Executa a substituição somente nos resultados

selecionados nas janelas Resultados de Procura 1 (um)
ou 2 (dois)
Substituir Visíveis Executa a substituição somente nos resultados

mostrados após utilizar a opção Filtro das colunas
Objeto, Localização ou Resultado nas janelas
Resultados de Procura 1 (um) ou 2 (dois)
NOTA
Para selecionar um objeto e mostrar o local exato onde o texto se encontra ou onde o texto foi substituído, clique
duas vezes na linha correspondente da lista de resultados ou pressione a tecla de espaço.
A tabela a seguir contém as principais opções de pesquisa, bem como as limitações para os principais tipos de
dados.

Principais opções de pesquisa
TIPO DE DADOS EXEMPLO OBSERVAÇÃO
Data e Hora 10/02/2010 Encontra em propriedades do tipo
00:00:10 Data e Hora. Se somente a data é
especificada, encontra todas as
ocorrências desta data, independente
da hora. Se somente a hora é
especificada, encontra todas as
ocorrências desta hora, independente
da data. Os milissegundos são
ignorados na pesquisa
Inteiro 0 Encontra em todas as propriedades

100 numéricas. Pesquisar por 10 encontra
10 e 10.0, mas não encontra 10.1 ou
100
Ponto flutuante 10.0 Encontra em todas as propriedades

40,5 numéricas de tipo Ponto Flutuante.
Pesquisar por 10.1 não encontra 10
(inteiro). As configurações regionais
do Windows são consideradas para
validar o símbolo decimal no número
Cor 255,255,0 Encontra apenas em propriedades do

0,0,234 tipo Cor. Deve necessariamente usar
vírgulas para separar os valores, que
devem estar no sistema RGB, ou seja,
três grupos de valores variando entre
0 (zero) e 255
Booleano Verdadeiro Leva em consideração o idioma do

True Windows para entender a pesquisa
como sendo de um valor Booleano
String Teste Encontra Strings inteiras ou partes de

Tag Strings, de acordo com o tipo de
pesquisa, por palavra inteira ou não.
Qualquer tipo de dado pode ser
encontrado em propriedades do tipo
String
2.4.5 Relatório de Versões

A ferramenta Relatório de Versões permite a visualização das versões e comentários dos projetos e das bibliotecas
abertos, pertencentes ou não ao Domínio. Para acessar esta ferramenta, clique em Relatório de Versões na barra
de ferramentas Padrão para mostrar a caixa de diálogo da figura a seguir.

Relatório de versões
As opções desta caixa de diálogo são mostradas na tabela a seguir.
Opções disponíveis na caixa de diálogo Relatório de versões
OPÇÃO DESCRIÇÃO
Projeto/Biblioteca Nome do projeto ou da biblioteca abertos
Versão Indica a versão do projeto ou biblioteca. Esta versão é

gerada internamente pelo Elipse Power, sendo
incrementada toda vez que um projeto é salvo, manual
ou automaticamente. No caso de projetos ou de
bibliotecas protegidos, se a versão não puder ser salva,
também não é possível incrementá-la. No entanto, se o
usuário tem permissão para abrir e alterar um projeto ou
biblioteca, a versão é incrementada normalmente
Comentário Mostra o comentário relacionado ao projeto. Este

comentário pode ser editado através da propriedade
DocString. No caso de bibliotecas, este campo
permanece em branco
NOTA
Estes campos são apenas para visualização, não sendo permitida sua edição.
2.4.6 Verificação de Domínio

A ferramenta Verificação de Domínio verifica erros de configuração em todo o Domínio, tais como objetos com o
mesmo nome e Associações ilegais, entre outros. Para usar esta ferramenta, clique em Verificação de Domínio na
barra de ferramentas Padrão para mostrar a janela da figura a seguir.
Janela Verificação de Domínio

Opções disponíveis na janela Verificação de Domínio
OPÇÃO DESCRIÇÃO
Limpa a lista de erros Remove todas as mensagens da lista de resultados
Mostra a janela de informações Mostra uma janela com informações detalhadas do erro
selecionado
Executa a verificação Executa o processo de verificação no Domínio atual ou

no objeto selecionado no Organizer
Exportar Lista de Erros Exporta o resultado da verificação para um arquivo no

formato CSV (Comma-Separated Values)
Objeto Caminho completo do objeto em erro
Erro Tipo de erro encontrado
Descrição Descrição detalhada do erro encontrado
Solução Mensagem sugerindo uma solução para o erro

encontrado
Filtro Permite filtrar a lista de erros para as colunas

disponíveis
Ao clicar na opção Mostra a janela de informações , a janela da figura a seguir é mostrada.
Janela Problemas a Resolver

Após solucionar o erro ou erros indicados, a janela da figura a seguir é mostrada.
Janela de sucesso na verificação

Clicar duas vezes em um erro na lista seleciona o objeto correspondente no Organizer, como mostrado na figura a
seguir.

Objeto com erros selecionado
no Organizer
A ferramenta Verificação de Domínio está disponível no menu Ferramentas do Elipse Power Studio e também no
menu contextual dos objetos do Organizer. Neste caso, a verificação é realizada no objeto selecionado e em seus
filhos.
2.4.7 WatchWindow
A ferramenta WatchWindow permite a visualização e edição do valor corrente de qualquer propriedade ou Tag em
tempo de execução no Elipse Power Studio. Para utilizar esta ferramenta, clique em WatchWindow na barra de
ferramentas Padrão ou utilize o menu Ferramentas - WatchWindow para mostrar a janela da figura a seguir.
Janela WatchWindow
Opções disponíveis na janela WatchWindow
OPÇÃO DESCRIÇÃO
Adicionar Abre o DomainBrowser, uma janela do AppBrowser com
os objetos criados no servidor, e seleciona o objeto que
é mostrado na janela WatchWindow
Remover Remove a linha selecionada da lista de objetos da janela

WatchWindow

OPÇÃO DESCRIÇÃO
Atualizar Busca toda a árvore de filhos dos objetos selecionados
atualmente na janela WatchWindow
Conectar ou Desconectar Tenta reativar a conexão perdida com o Domínio, para

que a visualização seja possível, ou desativa a conexão
caso esteja ativa
Nome Mostra o Tag ou a propriedade visualizada
Qualidade Mostra a qualidade do Tag ou da propriedade
Estampa de Tempo Mostra a estampa de tempo do Tag ou da propriedade
Valor Mostra o valor do Tag ou da propriedade, em tempo de

execução, e permite editar este valor. Consulte o tópico
Permissões para mais informações sobre esta coluna
Status Mostra se o Domínio está conectado ou desconectado
Caso a coluna Valor mostre a indicação Array, isto significa que o Tag ou a propriedade é do tipo Variant e contém
um Array. Para visualizar ou editar os valores deste Array, clique na célula desejada e selecione a opção Visualizar
Array. A janela da figura a seguir é mostrada.
Janela Edição de Arrays

Nesta janela, se algum dos valores também mostrar a indicação Array, os valores podem ser visualizados ou editados
repetindo o procedimento anterior.
2.5 Atalhos de Teclado

Diversas funções do Elipse Power Studio podem ser acessadas diretamente por atalhos de teclado. As tabelas a
seguir listam os atalhos de teclado disponíveis.
Atalhos de teclado para objetos de Tela em Editores
ATALHO DE TECLADO DESCRIÇÃO
CTRL + Sinal de mais (+) Aumenta o zoom. Este atalho de teclado também
funciona em tempo de execução
CTRL + Sinal de menos (-) Diminui o zoom. Este atalho de teclado também funciona
em tempo de execução
CTRL + Zero (0) ou CTRL + Asterisco (*) Volta para o zoom de 100%
CTRL + Cinco (5) ou CTRL + CLEAR Alterna entre redimensionar a Tela para caber na área
visível e restaurar o nível de zoom e a posição anteriores
da barra de rolagem. NOTA: O atalho de teclado CTRL
+ Cinco (5), no teclado numérico, está disponível
somente quando a opção NUM LOCK está desabilitada
CTRL + Roda do mouse Aumenta ou diminui o zoom. Este atalho de teclado

também funciona em tempo de execução

CTRL + HOME Aplica o menor zoom permitido. Este atalho de teclado
CTRL + END Aplica o maior zoom permitido. Este atalho de teclado

CTRL + Vírgula (,) Aplica o zoom anterior disponível no menu Zoom. Este
atalho de teclado também funciona em tempo de
execução
CTRL + Ponto (.) Aplica o próximo zoom disponível no menu Zoom. Este
atalho de teclado também funciona em tempo de
execução
CTRL + ENTER Permite editar um objeto dentro de um grupo, uma

Animação com Rotação ou uma Animação com
Translação, desde que o objeto não esteja travado
ESC Passa o contexto de seleção para o objeto pai do

objeto selecionado em um grupo, uma Animação com
Rotação ou uma Animação com Translação
Roda do mouse Rola a Tela verticalmente, ou horizontalmente se apenas

a barra de rolagem horizontal estiver visível. Este atalho
de teclado também funciona em tempo de execução
SHIFT + Roda do mouse Rola a Tela horizontalmente, ou verticalmente se apenas

a barra de rolagem vertical estiver visível. Este atalho de
teclado também funciona em tempo de execução
ALT + ENTER Abre a Janela de Propriedades do objeto selecionado
SHIFT + F10 Abre o menu contextual do objeto selecionado
TAB Move a seleção para o objeto seguinte na ordem de

navegação dos objetos, independente do valor da
propriedade Visible. NOTA: Caso um objeto esteja em
uma camada invisível, este não é selecionado,
independente do valor da propriedade Visible
SHIFT + TAB Move a seleção para o objeto anterior na ordem de

navegação dos objetos, independente do valor da
propriedade Visible. NOTA: Caso um objeto esteja em
uma camada invisível, este não é selecionado,
independente do valor da propriedade Visible
Tecla de aplicação ou de menu Abre o menu contextual do objeto selecionado
DELETE Apaga o objeto selecionado
Tecla de seta para cima Move o objeto selecionado para cima
ALT + Tecla de seta para cima Move o objeto selecionado para cima em um passo dez
vezes mais rápido
CTRL + Tecla de seta para cima Move a Tela selecionada para baixo
CTRL + ALT + Tecla de seta para cima Move a Tela selecionada para baixo em um passo dez
vezes mais rápido
SHIFT + Tecla de seta para cima Diminui o tamanho do objeto selecionado verticalmente
para cima
SHIFT + ALT + Tecla de seta para cima Diminui o tamanho do objeto selecionado verticalmente
para cima em um passo dez vezes mais rápido
Tecla de seta para baixo Move o objeto selecionado para baixo
ALT + Tecla de seta para baixo Move o objeto selecionado para baixo em um passo
dez vezes mais rápido

CTRL + Tecla de seta para baixo Move a Tela selecionada para cima
CTRL + ALT + Tecla de seta para baixo Move a Tela selecionada para cima em um passo dez
vezes mais rápido
SHIFT + Tecla de seta para baixo Aumenta o tamanho do objeto selecionado

verticalmente para baixo
SHIFT + ALT + Tecla de seta para baixo Aumenta o tamanho do objeto selecionado
verticalmente para baixo em um passo dez vezes mais
rápido
Tecla de seta à esquerda Move o objeto selecionado para a esquerda
ALT + Tecla de seta à esquerda Move o objeto selecionado para a esquerda em um

passo dez vezes mais rápido
CTRL + Tecla de seta à esquerda Move a Tela selecionada para a direita
CTRL + ALT + Tecla de seta à esquerda Move a Tela selecionada para a direita em um passo
SHIFT + Tecla de seta à esquerda Reduz o tamanho do objeto selecionado

horizontalmente para a esquerda
SHIFT + ALT + Tecla de seta à esquerda Reduz o tamanho do objeto selecionado

horizontalmente para a esquerda em um passo dez
vezes mais rápido
Tecla de seta à direita Move o objeto selecionado para a direita
ALT + Tecla de seta à direita Move o objeto selecionado para a direita em um passo
CTRL + Tecla de seta à direita Move a Tela selecionada para a esquerda
CTRL + ALT + Tecla de seta à direita Move a Tela selecionada para a esquerda em um passo
SHIFT + Tecla de seta à direita Aumenta o tamanho do objeto selecionado

horizontalmente para a direita
SHIFT + ALT + Tecla de seta à direita Aumenta o tamanho do objeto selecionado

horizontalmente para a direita em um passo dez vezes
mais rápido
F2 Edita a propriedade Caption ou Value do objeto

selecionado
CTRL + Tecla de espaço Ajusta o tamanho ou a posição da seleção de um objeto

para o pixel mais próximo
SHIFT + Arrastar Seleciona múltiplos objetos ou adiciona objetos a uma

seleção prévia
SHIFT + Clique Adiciona ou remove um objeto de uma seleção
Atalhos de teclado para as janelas do Elipse Power Studio

ESC Retorna o foco do teclado para o último Editor aberto,
se houver
CTRL + SHIFT + O Abre ou move o foco do teclado para o Organizer
CTRL + SHIFT + G Abre ou move o foco do teclado para a Galeria
CTRL + SHIFT + P Abre ou move o foco do teclado para a Lista de

Propriedades

CTRL + SHIFT + C Abre ou move o foco do teclado para a janela Contagem
de Objetos do Domínio
CTRL + SHIFT + V Abre ou move o foco do teclado para a janela

Verificação de Domínio
CTRL + SHIFT + F Abre ou move o foco do teclado para a janela Procurar
CTRL + SHIFT + H Abre ou move o foco do teclado para a janela Substituir
CTRL + SHIFT + W Abre ou move o foco do teclado para a janela

WatchWindow
Atalhos de teclado para células de grades no Elipse Power Studio

Tecla de espaço Abre um menu contextual de tipos de Associações na
coluna Conexão da aba Associações da Janela de
Propriedades ou na janela Editar Associação
F4, SHIFT + F4, CTRL + F4 ou ALT + Tecla de seta Abre ou fecha a lista de seleção em células que permitem
para cima selecionar um valor a partir de uma lista de valores
ALT + Teclas de seta para a direita ou para baixo Abre a lista de seleção em células que permitem
selecionar um valor a partir de uma lista de valores
ALT + Ponto (.) Abre a janela para edição de um valor em células que
contém a opção
CTRL + ENTER ou ALT + Tecla de seta para baixo Move o foco do teclado para a janela de configuração
dos valores de Associações Digitais, Analógicas, Por
Tabela e Múltiplas
ESC ou ENTER Fecha a opção aberta pelos atalhos de teclado anteriores
Teclas de seta Percorre as células em uma grade
Atalhos de teclado para Editores de scripts

CTRL + A Seleciona todo o texto do script atual
CTRL + SHIFT + A Abre o AppBrowser
CTRL + E Cria um Pick Executar Aplicação
CTRL + F Abre a janela Procurar no texto do script atual
CTRL + H Abre a janela Substituir no texto do script atual
CTRL + L Cria um Pick Carregar Valor
CTRL + M Cria um Pick Abrir Tela Modal
CTRL + T Cria um Pick Inverter Valor
CTRL + R Cria um Pick Imprimir Relatório
CTRL + Sinal de mais (+) Cria um novo script no objeto e evento selecionado
CTRL + SHIFT + Sinal de mais (+) Cria um Pick Abrir Tela
F3 Vai para a próxima ocorrência nas janelas Procurar ou

Substituir
SHIFT + F3 Vai para a ocorrência anterior nas janelas Procurar ou

Substituir
F7 Compila o script selecionado

ALT + F7 Compila todos os scripts do evento selecionado
CTRL + ALT + F7 Compila todos os eventos do objeto selecionado
CTRL + Teclas de seta para cima ou para baixo Move o script selecionado para cima ou para baixo,
respectivamente, na lista com a ordem de execução dos
scripts de um objeto
2.6 Organizer
O Organizer permite uma visão simples e organizada de toda uma aplicação, ajudando na edição e configuração de
todos os objetos envolvidos através de uma árvore hierárquica de opções. Possui os modos de visualização Domínio
e Explorer.
Organizer
O modo Domínio mostra apenas as informações dos objetos abertos pertencentes ao Domínio. Estas informações
estão organizadas nos grupos Configuração, Bibliotecas de Objetos, Visualização e Objetos de Servidor. Cada
grupo apresenta seus objetos ordenados alfabeticamente dentro do respectivo nó.

Modo Domínio
O grupo Configuração mostra os servidores configurados, bem como os nomes dos arquivos de projetos e de
bibliotecas pertencentes ao Domínio.
O grupo Bibliotecas de Objetos agrupa os objetos ElipseX de todas as bibliotecas pertencentes ao Domínio,
organizados por tipo de objetos (XControls, XFolders e XObjects).
Os demais objetos do Elipse Power estão nos grupos Visualização e Objetos de Servidor. Em Visualização estão os
objetos que executam na máquina cliente. Já os objetos executados na máquina servidor estão em Objetos de
Servidor.
O modo Explorer mostra projetos, bibliotecas e pacotes de bibliotecas abertos no Elipse Power Studio, pertencentes
ou não ao Domínio. Os objetos são mostrados no projeto, na biblioteca ou no pacote de bibliotecas ao qual
pertencem, ordenados alfabeticamente dentro de cada um.
Modo Explorer
A manutenção de uma aplicação pode ser realizada em qualquer um dos modos. As operações realizadas em um
modo são imediatamente refletidas no outro. Para facilitar a localização dos objetos, ambos os modos são
intercambiáveis, tanto entre si como com a aba Design do Editor do objeto. Para alternar o modo de visualização,
siga estes procedimentos:
1. No modo Domínio, clique com o botão direito do mouse no objeto e selecione a opção Mostrar no Explorer
para visualizá-lo no modo Explorer.
2. No modo Explorer, clique com o botão direito do mouse no objeto e selecione a opção Mostrar no Organizer
para visualizá-lo no modo Domínio.
3. Em qualquer um dos modos, clique com o botão direito do mouse no objeto e selecione a opção Mostrar no
Editor para visualizá-lo diretamente na aba Design.

4. Em qualquer Editor de objetos, na aba Design, clique com o botão direito do mouse no objeto e selecione a
opção Mostrar no Organizer ou a opção Mostrar no Explorer para visualizá-lo no Organizer, em seu
respectivo modo.
Ao clicar em um objeto com o botão esquerdo do mouse, suas propriedades podem ser visualizadas e editadas
através da Lista de Propriedades, se habilitada. Clicando com o botão direito do mouse em cada item do Organizer,
são mostradas as opções da tabela a seguir.
Opções disponíveis no Organizer
OPÇÃO DESCRIÇÃO
Fechar Fecha o projeto, biblioteca ou pacote de bibliotecas
corrente
Atualizar Atualiza as configurações de um projeto, biblioteca ou

pacote de bibliotecas
Registrar Registra a biblioteca selecionada para que as

modificações executadas estejam disponíveis
Salvar Como Abre uma caixa de diálogo para que um projeto ou

biblioteca sejam salvos no local indicado
Desfragmentar Desfragmenta arquivos de projeto, de biblioteca ou

pacote de bibliotecas, isto é, apaga os espaços criados
desnecessariamente por exclusão de itens, importação
de arquivos ou inclusão de recursos, entre outros. Após
a desfragmentação, uma janela é exibida contendo as
informações de tamanho original do arquivo, tamanho
desfragmentado e percentual de compactação
Proteção Protege o conteúdo de um arquivo de projeto ou de

biblioteca contra a edição, visualização ou execução não
autorizada. Para mais informações sobre esta opção,
consulte o capítulo Segurança
Nova Pasta Cria uma nova Pasta em uma aplicação
Inserir Insere objetos disponíveis no Elipse Power em um

projeto ou biblioteca. Para mais informações sobre esta
opção, consulte os respectivos capítulos de cada objeto
Inserir Recurso Insere recursos em um projeto, biblioteca ou pacote de

bibliotecas
Habilitar ou Desabilitar projeto Habilita ou desabilita o projeto selecionado. Para

desabilitar um projeto, clique com o botão direito do
mouse no projeto e selecione a opção Desabilitar
projeto. Observe que o ícone do projeto muda para ,
indicando que o projeto está desabilitado. Para habilitar
um projeto, clique com o botão direito do mouse no
projeto e selecione a opção Habilitar projeto. NOTA: O
ícone de desabilitado também é mostrado para
projetos que não fazem parte de um Domínio
Adicionar ao Domínio ou Remover do Domínio Adiciona ou remove um projeto, biblioteca ou pacote de

bibliotecas de um Domínio. Para remover de um
Domínio, clique com o botão direito do mouse e
selecione a opção Remover do Domínio. Para adicionar
a um Domínio, clique com o botão direito do mouse e
selecione a opção Adicionar ao Domínio
Procurar Busca por trechos de texto. Para mais informações sobre

esta opção, consulte o tópico Procurar e Substituir
deste capítulo

OPÇÃO DESCRIÇÃO
Substituir Busca por trechos de texto e os substitui por outros. Para
mais informações sobre esta opção, consulte o tópico
Procurar e Substituir deste capítulo
Contagem de Objetos Mostra a quantidade de objetos existentes em um

Domínio ou no objeto selecionado. Esta opção não está
disponível para os itens Configuração, Servidores,
Arquivos, Domínios Remotos e pacotes de bibliotecas
Importar ou Exportar Auxilia o usuário na importação e na exportação de

objetos, Associações e coleções. Para mais informações
sobre esta opção, consulte o tópico Importação e
Exportação deste capítulo
Documentar Scripts Auxilia o usuário com a documentação dos scripts de

uma aplicação. Para mais informações sobre esta opção,
consulte o tópico Documentação de Scripts deste
capítulo
Verificação Verifica os erros ocorridos em uma aplicação. Para mais

informações sobre esta opção, consulte o tópico
Verificação de Domínio deste capítulo
Editar Associações Muda uma ou mais Associações, eventos de usuário e

propriedades do tipo Link realizadas em uma aplicação,
de forma mais rápida do que pela janela tradicional. Para
mais informações sobre esta opção, consulte o capítulo
Associações
Copiar ou Colar Associações Copia ou cola Associações de um objeto para outro. A

segunda opção só é mostrada se o que estiver copiado
na Área de Transferência do Windows é uma Associação.
Se a propriedade já possuir uma Associação, mostra
uma mensagem ao usuário perguntando se a Associação
deve ser sobrescrita ou não. Se as Associações copiadas
na Área de Transferência são coladas em um objeto que
não possua alguma das propriedades, estas são listadas
para o usuário em uma mensagem informando o
problema. As propriedades que existirem têm as
Associações criadas corretamente. Associações de
propriedades escondidas dos ElipseX não são copiadas
Mostrar Definição da Classe Seleciona, no item Bibliotecas de Objetos, a classe

(XFolder, XObject ou XControl) que define a instância do
ElipseX selecionado. NOTA: Para classes ou bibliotecas
protegidas por senha, está opção está desabilitada
Propriedades Abre a Janela de Propriedades de um objeto. Quando

esta opção é aberta pelo menu contextual, a primeira
aba a ser aberta é a de configurações do objeto. Para
mais informações sobre esta opção, consulte o capítulo
respectivo de cada objeto. NOTA: A Janela de
Propriedades também pode ser aberta utilizando os
atalhos de teclado ALT + ENTER ou ALT + Duplo-clique
do mouse
Carregar Todos os Objetos Carrega todos os objetos do grupo selecionado
Fechar Todos os Objetos Fecha todos os objetos do grupo selecionado
Salvar Todos os Objetos Salva todos os objetos do grupo selecionado
Novo Arquivo de Aplicação (.PRJ) Cria um novo arquivo de projeto e o inclui no Domínio
Nova Biblioteca de Objetos (.LIB) Cria um novo arquivo de biblioteca e o inclui no Domínio

OPÇÃO DESCRIÇÃO
Registrar Bibliotecas Carregadas Registra todas as bibliotecas carregadas em um projeto
(CTRL + SHIFT + L)
Abrir Todos os Arquivos Percorre todos os arquivos de projeto e de biblioteca de

um Domínio. Se algum arquivo fechado é encontrado,
este é aberto. Se o arquivo estiver protegido com senha
de edição, solicita a senha. O Elipse Power Studio tenta
utilizar a mesma senha em todos os arquivos protegidos.
Se a senha falhar com algum arquivo, esta é solicitada
novamente
Fechar Todos os Arquivos Fecha todos os arquivos de projeto e de biblioteca de

um Domínio. Se algum arquivo tem alterações não salvas,
pergunta ao usuário se deseja salvá-las
Editar a Ordem de Ativação Permite editar a ordem de ativação dos objetos de

Servidor em um Domínio, conforme mostrado na figura a
seguir
Extrair Bibliotecas Permite extrair as bibliotecas contidas em um pacote de

bibliotecas, ou seja, um arquivo com a extensão .e3pkg
NOTA
As opções da tabela anterior também estão disponíveis utilizando o atalho de teclado SHIFT + F10, que corresponde
à tecla de aplicação ou de menu .
Janela Ordem de Ativação do Domínio
2.7 Importação e Exportação

A ferramenta de importação de objetos do Elipse Power tem como objetivo ler as informações sobre os objetos de
um arquivo CSV (Comma-Separated Values) e recriá-los no ambiente de configuração (Elipse Power Studio). Para cada
objeto é possível obter informações sobre propriedades, Associações e itens de coleções.
A ferramenta de exportação de objetos do Elipse Power tem como objetivo gravar informações sobre os objetos
selecionados a partir do ambiente de configuração (Elipse Power Studio) em um arquivo CSV. Para cada objeto
podem ser gravadas suas propriedades, Associações e itens de coleções. É possível, portanto:
· Criar novos objetos do Elipse Power a partir do arquivo CSV, desde que estes não sejam diretamente objetos
filhos do projeto ou biblioteca
· Importar ou exportar qualquer propriedade de qualquer tipo de objeto do Elipse Power

· Importar ou exportar qualquer tipo de Associação de objetos do Elipse Power
· Exportar qualquer tipo de coleção de objetos do Elipse Power e importar suas propriedades
· Importar ou exportar qualquer tipo de item da coleção de objetos do Elipse Power
Qualquer objeto do Elipse Power pode ser importado ou exportado. O objeto selecionado para a operação é
chamado de objeto raiz. Com isto, é possível importar ou exportar, por exemplo, uma Pasta de Dados com XObjects
definidos pelo usuário, ou mesmo exportar uma Tela, listando todos os objetos filhos.
Além dos objetos, as Associações e as coleções também podem ser importadas e exportadas. O usuário tem a opção
de informar se quer importar ou exportar Associações e coleções ou não.
NOTA
A ferramenta de importação e exportação considera apenas as propriedades e Associações dos objetos e coleções
do Elipse Power. Informações que não estejam descritas em propriedades não são importadas ou exportadas. Este
é o caso, por exemplo, de scripts e configurações internas dos objetos de Tela.
2.7.1 Arquivo CSV

Um arquivo CSV (Comma Separated Values) é um arquivo texto baseado em colunas separadas por vírgula, ou por
outro separador previamente definido. No Elipse Power, estes arquivos contêm as informações sobre os objetos que
foram exportados, e são utilizados na importação para que estes objetos sejam criados corretamente no Elipse
Power Studio. Cada coluna do arquivo CSV representa uma ou mais propriedades de objetos do Elipse Power. Cada
linha do arquivo representa um objeto, Associação ou item de coleção. Para que estes arquivos sejam utilizados
corretamente, é preciso observar alguns detalhes:
· A primeira linha do arquivo CSV deve conter um cabeçalho que identifica as colunas corretamente
· O cabeçalho deve ter obrigatoriamente uma coluna que identifica o tipo do objeto que está sendo importado ou
exportado. Esta coluna chama-se ObjectType. O valor desta coluna é o nome da classe do objeto (XObject1,
DrawRect, InternalTag, AgSimple, etc.), com exceção das coleções, que apresentam palavras-chave pré-definidas
(ITableBindRow, IAxis, etc.)
· O cabeçalho das demais colunas deve ser o próprio nome da propriedade em questão
· As colunas podem ser colocadas em qualquer ordem no arquivo; pode haver colunas a mais ou a menos, sem
prejuízo da operação de importação ou exportação. A única coluna obrigatória é ObjectType, porque sem ela
não é possível identificar o tipo de objeto que deve ser criado
2.7.1.1 Criando um Arquivo CSV Manualmente

É possível criar um arquivo com extensão .csv a partir do Bloco de Notas, do Excel ou de outra aplicação do Windows.
O arquivo é criado considerando o separador de elementos configurado no Windows (na configuração por usuário,
não do sistema).
A primeira linha do arquivo deve conter um cabeçalho com os nomes das colunas desejadas. Cada coluna deve ser
uma propriedade ou um identificador definido no modelo, conforme é visto a seguir. Nas linhas devem ser colocados
os objetos, e os valores das propriedades nas colunas correspondentes. Não é necessário que todas as propriedades
dos objetos sejam listadas no cabeçalho, bem como podem existir colunas que não estejam associadas a
propriedades de um determinado objeto.
É importante também que o arquivo CSV tenha uma coluna para a propriedade Name. Sem esta coluna, não é
possível determinar exatamente onde o objeto em questão deve ser criado. Os nomes mostram a hierarquia correta
do objeto, e nomes com caracteres especiais devem ser delimitados por colchetes. Caso o nome do objeto comece
com números, este nome também deve ser delimitado por colchetes.
A seguir, um exemplo de um arquivo CSV que pode ser criado manualmente no Excel.
1. Abra o Excel e configure o cabeçalho com os campos, um em cada coluna, conforme a figura a seguir.

Arquivo CSV visualizado no Excel
2. Salve a planilha com a extensão .csv.
3. Feche o arquivo no Excel.
4. Para importar este arquivo no Elipse Power, selecione um objeto IODriver e importe o arquivo criado através da
opção Importar, selecionando o modelo adequado. O Elipse Power cria a estrutura de acordo com o arquivo
CSV.
2.7.2 Objetos
A importação ou a exportação de objetos no Elipse Power pode ser feita a partir de qualquer tipo de objeto, exceto
projetos e bibliotecas. A operação a partir do objeto raiz é feita sobre suas propriedades e seus objetos filhos. Para
exportar objetos, siga estes procedimentos:
1. Clique com o botão direito do mouse no objeto desejado e selecione a opção Exportar.
2. Na caixa de diálogo, selecione o arquivo CSV desejado e clique em Salvar.

Janela para exportação de objetos
Na exportação, todas as propriedades, Associações, coleções e itens de coleções do objeto selecionado e de seus
filhos são automaticamente exportadas. É gerado um arquivo CSV com uma linha para cada objeto exportado, bem
como para cada Associação, coleção ou item de coleção existente nestes objetos. Para cada propriedade é criada
uma coluna no arquivo, onde é informado o valor da propriedade para cada objeto.
O objeto selecionado, chamado de objeto raiz, é exportado com a coluna da propriedade Name em branco. Nos
demais casos, esta coluna contém a hierarquia com nomes separados por pontos. A figura a seguir contém um
exemplo de exportação a partir de um objeto IODriver.
Hierarquia do objeto Driver1

ObjectType;Name;Prop1;Prop2;Prop3
IODriver;;0;True;0
IOBlock;Bloco1;0;False;0

IOBlockElement;Bloco1.Elemento1;0;False;0
IOBlock;Bloco2;0;False;0
IOTag;Tag1,0,True,0
Se desejar, o usuário pode configurar a exportação de objetos através do uso de modelos, que são apresentados no
tópico Modelos. Utilizando um modelo é possível configurar se as Associações, coleções e itens de coleções são ou
não exportados, se o objeto raiz é exportado ou não e quais as propriedades de cada objeto devem ser exportadas,
entre outras configurações. Para isto, siga estes procedimentos:
1. Clique com o botão direito do mouse no objeto desejado e selecione a opção Exportar.
2. Clique em Avançado para configurar ou selecionar um modelo.
3. Na caixa de diálogo, selecione o arquivo CSV desejado e clique em Salvar.
Para importar objetos, siga estes procedimentos:

1. Clique com o botão direito do mouse no objeto desejado e selecione a opção Importar.
2. Na caixa de diálogo, selecione o arquivo CSV desejado e clique em Abrir.
Janela para importação de objetos

Na importação, para cada linha lida do arquivo CSV é identificado o objeto a ser criado. Apenas o filho mais ao final
da hierarquia pode ser criado. O restante do caminho deve existir. Por exemplo, no objeto Pasta1.Pasta2.Tag, apenas
Tag deve ser criado. Pasta1 e Pasta2 devem existir previamente. Assim, é permitido ter no arquivo apenas pastas,
sem filhos. O arquivo pode ter linhas como a seguir:
ObjectType;Name
IOFolder;Pasta1
As linhas em branco, as linhas onde não é encontrado um identificador de tipo válido, as colunas em branco e as
colunas que tenham nomes inválidos de propriedades são ignoradas, sem gerar erro.

2.7.3 Modelos
Os Modelos são arquivos INI utilizados para configurar a ferramenta de importação e exportação, informando, por
exemplo, qual separador deve ser utilizado no arquivo CSV, se as Associações dos objetos devem ou não ser
exportadas, etc. Os arquivos INI têm o seguinte formato:
· Linhas iniciadas por ponto e vírgula são comentários, desconsiderados na interpretação do arquivo
· O arquivo é organizado em seções, e cada seção contém uma ou mais variáveis. As seções são identificadas por
nomes entre colchetes. As variáveis são as palavras antes do símbolo de igualdade. Uma seção não pode conter
duas variáveis com o mesmo nome
· Linhas em branco são ignoradas
Um exemplo de arquivo INI é mostrado a seguir.

; Primeira seção
[SECAO1]
Var1 = 0
Var2 = 1
; Segunda seção
[SECAO2]
Var1 = TRUE
Var3 = FALSE
O formato é um texto facilmente modificável pelo usuário, sendo possível gerar um modelo novo utilizando um editor
de textos comum. O mesmo modelo pode ser utilizado tanto para a importação como para a exportação de objetos.
Os modelos utilizados no Elipse Power permitem que o usuário redefina valores para nomes das colunas do arquivo
CSV, bem como para os tipos de objetos. Além disto, também permitem que o usuário agrupe mais de uma
propriedade em uma mesma coluna. Isto tudo é feito através da definição de identificadores, que são palavras-chave
utilizadas no arquivo CSV e associadas à propriedades ou classes de objetos no arquivo INI.
No Elipse Power, os modelos da ferramenta de importação e exportação estão definidos com as seções e variáveis
descritas na tabela a seguir.
Seções definidas para os Modelos
SEÇÃO DESCRIÇÃO
Header Define os identificadores permitidos para nomes de
colunas e tipos de dados. Nesta seção devem ser
definidas as variáveis header e types. NOTA: Esta seção
é obrigatória para a exportação
Configuration Define configurações adicionais para a ferramenta de

importação e exportação. Nesta seção devem ser
definidas as variáveis separator, root, link, collection,
objectduplicated e bindduplicated
Types Relaciona os identificadores de tipos de dados com as

classes de objetos reais. Cada identificador listado na
variável types que não for igual a um nome de classe de
objeto deve estar documentado nesta seção, sendo
criada uma variável para cada um dos identificadores
Columns Relaciona os identificadores de nomes de colunas com

os nomes de propriedades. Cada identificador listado na
variável header que não for igual a um nome de
propriedade deve estar documentado nesta seção,
sendo criada uma variável para cada um dos
identificadores
Filter Define quais as classes de objetos que devem ou não ser

importadas ou exportadas. Nesta seção deve ser
definida uma das duas variáveis, include ou exclude. Se
ambas forem definidas, apenas include é considerada

Variáveis definidas para os Modelos
SEÇÃO DESCRIÇÃO
header Define a ordem das colunas e os identificadores que são
utilizados. Devem ser listadas todas as colunas que o
arquivo CSV tem, separadas por vírgulas. Cada
identificador que não for igual a um nome de
propriedade deve ser discriminado na seção Columns,
cada um com uma variável. NOTA: Esta variável é
obrigatória para a exportação
types Define os identificadores para os tipos de dados

permitidos no arquivo CSV. Os identificadores devem ser
listados nesta variável separados por vírgulas. Só é
necessário definir esta variável se algum identificador for
diferente do nome da classe do objeto. Neste caso, para
cada um dos identificadores deve haver também uma
variável na seção Types
separator Define o separador que é utilizado para delimitar as

colunas no arquivo CSV. Caso esta variável não seja
definida, é utilizado o separador de listas configurado no
Windows
root Define se o objeto raiz é exportado ou importado junto

com os objetos filhos. Caso esta variável não seja
definida, o objeto raiz é utilizado
link Define se as Associações dos objetos são exportadas ou

importadas. Caso esta variável não seja definida, as
Associações são utilizadas
collection Define se as coleções dos objetos são exportadas ou

importadas. Caso esta variável não seja definida, as
coleções são utilizadas
objectduplicated Define o que fazer quando um objeto pré-existente

estiver sendo importado. Os valores possíveis para esta
variável são 0 - askalways: Sempre questiona o usuário
sobre qual ação executar, 1 - changealways: Sempre
altera as propriedades do objeto existente, 2 -
ignorealways: Sempre ignora o objeto sendo importado
ou 3 - createalways: Sempre cria um objeto novo,
autoincrementando o nome. Caso esta variável não seja
definida, assume-se o valor askalways. Esta opção não
tem valor na exportação
bindduplicated Define o que fazer quando uma Associação pré-existente

estiver sendo importada. Os valores possíveis para esta
substitui a Associação existente pela nova ou 2 -
ignorealways: Sempre ignora a Associação sendo
importada. Caso esta variável não seja definida, assume-
se o valor askalways. Esta opção não tem valor na
exportação, nem tampouco possui o valor createalways.
Neste caso, é sempre modificado para askalways

SEÇÃO DESCRIÇÃO
collectionduplicated Define o que fazer quando uma coleção pré-existente
estiver sendo importada. Os valores possíveis para esta
substitui a coleção existente pela nova ou 2 -
ignorealways: Sempre ignora a coleção sendo
importada. Caso esta variável não seja definida, assume-
se o valor askalways. Esta opção não tem valor na
exportação, nem tampouco possui o valor createalways.
Neste caso, é sempre modificado para askalways
itemduplicated Define o que fazer quando um item de coleção pré-

existente estiver sendo importado. Os valores possíveis
para esta variável são 0 - askalways: Sempre questiona o
usuário sobre qual ação executar, 1 - changealways:
Sempre altera as propriedades do item existente, 2 -
ignorealways: Sempre ignora o item sendo importado
ou 3 - createalways: Sempre cria um item novo,
autoincrementando o nome. Caso esta variável não seja
definida, assume-se o valor askalways. Esta opção não
tem valor na exportação
include Define quais classes de objetos devem ser importadas

ou exportadas. O filtro não é recursivo, ou seja, se for
incluída uma classe de um objeto que possa ter filhos,
estes filhos não são incluídos automaticamente. Não
pode ser usada junto com a variável exclude. Apenas o
que estiver definido nesta variável é exportado ou
importado
exclude Define quais classes de objetos não devem ser

importadas ou exportadas. O filtro não é recursivo, ou
seja, se for excluída uma classe de um objeto que possa
ter filhos, estes filhos não são excluídos
automaticamente. Não pode ser usada junto com a
variável include. Apenas o que estiver definido nesta
variável é desconsiderado na importação ou na
exportação
NOTA
O caractere de ponto e vírgula não pode ser utilizado como nome ou parte do nome da coluna, nem tampouco
como nome ou parte do nome do identificador de tipo. Esta limitação se deve ao fato de este caractere definir um
comentário no arquivo INI. Desta forma, a variável criada na seção Columns ou na seção Types para definir o
identificador que possui o ponto e vírgula não pode ser lida corretamente.
Exemplo:
[Header]
header = ObjectType,Name,DocString,N1/B1,N2/B2,N3/B3,N4/B4,Scan,AllowRead,AllowWrite
types = Tag,Bloco,Elemento
[Configuration]
separator = ','
root = true
link = true
collection = true
objectduplicated = askalways
bindduplicated = askalways
collectionduplicated = askalways
itemduplicated = askalways
[Types]
Tag = IOTag

Bloco = IOBlock
Elemento = IOBlockElement
[Columns]
N1/B1 = N1,B1
N2/B2 = N2,B2
N3/B3 = N3,B3
N4/B4 = N4,B4
[Filter]
exclude = IOFolder
A Elipse Software fornece alguns modelos para importação e exportação de alguns tipos de objetos. Estes modelos
também podem ser utilizados como base para a criação de outros. Os modelos fornecidos estão na pasta Templates
da instalação do Elipse Power.
NOTA
Na importação, as colunas utilizadas são lidas diretamente do arquivo CSV. Neste caso específico, não é necessária a
variável header no modelo. Porém, se alguma coluna for nomeada por um identificador, este deve estar definido na
seção Columns ou a coluna é ignorada.
2.7.4 Gerenciador de Modelos

O Gerenciador de Modelos é uma ferramenta para auxiliar o usuário na criação de um arquivo INI para ser utilizado
na importação ou exportação de objetos do Elipse Power. Para acessá-lo, clique na opção Importar ou Exportar e,
uma vez aberta a janela da opção, clique em Avançado. Caso o usuário já tenha carregado um modelo, os valores
iniciais das opções nas abas da janela estão de acordo com o que foi previamente configurado. As abas disponíveis
estão descritas a seguir.
A aba Configurações permite configurar as opções válidas tanto para a importação quanto para a exportação.

Aba Configurações
Opções disponíveis na aba Configurações
OPÇÃO DESCRIÇÃO
Separador de colunas As opções disponíveis são: Usar o separador de listas
do Windows (escolhe o caractere definido no Windows
como separador de listas para ser usado como
separador de colunas do arquivo CSV) ou Usar outro
caractere como separador (escolhe outro caractere
definido pelo usuário como separador de colunas)
Outras opções Define o que é importado ou exportado: objetos,

Associações ou coleções. As opções disponíveis são:
Importar/exportar o objeto raiz, Importar/exportar
associações ou Importar/exportar coleções
Salvar modelo Quando a opção Salvar as alterações deste modelo em

um arquivo INI for marcada, é definido o arquivo INI
onde as alterações do modelo são salvas, e este arquivo
pode ser reutilizado. Quando for desmarcada, as
configurações feitas são salvas temporariamente em um
arquivo na pasta de arquivos temporários do Windows.
Este arquivo é utilizado para a importação ou exportação
realizada logo após a configuração, e é removido
posteriormente

A aba Importação permite configurar as opções válidas somente para a importação.
Aba Importação
Opções disponíveis na aba Importação
OPÇÃO DESCRIÇÃO
Importação de objetos duplicados Especifica como o Elipse Power deve lidar com a
ocorrência de objetos duplicados na importação. As
opções disponíveis são Questionar sobre o que fazer
em cada caso, Sempre sobrescrever o objeto existente,
Sempre ignorar o objeto duplicado ou Sempre criar
um novo objeto
Importação de associações duplicadas Especifica como o Elipse Power deve lidar com a
ocorrência de Associações duplicadas na importação. As
em cada caso, Sempre sobrescrever a associação
existente ou Sempre ignorar a associação duplicada
Importação de coleções duplicadas Especifica como o Elipse Power deve lidar com a
ocorrência de coleções duplicadas na importação. As
em cada caso, Sempre sobrescrever a coleção existente
ou Sempre ignorar a coleção duplicada

OPÇÃO DESCRIÇÃO
Importação de itens de coleção duplicados Especifica como o Elipse Power deve lidar com a
ocorrência de itens de coleção duplicados na
importação. As opções disponíveis são Questionar
sobre o que fazer em cada caso, Sempre sobrescrever
o item existente, Sempre ignorar o item duplicado ou
Sempre criar um novo item
A aba Filtros permite selecionar quais classes são utilizadas na importação ou na exportação, ou quais classes não se
deseja utilizar.
Aba Filtros
Opções disponíveis na aba Filtros
OPÇÃO DESCRIÇÃO
Não filtrar objetos Define a importação ou a exportação de todos os
objetos
Incluir apenas estes objetos Define quais classes de objetos são importadas ou
exportadas
Excluir apenas estes objetos Define quais classes de objetos não são importadas ou
exportadas
Alterar Abre uma janela para seleção das classes de objetos a

serem incluídas ou excluídas

OPÇÃO DESCRIÇÃO
Ajuda Abre uma janela de ajuda para a opção
Clicando em Alterar, abre-se uma janela para a escolha de classes, mostrada na figura a seguir.
Janela Classes de Objetos

As classes que preenchem inicialmente a lista são as do objeto raiz e seus filhos, caso um novo modelo esteja sendo
criado. O usuário pode adicionar outras, clicando em , ou remover alguma classe, clicando em .
A aba Identificadores define os identificadores para as classes de objetos selecionadas. O estado inicial desta lista é
vazio.
Aba Identificadores

Opções disponíveis na aba Identificadores
OPÇÃO DESCRIÇÃO
Nome da Classe Indica o nome da classe selecionada na opção
Identificador Permite ao usuário alterar o valor a ser utilizado na

coluna ObjectType do arquivo CSV. O valor inicial nesta
coluna é sempre o nome da classe do objeto. Para cada
valor alterado aqui, é criada uma entrada no arquivo INI
na seção Types. Os valores não são sensíveis à caixa
(isto é, "AAA", "aaa" e "aAa" são o mesmo valor). Caso o
usuário defina valores iguais para mais de um tipo,
apenas o primeiro tipo é considerado na importação, e
algum objeto pode ser criado com o tipo errado
Adicionar Adiciona classes de objetos
Remover Remove a classe de objetos selecionada
Ajuda Apresenta uma janela com texto de ajuda
A aba Propriedades permite selecionar quais propriedades dos objetos se deseja utilizar na importação ou na
exportação. O valor inicial da lista é ObjectType e as demais propriedades devem ser adicionadas manualmente pelo
usuário.
Aba Propriedades

Opções disponíveis na aba Propriedades
OPÇÃO DESCRIÇÃO
Nome da coluna Permite ao usuário alterar o valor a ser utilizado como
nome da coluna no cabeçalho do arquivo CSV. O valor
inicial desta coluna é sempre o próprio nome da
propriedade do objeto. Para cada valor alterado nesta
coluna, é criada uma entrada no arquivo INI na seção
Columns. Os nomes das colunas não são sensíveis à
caixa, isto é, "AAA", "aaa" e "aAa" são o mesmo valor.
Caso o usuário defina nomes de colunas iguais para
mais de uma propriedade, apenas uma delas é
identificada corretamente, e todas as colunas com o
mesmo nome são relacionadas à mesma propriedade.
Neste caso, algum valor pode ser sobrescrito
Propriedade Indica a propriedade sendo importada ou exportada

Para cima e Para baixo Redefinem a ordem das colunas ao alterar a ordem das
propriedades na lista
Adicionar Adiciona propriedades à lista
Remover Exclui propriedades da lista, com exceção de
ObjectType. Alternativamente, pode-se utilizar a tecla
DELETE para excluir uma propriedade
Nome da coluna Cria um nome de coluna associado a mais de uma
propriedade. Selecione as propriedades que deseja
agrupar e clique nesta opção. Os nomes das
propriedades são agrupados em uma mesma linha,
utilizando o nome da coluna definido para a
propriedade que está no topo da lista
Ajuda Mostra uma janela com um texto de ajuda
Ao clicar em , abre-se uma janela para a seleção de propriedades, mostrada na figura a seguir.
Janela Propriedades

Opções disponíveis na janela Propriedades
OPÇÃO DESCRIÇÃO
Classes de objetos Apresenta as classes de objetos que se enquadram no
filtro escolhido a partir do objeto raiz
Adicionar todas as propriedades Adiciona todas as propriedades do tipo de objeto

selecionado na opção anterior
Listar todas as classes de objetos do Elipse Power Se esta opção for selecionada, a caixa de seleção de
objetos mostra todas as classes existentes no Elipse
Power, independente de filtro ou objeto raiz
Propriedades Mostra as propriedades do objeto selecionado
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 não na
lista. Se a propriedade havia sido agrupada com outras, o duplo-clique remove apenas esta propriedade do
agrupamento, mantendo as outras propriedades agrupadas corretamente.
As propriedades do tipo TextFont possuem propriedades internas que configuram separadamente tipo, tamanho e
outras características da fonte. Elas são exportadas com o nome da propriedade principal (de acordo com o objeto),
seguido do nome da propriedade interna, separados por um ponto (por exemplo, TextFont.Bold). No configurador
de modelos, as propriedades internas aparecem separadas para o usuário, para que a escolha possa ser feita
isoladamente.
Propriedades do Tipo TextFont
2.7.5 Importação de Objetos do Elipse SCADA para o Elipse Power

A partir da versão 2.29 do Elipse SCADA foram desenvolvidas funcionalidades que facilitam a exportação de Tags,
alarmes e alguns objetos de Tela do Elipse SCADA, e a importação destes no Elipse Power.
2.7.5.1 Configuração de Alarmes

A exportação da Configuração de Alarmes é realizada automaticamente ao exportar os Tags, seguindo os passos
descritos anteriormente. Além do arquivo com os Tags, é gerado um arquivo com o mesmo nome acrescido do sufixo
_Alarms. Por exemplo, se o nome escolhido é "TagsInternos", são gerados os arquivos TagsInternos.e2f e
TagsInternos_Alarms.e2f. Este segundo arquivo com o prefixo _Alarms contém a configuração dos alarmes dos Tags
exportados. Para importar estes alarmes no Elipse Power, siga estes passos:
1. No Organizer, insira uma nova Configuração de Alarmes, e insira uma Área.
2. Clique com o botão direito do mouse na Área e selecione a opção Importar.
3. Se a importação foi realizada com sucesso, os alarmes devem aparecer sem nenhuma mensagem de erro. Caso
os Tags correspondentes já tenham sido importados, todas as referências devem aparecer na cor azul.

2.7.5.2 Configuração e Tags de Servidores OPC
1. No Organizer do Elipse SCADA, selecione o item OPCServers e clique no Driver OPC desejado.
2. Clique em Exportar.
Exportação de Configurações e Tags de Servidores OPC

3. Selecione o local e o nome do arquivo a ser gerado. Além do arquivo com as configurações dos Tags OPC, é
gerado um arquivo com o mesmo nome seguido do sufixo _Alarms. Este arquivo é utilizado posteriormente na
importação da configuração de alarmes no Elipse Power.
Para executar a importação dos Tags OPC no Elipse Power, siga estes passos:
1. No Organizer, insira um novo Driver de Comunicação OPC.
2. Renomeie o Driver de Comunicação OPC para o mesmo nome do Driver OPC utilizado na aplicação Elipse SCADA,
para que posteriormente as referências para os Tags deste Driver OPC sejam importadas corretamente.
3. Clique com o botão direito do mouse no Driver OPC e selecione a opção Importar.
4. Na lista de tipos de arquivos, selecione a opção Arquivos do Elipse SCADA (*.e2f), e a seguir selecione o arquivo
exportado anteriormente, sem o sufixo _Alarms. Não é necessário selecionar um modelo.
2.7.5.3 Tags de Comunicação (PLC e Bloco)

Os Tags de Comunicação do Elipse SCADA são exportados separadamente para cada Driver. Para executar a
exportação, abra a aplicação no Elipse SCADA e siga estes procedimentos:
1. No Organizer do Elipse SCADA, selecione o item Drivers e clique no Driver desejado.

Exportação de Drivers
3. Selecione o local e o nome do arquivo a ser gerado. Além do arquivo com as configurações dos Tags, é gerado
um arquivo com o mesmo nome, seguido do sufixo _Alarms. Este arquivo é utilizado posteriormente na
Para executar a importação dos Tags no Elipse Power, siga estes passos:
1. Insira um Driver de Comunicação no Organizer.
2. Renomeie o Driver para o mesmo nome do Driver utilizado na aplicação Elipse SCADA, para que posteriormente
as referências para os Tags deste Driver sejam importadas corretamente.
3. Clique com o botão direito do mouse no Driver de Comunicação e selecione o item Importar.

Janela de importação de Tags do SCADA
2.7.5.4 Tags RAM e Demo

Para exportar os Tags RAM e Demo, siga estes passos:
1. No Organizer do Elipse SCADA, selecione o item Tags.

Exportação de Tags RAM e Demo
3. Selecione o local e o nome do arquivo a ser gerado. Além do arquivo com as configurações dos Tags, é gerado
um arquivo com o mesmo nome seguido do sufixo _Alarms. Este arquivo é utilizado posteriormente na
Para executar a importação dos Tags no Elipse Power, siga estes passos:
1. Insira um Servidor de Dados no Organizer.
2. Renomeie o Servidor de Dados para Dados, para que posteriormente as Associações dos objetos de Tela sejam
importadas corretamente.
3. Clique com o botão direito do mouse no Servidor de Dados e selecione a opção Importar.
2.7.5.5 Telas
A exportação de Telas do Elipse SCADA é parcial e suporta apenas um subconjunto dos objetos de Tela. Para
exportar uma Tela, siga estes passos:
1. No Organizer do Elipse SCADA, selecione o item Telas e clique na Tela desejada.

Exportação de Telas
3. Selecione o local e o nome do arquivo a ser gerado.
4. No Organizer, insira uma nova Tela.
5. Clique com o botão direito do mouse na Tela e selecione a opção Importar.
exportado anteriormente. Não é necessário selecionar um modelo.
Se a importação é realizada com sucesso, a Tela é preenchida com os objetos, e nenhuma mensagem de erro é
mostrada. Os arquivos de imagens utilizados pela Tela devem ser tratados conforme um dos casos a seguir:
· Arquivos de imagens com caminhos relativos na aplicação Elipse SCADA: Estes arquivos devem ser inseridos
manualmente como Recursos no projeto do Elipse Power. É possível inserir vários arquivos de uma vez, clicando
com o botão direito do mouse no item Recursos do Organizer e selecionando a opção Inserir recurso em
· Arquivos de imagens com caminhos absolutos: Estes arquivos devem permanecer nos seus diretórios originais.
O Elipse Power os procura no mesmo diretório onde são encontrados pela aplicação do Elipse SCADA
NOTA
É recomendado inserir todos os arquivos no projeto como Recursos, para que o Elipse Power Viewer possa
executar o download automaticamente pela rede. Isto evita a necessidade de instalar os arquivos manualmente nas
máquinas cliente.
2.7.6 Associações
Para a importação ou a exportação de Associações no Elipse Power, deve ser selecionada a opção correspondente
no modelo. Não há como excluir apenas um ou outro tipo de Associação. Ou todas são importadas ou exportadas ou
nenhuma.
Cada Associação ocupa uma linha no arquivo CSV. A identificação das Associações é realizada através das seguintes
palavras-chave:
· AgSimple: Associações Simples, Bidirecionais ou Reversas (estas devem ser diferenciadas pelas propriedades
Reverse e Bidirectional)

· AnalogBind: Associações Analógicas
· AnimationBind: Associações Digitais
· TableBind: Associações por Tabela
As propriedades ou os campos das Associações são importados ou exportados como se fossem propriedades de
objetos, com uma coluna no arquivo CSV para cada uma delas. Todas as Associações possuem as propriedades
Source e Property e, além delas, as propriedades existentes para cada Associação são as seguintes:
· AgSimple: Reverse, Bidirectional
· AnalogBind: SrcHiValue, SrcLoValue, DstHiValue, DstLoValue
· AnimationBind: BlinkOn, BlinkOff, OnValue, OffValue, BlinkOnValue, BlinkOffValue
A criação de linhas da tabela respeita o índice informado pelo usuário. Se o índice não é um número, é mostrada uma
mensagem de erro (nome inválido). Se é um índice inexistente (por exemplo, só existem duas linhas na tabela e o
usuário quer inserir a linha cinco), as linhas que faltam são criadas com os valores padrão.
Todas as Associações são importadas ou exportadas, independente da seleção de propriedades que o usuário tenha
realizado. Se uma Associação para determinada propriedade já existir, o usuário é questionado sobre o que fazer.
Caso contrário, elas são criadas.
Importação de uma Associação pré-existente

No nome do objeto deve ser informado o caminho completo, no formato Objeto.Links.Nome. Exemplo:
'Links indica que é uma Associação
'e Value é a propriedade que possui a Associação
Texto1.Links.Value
2.7.7 Coleções e seus Itens

Para a importação ou a exportação de coleções no Elipse Power, deve ser selecionada a opção correspondente no
modelo. Não há como excluir apenas uma ou outra coleção. Ou todas são importadas ou exportadas ou nenhuma.
As colunas de cada coleção dependem das propriedades que esta coleção possui. O tratamento é realizado da
mesma forma que nas colunas das propriedades dos objetos.
No caso de coleções e itens de coleção, as propriedades precisam ser incluídas no arquivo INI manualmente. Não é
possível selecionar estas propriedades através do Configurador de Modelos.
As coleções podem ser importadas e suas propriedades, atualizadas. Como as coleções sempre existem, e não é
possível criar outra coleção do mesmo tipo, o usuário é questionado se deseja ignorar ou sobrescrever a coleção
existente.
Se o item de coleção que está sendo importado já existir, o usuário é questionado se deseja ignorá-lo, sobrescrevê-lo
ou criar um novo. Caso o usuário selecione esta última opção:
· No caso de Penas e Eixos, o nome é autoincrementado corretamente
· No caso de linhas da Associação por Tabela, estas são criadas sempre ao final desta
· No caso de colunas da Legenda, é mostrada uma mensagem de erro informando que o nome não é válido, ou
que já existe a coluna e o nome não pode ser autoincrementado (as colunas da Legenda têm nomes pré-
definidos e não é possível criar colunas com outros nomes)
No nome do objeto deve ser informado o caminho completo, no formato Objeto.Collection.Name. Exemplo:
E3Chart1.Pens.Pena1

Na coluna de tipo deve aparecer uma das seguintes palavras-chave:
· IDispChartPen: Penas do E3Chart
· ILegendColumn: Legendas do E3Chart
· IAxis: Eixos do E3Chart
· ITableBindRow: Linhas das Associações por Tabela
2.7.8 Logs e Relatórios de Falhas

Durante o processo de importação ou exportação, é gerado um arquivo de log contendo os erros ocorridos e
algumas outras considerações relevantes, caso a seção de log ImportExport esteja habilitada. Para habilitar esta
seção, consulte o capítulo Configurações Avançadas.
Ao final da operação, há uma opção para visualizar um relatório de falhas na importação. Neste relatório constam
falhas que provavelmente são erros no arquivo CSV, como por exemplo objetos inexistentes.
Relatório de falhas na importação
2.8 Lista de Propriedades

A Lista de Propriedades é uma janela de configuração das propriedades do objeto selecionado.
O título da Lista de Propriedades mostra sempre o nome do objeto selecionado no momento. Para que esta janela
esteja visível no projeto, é necessário que a opção Lista de Propriedades esteja selecionada no menu Visualizar. A
figura a seguir mostra a Lista de Propriedades de um objeto Elemento de Bloco de Comunicação com suas
propriedades ordenadas alfabeticamente.

Lista de Propriedades ordenada alfabeticamente
A Lista de Propriedades da figura a seguir mostra o objeto anterior com suas propriedades ordenadas por categoria.
Lista de Propriedades ordenada por categoria

NOTA
No caso de seleção múltipla de objetos, a Lista de Propriedades mostra apenas as propriedades comuns aos
objetos selecionados, com seus valores correspondendo ao último objeto selecionado. O mesmo critério é utilizado
se a Lista de Propriedades está ordenada por categoria, ou seja, as categorias mostradas correspondem às do
último objeto selecionado.
O rodapé da Lista de Propriedades mostra uma descrição rápida da propriedade selecionada. As opções disponíveis
nesta janela estão descritas na tabela a seguir.
Opções disponíveis na Lista de Propriedades
OPÇÃO DESCRIÇÃO
Ordenar por Categoria Mostra as propriedades do objeto selecionado
organizadas por categorias
Ordenar Alfabeticamente Mostra as propriedades do objeto selecionado

organizadas alfabeticamente
Procurar Permite filtrar a listagem pelo nome ou parte do nome

da propriedade
Pode-se configurar o valor de uma propriedade digitando diretamente na sua respectiva coluna Valor. À direita do
nome da propriedade existe um ícone que indica o seu estado atual. O ícone indica que o valor da propriedade é o
padrão, ou seja, seu valor não foi modificado pelo usuário, e o ícone indica que o valor da propriedade foi
modificado pelo usuário (o valor modificado aparece em negrito). Além disto, clicar neste ícone abre um menu
contextual com as opções descritas na tabela a seguir.
Opções disponíveis no menu contextual de uma propriedade
OPÇÃO DESCRIÇÃO
Resetar Reverte o valor da propriedade selecionada para seu
valor padrão, caso tenha sido modificado pelo usuário
Copiar Copia o valor da propriedade selecionada para a Área

de Transferência
Colar Cola o valor da Área de Transferência no valor da

propriedade selecionada
Editar Permite editar o valor da propriedade selecionada
NOTA
As opções do menu contextual de uma propriedade podem estar habilitadas ou desabilitadas, dependendo do tipo
de dados da propriedade.
2.9 Galeria
Coleção de objetos gráficos que podem ser arrastados e inseridos nas Telas das aplicações. Estes objetos são
arquivos do tipo Metafiles (WMF, ou Windows MetaFile).

Galeria
2.10 AppBrowser
O AppBrowser é uma ferramenta que auxilia o usuário a montar a aplicação informando uma expressão lógica, uma
Associação ou um valor para a propriedade sendo manipulada, de acordo com o objeto selecionado. Assim, é
possível minimizar erros durante a criação da aplicação.
AppBrowser
No quadro à esquerda são mostrados os objetos do Elipse Power que podem ser utilizados para compor o texto
que é o resultado do uso do AppBrowser. De acordo com seu contexto de utilização, alguns objetos não podem ser
utilizados e nem são mostrados aqui.
No quadro central são mostradas as propriedades e os métodos do objeto selecionado, e no quadro à direita o
texto de ajuda da propriedade ou do método selecionado.
Mais abaixo é mostrado o texto resultante do AppBrowser, ao lado das opções Colar e Cancelar. Clique em Colar
para aceitar o resultado e copiar o valor para o local desejado ou clique em Cancelar para ignorá-lo.

NOTAS
· Ao selecionar Tags, o AppBrowser é sempre aberto na última posição, e não na posição apontada pelo link atual.
· O AppBrowser possui a função de Auto Complete, ou seja, digite o nome de um objeto para selecioná-lo
automaticamente.
· Caso um objeto no quadro à esquerda esteja inativo, clique duas vezes no objeto ou pressione a barra de espaço
do teclado para ativá-lo.
Pode-se utilizar o AppBrowser através de scripts, de Associações ou de algumas propriedades de objetos que
possuem como valor um outro nome de objeto. Cada uma destas formas é abordada nos tópicos seguintes.
2.10.1 Acesso via Script

Para utilizar o AppBrowser a partir de um script, abra o Editor de Scripts desejado e clique em na barra de
ferramentas da aba Scripts. Neste modo, os objetos estão separados conforme a figura a seguir.
AppBrowser via Scripts

O quadro à esquerda contém os seguintes itens:
· O primeiro item, mostrado isoladamente, é o Contexto. O objeto contexto é o que originou a chamada do
AppBrowser, ou seja, o dono do script
· O próximo item é a Hierarquia completa para se chegar ao objeto contexto, caso o contexto não esteja na raiz
do projeto. Este objeto pode ser expandido e o próprio objeto contexto pode ser visto nesta hierarquia
· Caso o contexto não seja um objeto do servidor, o item mostrado é o Viewer (objeto Application)
· O item Servidor lista todos os objetos do servidor que a aplicação possui. Caso este item seja o contexto atual,
ele contém a indicação de Application
· O item Tarefas mostra as tarefas mais comuns de serem executadas através de um script. As opções são Abrir
Tela, cujo resultado é uma expressão para abrir a Tela selecionada e que equivale ao Pick Abrir Tela, e Carregar
Relatório, cujo resultado é uma expressão para carregar um Relatório. Este item pode ou não ser mostrado,
dependendo se há Relatórios ou Telas no projeto
· O item VBScript mostra todas as funções da linguagem VBScript disponíveis para uso em scripts
· O item E3Globals mostra métodos de uso global do Elipse Power
De acordo com o objeto selecionado, o quadro central mostra suas propriedades e seus métodos.
2.10.2 Acesso via Associação

Para acessar o AppBrowser a partir de uma Associação, abra a Janela de Propriedades, selecione a aba Associações,
selecione a propriedade desejada e clique em à direita. O AppBrowser é aberto e os objetos são apresentados
conforme a figura a seguir.

AppBrowser via Associações
Neste caso, apenas as propriedades dos objetos são mostradas no quadro central da janela. Seus métodos não são
mostrados, pois não é permitido usá-los em Associações.
2.10.3 Acesso via Propriedade

Algumas propriedades permitem o uso do AppBrowser para auxiliar no preenchimento correto do valor esperado.
Estas propriedades, quando selecionadas, mostram um botão à direita do campo Valor da Lista de Propriedades.
Ao clicar neste botão o AppBrowser é aberto, mostrando apenas os objetos que podem ser usados como valor da
propriedade selecionada. As propriedades e métodos destes objetos são omitidos. É o caso, por exemplo, da
propriedade DBServer do objeto Fórmula. O AppBrowser mostra apenas os objetos do tipo Banco de Dados
existentes na aplicação.
AppBrowser via Propriedade

As propriedades que permitem o uso do AppBrowser são as seguintes:
· DBServer dos objetos Fórmula, Histórico e Storage
· DataSource do objeto Servidor de Alarmes
· InitialScreen do Viewer
· SplitLink do objeto Quadro

2.11 Conectar A
A opção Conectar A é utilizada para determinar a conexão do Elipse Power Studio a um servidor. Esta opção
permite configurar em qual servidor de Domínio o Elipse Power Studio deve se conectar, e permite também informar
se o Elipse Power Studio deve obter a licença do servidor onde executa o Domínio ou se deve obter a licença em um
outro servidor. Para utilizar este recurso, clique no menu Arquivo - Conectar A para abrir a caixa de diálogo
mostrada na figura a seguir.
Janela Conectar A
Opções disponíveis na janela Conectar A
OPÇÃO DESCRIÇÃO
Conectar ao servidor local Habilita a conexão com o servidor local
Conectar a um servidor na rede Habilita a conexão com um servidor da rede. Para isto,
selecione o servidor usando a caixa de seleção
Pegar licença no servidor de Domínio atual Usa uma licença do servidor onde o Domínio executa
Usar licença de um servidor específico Usa uma licença de outro servidor, que não o servidor
que está executando o Domínio
Se a conexão com qualquer dos dois servidores (Domínio ou de licença) cair, o Elipse Power Studio é desconectado
do outro servidor. A última configuração é guardada no Registro do Windows e, da próxima vez em que o Elipse
Power Studio é aberto, ele se conecta aos servidores de Domínio e de licenças utilizados da última vez.
Se o servidor de licenças não estiver disponível, ou se não houver mais licenças disponíveis, então o Elipse Power
Studio permanece em modo Demo. Um Elipse Power Studio sem licença (modo Demo) só pode se conectar a um
servidor de Domínio que também esteja em modo Demo.
Se o servidor de licenças é diferente do servidor de Domínio, o nome do servidor de licenças é mostrado no título da
janela do Elipse Power Studio, Licença no servidor local ou Licença em <Nome_Servidor>.
Se é especificado um servidor de licenças, a janela de licenças do E3 Server no servidor de Domínio mostra o nome
do servidor que está emprestando a licença para o Elipse Power Studio, SERVIDOR1 (licença emprestada de
SERVIDOR2). Neste caso a licença que está listada no servidor de Domínio não entra na contagem de licenças de
Elipse Power Studio em uso naquele servidor.
Se o servidor de Domínio não possuir uma licença, e um Elipse Power Studio se conectar a este servidor usando a
licença de outro, então o servidor de Domínio passa temporariamente de modo Demo para modo Elipse Power
Studio, voltando para modo Demo assim que a sessão do Elipse Power Studio é fechada.
NOTA
Quando o Elipse Power Studio estiver utilizando uma licença emprestada de outro servidor, este deve forçosamente
permanecer aberto enquanto a aplicação estiver em execução. Se é fechado enquanto a aplicação estiver
executando, a licença de Elipse Power Studio emprestada, que permite a execução da aplicação por seis horas, é
liberada, e o E3 Server finaliza a execução da aplicação em no máximo 10 segundos.

DICA
Quando o usuário conectar a um servidor, é importante que as aplicações sejam abertas através de um caminho na
rede. Ao invés de usar c:\projetos\projeto.dom, utilize o caminho \\server\projetos\projetos.dom. Desta forma, o
Elipse Power Studio e o E3 Server remoto podem acessar os arquivos utilizando o mesmo caminho.

CAPÍTULO
Domínios
3
Um Domínio é um conjunto de objetos e configurações que definem um sistema de supervisão. Corresponde ao
Aplicativo no Elipse SCADA.
O Elipse Power é um ambiente modular de desenvolvimento e execução de sistemas de supervisão, composto pelos
módulos descritos nas seções a seguir.
3.1 E3 Server
O E3 Server é o coordenador de todos os módulos do Elipse Power, sempre executa como serviço, mesmo no modo
Demo, seja registrado como serviço ou com o parâmetro /regserver, e deve estar sempre em execução. Pode
também ser iniciado quando um Elipse Power Studio local é iniciado, ou através de um atalho para executar o
Domínio, como por exemplo e3admin -start app.dom. O E3 Server é responsável por:
· Verificar e gerenciar licenças para uso dos diferentes módulos do Elipse Power
· Iniciar, parar ou monitorar o processo de tempo de execução (E3Run) do Domínio
· Abrir, editar ou manipular arquivos DOM
· Controlar o acesso de usuários aos objetos do Domínio
· Monitorar outros servidores do Domínio e implementar o Hot-Standby
O E3 Server pode trabalhar com apenas um arquivo de Domínio por vez, e este é chamado de Domínio aberto. Os
arquivos de Domínio só são manipulados pelo E3 Server.
3.1.1 Licenças
O E3 Server suporta dois modos de licença, Licença Ativa e Demo. O modo de licença é definido na inicialização do
servidor. Se há um dispositivo de proteção válido, do tipo Hardkey ou Softkey, o E3 Server entra em modo Licença
Ativa. Se nenhum dispositivo é localizado, entra em modo Demo.
Se houver a troca do dispositivo, o E3 Server compara as licenças deste novo dispositivo com as licenças do
dispositivo anterior e executa os seguintes ajustes:
· Se as novas licenças são exatamente iguais em limitações às do dispositivo anterior, são aplicadas
imediatamente
· Se as novas licenças são menos limitadas do que as do dispositivo anterior, também são aplicadas
imediatamente
· Se as novas licenças são mais limitadas do que as do dispositivo anterior, o E3 Server aguarda por duas horas
para que o dispositivo anterior seja reconectado. Ao final deste período, se as licenças continuarem restritivas, o
servidor é reiniciado e as novas licenças são aplicadas
NOTA
Para mais informações sobre licenças no Elipse Power, entre em contato com o setor comercial da Elipse Software.
3.2 E3Run
O E3Run é o processo responsável pela execução dos objetos do servidor, tais como Tags, Alarmes, Banco de Dados
e Históricos, entre outros, ou seja, todos os objetos exceto as Telas e o Elipse Power Viewer.
A execução do E3Run é indicada no ícone do E3 Admin na Área de Notificação do Windows, de acordo com a tabela
a seguir.
Opções disponíveis para ícones da Área de Notificação
OPÇÃO DESCRIÇÃO
Executando Uma seta verde é mostrada quando o Domínio está
carregado e executando
Carregado Um quadrado cinza indica que o Domínio está

carregado, mas não executando
Domínios 70
OPÇÃO DESCRIÇÃO
Iniciado Uma linha reta amarela giratória é mostrada quando o
Domínio está iniciando ou parado. Ocorre nos casos em
que o Domínio demora a começar a execução, como um
sinal de espera
Em Espera Barras amarelas são mostradas quando o Domínio está

em modo de espera
O E3Run sempre executa como serviço, seja registrado como serviço ou com o parâmetro /regserver. Este processo
usa o protocolo REC para se conectar à fila de banco de dados do E3 Server.
3.3 E3 Admin
O E3 Admin é o módulo responsável por monitorar e comandar o E3 Server. É simbolizado pelo ícone na Área de
Notificação do Windows. Este módulo é iniciado quando o usuário loga no Windows, ou quando o serviço do E3
Server é iniciado.
O E3 Admin também é responsável por tratar as opções de controle do Domínio via linha de comando, como por
exemplo e3admin <nome_do_dominio> [opções] ou e3admin [opções] <nome_do_dominio>. As opções de linha
de comando são listadas a seguir:
· -start ou /start: Inicia um Domínio informado pelo usuário. O uso desta opção não é obrigatório. Mesmo se esta
opção não é informada, o Domínio é iniciado
· -viewer ou /viewer: Executa o Elipse Power Viewer para a aplicação
· -load: Semelhante à opção -start, porém somente carrega o Domínio, sem executá-lo. Não pode ser usada com
a opção -viewer
· -stop: Para o Domínio em execução, quando existir. Esta opção deve ser utilizada sozinha
· -close: Para e fecha o Domínio em execução, quando existir. Esta opção deve ser utilizada sozinha
· -refresh: Força a atualização do Domínio sem a utilização de um Elipse Power Viewer
· -help: Mostra uma caixa de diálogo com as opções de linha de comando para o E3 Admin, conforme a figura a
seguir
Caixa de diálogo com as opções de linha de comando do E3

Admin
Se as opções -load, -start ou -viewer são utilizadas, o Windows 7 SP1 ou superior pode pedir autorização de
Administrador, processo também conhecido como elevação de privilégios, quando o E3 Admin não é iniciado por um
usuário Administrador do sistema, e dependendo da configuração do Controle de Conta de Usuário do Windows.
Caso o usuário logado não seja Administrador e a configuração do Controle de Conta do Usuário do Windows não
permita a janela de autorização, o próprio E3 Admin mostra uma mensagem de erro, conforme a figura a seguir.
71 Domínios
Mensagem de erro do E3 Admin
NOTA
O Windows deve ser reiniciado para que as configurações do Controle de Conta de Usuário sejam aplicadas.
Caso existam restrições no Domínio, as opções -load, -stop, -refresh e -close pedem o login do usuário do Elipse
Power.
3.4 IOServer
O IOServer é o processo responsável pela execução dos Drivers de Comunicação. Os IOServers são criados,
mantidos e monitorados pelo processo E3Run.
3.5 Elipse Power Studio

O Elipse Power Studio é o ambiente de desenvolvimento e configuração de aplicações. Permite abrir e editar
arquivos .prj ou .lib. O Elipse Power Studio é multi-usuário, isto é, vários Elipse Power Studios podem modificar os
mesmos arquivos ao mesmo tempo. O Elipse Power Studio utiliza uma conexão REC para se comunicar com o E3
Server.
3.6 Elipse Power Viewer

O Elipse Power Viewer é a interface com o usuário em tempo de execução, pois mostra as Telas em execução e
permite a operação do sistema. O Elipse Power 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 Elipse Power Viewers, pois as
Telas e os bitmaps são carregados conforme a necessidade, em tempo de execução.
3.7 Componentes
Um Domínio é constituído dos arquivos descritos nas seções seguintes.
3.7.1 Arquivo de Configuração

O arquivo .dom armazena os seguintes tipos de informações:
· Opções de configuração do Domínio
· Lista de arquivos .prj e .lib que contêm os Tags, Telas e definições de objetos, entre outros
· Configurações dos servidores ou computadores que executam o Domínio
· Configurações de usuários e permissões de acesso
3.7.2 Arquivo de Projeto

Um Domínio pode ter um ou mais arquivos de projeto. Cada arquivo .prj contém definições de objetos, Tags, Telas,
Históricos, Alarmes e bitmaps, entre outros. A organização dos objetos dentro de um arquivo .prj é livre. Podem ser
criados diversos níveis de Pastas dentro de um projeto, e cada Pasta pode conter qualquer tipo de objeto. O usuário
pode dividir os objetos de um sistema de supervisão em um ou mais arquivos .prj, dependendo da necessidade. Em
tempo de execução, cada projeto pode ser ativado, independente de outros projetos, inclusive em servidores
diferentes.
3.7.3 Arquivo de Biblioteca

Os arquivos .lib contêm definições de objetos criados pelo usuário, os objetos ElipseX, que podem ser utilizados nos
arquivos de projeto.
Domínios 72
3.8 Criando um Domínio
As maneiras de se criar um Domínio no Elipse Power estão descritas a seguir:
· Através do menu Arquivo - Novo Domínio. Para isto, é necessário que ao menos um projeto ou uma biblioteca
esteja aberto. Ao selecionar esta opção, o Elipse Power abre uma caixa de diálogo para selecionar o caminho e o
nome do novo Domínio
Criando um novo Domínio

A seguir, o usuário deve decidir se deseja incluir projetos ou bibliotecas abertos no novo Domínio criado.
Confirmação de inserção do projeto ou biblioteca no novo

Domínio
· Através do Assistente de Aplicações do Elipse Power, que permite a criação de um Domínio novo com um arquivo
de projeto (.prj) ou uma biblioteca (.lib), conforme a próxima seção
3.8.1 Assistente de Aplicações

O Assistente de Aplicações do Elipse Power é a ferramenta utilizada para criar um novo Domínio com um projeto ou
uma biblioteca. Esta opção pode ser acessada das seguintes maneiras:
· Clicando em Novo na barra de ferramentas Padrão
· Através do menu Arquivo - Novo Projeto
Uma vez que o Assistente tenha sido acessado, a tela inicial é aberta. Para continuar, clique em Avançar.
73 Domínios
Tela inicial do Assistente de Aplicações
3.8.1.1 Tipo de Aplicação

Nesta tela, pode-se selecionar entre a criação de uma Aplicação padrão, uma Biblioteca de componentes do E3 ou
uma Aplicação em branco.
Uma Aplicação padrão é aquela cujo projeto possui pelo menos um objeto Viewer, uma Tela e um Servidor de
Dados, tendo ainda a opção de inserir, com a ajuda do Assistente, um Driver de Comunicação, um Banco de Dados,
um Servidor de Alarmes e uma Configuração de Alarmes.
NOTA
As telas Driver de Comunicação, Banco de Dados e Alarmes só são mostradas na criação de uma Aplicação
padrão.
Uma Biblioteca de componentes do E3 é um arquivo utilizado para guardar diversos componentes que podem ser
utilizados em aplicações.
Uma Aplicação em branco é um projeto criado sem nenhum objeto.
No item Nome da aplicação, especifique o nome do arquivo .prj ou .lib que está sendo criado, de acordo com o que
foi selecionado na opção anterior. O local onde a aplicação é salva deve ser especificado no item Salvar a aplicação
na pasta. Caso seja necessário, clique em Procurar.
Domínios 74
Opções de tipos de aplicações
Caso a pasta informada não exista, o usuário é avisado, e deve decidir se deseja criá-la.
Aviso de pasta inexistente

Clique em Avançar para prosseguir.
NOTA
A opção Biblioteca de componentes do E3 é discutida mais adiante, no capítulo Bibliotecas.
3.8.1.2 Domínio
Nesta tela, é possível decidir a qual Domínio pertence o projeto ou a biblioteca que está sendo criado. A seleção da
opção Adicionar no Domínio ativo é condicionada à existência de Domínios ativos no sistema. Clicando nesta opção,
o novo projeto se torna parte do Domínio atual. A opção Criar um novo Domínio cria um novo Domínio, ao qual o
projeto ou biblioteca pertence. O nome deste novo Domínio é indicado na opção Entre com o nome do Domínio.
Por fim, com a opção Não adicionar em nenhum Domínio, o projeto ou biblioteca criado continua sem pertencer a
nenhum Domínio.
75 Domínios
Opções de Domínio
3.8.1.3 Resolução do Elipse Power Viewer

Nesta tela, o usuário pode configurar as propriedades do Elipse Power Viewer que definem a resolução de trabalho
para a aplicação sendo criada, ou seja, a resolução do computador que executa a aplicação. Assim, as Telas que
forem criadas podem ter seus tamanhos definidos de forma que se ajustem à janela do Elipse Power Viewer sem a
necessidade de barras de rolagem. A opção Resolução da tela permite selecionar dentre uma série de resoluções
pré-definidas. Já a opção Avançado permite informar um valor personalizado.
Domínios 76
3.8.1.4 Driver de Comunicação
Nesta tela, o usuário pode decidir pela inclusão de um objeto Driver de Comunicação no projeto sendo criado. Caso
positivo, é possível configurar o arquivo .dll que este Driver utiliza, na opção Arquivo do driver de comunicação. Para
procurar o arquivo, clique em .
Opções para Drivers de Comunicação

3.8.1.5 Banco de Dados

Nesta tela, o usuário pode decidir pela inclusão de um objeto Banco de Dados no projeto sendo criado. Caso
positivo, é possível configurar o arquivo .mdb que este Banco de Dados utiliza, na opção Nome do arquivo de banco
de dados Access. Para procurar o arquivo, clique em .
Opções para bancos de dados
77 Domínios
3.8.1.6 Alarmes
Nesta tela, o usuário pode decidir pela inclusão de um objeto Servidor de Alarmes e de um objeto Configuração de
Alarmes no projeto sendo criado. A opção Desejo guardar os dados dos alarmes em disco habilita o
armazenamento de informações relativas a alarmes em disco, desde que um objeto Banco de Dados tenha sido
inserido no projeto.
Opções para alarmes

Clique em Avançar para finalizar a criação da aplicação.
Após, o Elipse Power Studio mostra a tela final do Assistente, com uma mensagem que indica o final do processo de
criação da aplicação.
Tela final do Assistente de Aplicações

Finalize o processo clicando em Concluir.
Domínios 78
3.9 Configurações
Através do menu do E3 Admin na Área de Notificações do Windows, é possível executar, parar, atualizar ou fechar o
Domínio diretamente através das opções Executar, Parar, Atualizar e Fechar, respectivamente.
Além disto, o Domínio também pode ser configurado para apresentar redundância e utilizar Domínios Remotos, entre
outras ações. Estas configurações são realizadas através da opção Domínio - Opções.
Opções de configuração via Área de

Notificações do Windows
NOTA
Os menus Domínio - Opções e Domínio - Exportar usuários não estão disponíveis no modo Demo, e as opções
de Executar e Parar não estão disponíveis se o Domínio está em modo Hot-Standby ou se é aberto em um
computador que não faz parte do Domínio.
3.9.1 Aba Domínios Remotos

Permite adicionar, remover ou editar os Domínios Remotos. Use a lista da esquerda para selecionar um ou mais
Domínios Remotos a alterar. Para acessar este item, clique com o botão direito do mouse no ícone do E3 Admin na
Área de Notificações do Windows, selecione a opção Domínio - Opções para abrir a janela da figura a seguir e clique
na aba Domínios Remotos.
Aba Domínios Remotos

79 Domínios
Opções disponíveis na aba Domínios Remotos
OPÇÃO DESCRIÇÃO
Nome Esta opção lista os nomes dos Domínios Remotos no
sistema
Adicionar e Remover Através destas opções, pode-se remover ou adicionar

Domínios Remotos no sistema. Para adicionar um
Domínio Remoto em rede, clique em Adicionar e
especifique os campos Nome e Arquivo de Domínio.
Para remover um Domínio, selecione-o na lista e clique
em Remover
Nome do Domínio Determina o nome do Domínio Remoto. Este nome é

definido pelo usuário
Arquivo de Domínio Determina o nome ou o caminho na rede onde está o

arquivo .dom do Domínio Remoto
Servidor principal Identifica o servidor principal na rede
Servidor de backup Quando habilitado, identifica o servidor de backup na

rede
Usuário no Domínio Permite reconhecer um usuário com senha para cada

Domínio Remoto. As opções disponíveis são Não
especificar (anônimo) e Utilizar a seguinte conta. Ao
selecionar esta opção, os campos Usuário e Senha são
habilitados
Usuário Identifica o usuário
Senha Permite a conexão ao Domínio através de senha
É possível que uma configuração de Domínio Remoto possibilite a conexão ao próprio Domínio local. A isto se dá o
nome de Alias local ou conexão Loopback.
Este alias é criado segundo a configuração normal de Domínios Remotos. Basta que o nome dos servidores, principal
ou backup, seja localhost* ou o mesmo da máquina onde o Domínio está executando para que tudo funcione
localmente. Neste caso, para que a configuração funcione no Elipse Power Studio, no campo Arquivo de Domínio,
basta digitar diretamente o caminho local do arquivo DOM, como por exemplo c:\caminho\arquivo.dom.
NOTAS
· A mudança dos aliases locais com o Domínio executando NÃO é suportada. O que acontece é que, se o Domínio
estiver executando, Links já resolvidos como locais continuam sempre locais, mesmo que o alias seja reconfigurado
para conectar em uma máquina remota realmente. Para contornar esta situação, reinicie o Domínio
· As conexões do tipo loopback não aparecem na janela Licenças ou Estatísticas do E3 Admin e nem necessitam de
licenças de Domínios Remotos para funcionar
· * Para que o nome localhost funcione, é necessário que esteja configurado para apontar para o endereço IP
127.0.0.1, que é a configuração padrão do Windows
· Para mais informações sobre as configurações da aba Domínios Remotos, consulte o tópico Configuração da
Conexão
3.9.2 Aba Grupos de Viewers

É possível especificar, de acordo com o endereço IP do Elipse Power Viewer, se este pode se conectar, e com qual
tipo de licença, Viewer Control ou Viewer Only.
Com este recurso, é possível bloquear totalmente a conexão ou limitar a quantidade e o tipo de licenças usadas
simultaneamente para um determinado grupo de endereços IP.
Para acessar os grupos de Elipse Power Viewers, clique com o botão direito do mouse no ícone do E3 Admin na
Área de Notificações do Windows, selecione a opção Domínio - Opções para abrir a janela da figura a seguir e clique
na aba Grupos de Viewers.
Domínios 80
Aba Grupos de Viewers
Opções disponíveis na aba Grupos de Viewers
OPÇÃO DESCRIÇÃO
Nome Lista os nomes de todos os grupos de Elipse Power
Viewers
Adicionar e Remover Adiciona ou remove grupos de Elipse Power Viewers
Nome do grupo Habilita a criação ou alteração de nomes de grupos de

Elipse Power Viewers
Lista de IPs Especifica quais endereços IP pertencem ao grupo, e

deste modo compartilham os mesmos limites de
conexão. Quando um Elipse Power Viewer tenta se
conectar ao E3 Server, seu endereço IP é comparado aos
grupos existentes. Após determinado o grupo ao qual
pertence, é aplicada a restrição de licenças a este Elipse
Power Viewer, configurada para aquele grupo
Adicionar, Editar e Remover Adiciona, edita ou remove os endereços IP. Quando um

grupo é criado, não contém nenhum endereço IP
especificado, exceto o primeiro grupo, que é sempre
*.*.*.* e não pode ser criado pelo usuário. Caso o
usuário tente salvar a configuração e algum grupo tenha
uma lista de endereços IP vazia, o E3 Admin emite um
aviso. Caso o grupo seja mantido assim, este grupo não
tem utilidade
Permitir conexões de Viewer Control Quando selecionada, permite conexões do tipo Viewer
Control para o grupo
Limitar uso de licenças simultâneas Quando selecionada, limita o uso de licenças do tipo
Viewer Control simultâneas a um determinado número.
Se a opção anterior estiver selecionada, mas esta estiver
desmarcada, o uso de licenças simultâneas é ilimitado
Permitir conexões de Viewer Only Quando selecionada, permite conexões do tipo Viewer
Only para o grupo
81 Domínios
OPÇÃO DESCRIÇÃO
Limitar uso de licenças simultâneas Quando selecionada, limita o uso de licenças do tipo
Viewer Only simultâneas a um determinado número. Se
a opção anterior estiver selecionada, mas esta estiver
desmarcada, o uso de licenças simultâneas é ilimitado
É importante notar que estes limites são aplicados após o limite do E3 Server, como configurado no dispositivo de
proteção. Por exemplo, se o dispositivo de proteção possuir dez licenças de Elipse Power Viewer e o grupo
especificar cinco conexões no máximo, apenas estas cinco são usadas. No entanto, se o dispositivo de proteção
possuir cinco licenças de Elipse Power Viewer e o grupo especificar dez conexões no máximo, é utilizado o limite de
cinco conexões do dispositivo. Ou seja, o grupo de Elipse Power Viewers tem sempre uma limitação de licenças
adicional a ser aplicada na conexão do Elipse Power Viewer.
A configuração de grupos de Elipse Power Viewers deve ser realizada preferencialmente com o Domínio parado.
Caso seja realizada com o Domínio em execução, a configuração não tem efeito até que todos os Elipse Power
Viewers sejam desconectados.
NOTAS
No caso de conexões identificadas como E3AccessLayer e E3DataAccess, que por padrão não consomem licenças
do E3 Server, o comportamento dos grupos de Elipse Power Viewers é o seguinte:
· Se o grupo de Elipse Power Viewers não permitir conexões do tipo Viewer Control nem do tipo Viewer Only, a
conexão é negada
· Se o grupo de Elipse Power Viewers permitir conexões do tipo Viewer Control, a conexão é permitida e obedece
ao tipo de acesso requisitado. Por exemplo, para acessos do tipo Viewer Only a conexão é apenas de leitura, e
para acessos do tipo Viewer Control a conexão é de leitura e escrita
· Se o grupo de Elipse Power Viewers permitir apenas conexões do tipo Viewer Only, a conexão é permitida e
somente de leitura, mesmo para acessos do tipo Viewer Control
3.9.3 Aba Hot-Standby

Na aba Hot-Standby é possível habilitar a redundância de servidores. Para acessar este item, clique com o botão
direito do mouse no ícone do E3 Admin na Área de Notificações do Windows, selecione a opção Domínio - Opções
para abrir a janela da figura a seguir e clique na aba Hot-Standby.
Aba Hot-Standby
Domínios 82
Opções disponíveis na aba Hot-Standby
OPÇÃO DESCRIÇÃO
Hot-Standby Aciona o modo Hot-Standby. Se a opção está
desabilitada, o Domínio é executado no servidor em que
foi carregado, sem suporte a Hot-Standby. Se a opção
está habilitada, é possível selecionar um servidor principal
onde o Domínio é executado e, opcionalmente, um
servidor em espera
Servidor principal Seleciona o nome do servidor principal para execução do

Domínio. Para cadastrar e configurar os servidores, utilize
a aba Servidores
Servidor de backup Se esta opção está habilitada, seleciona um servidor de

backup para execução do Domínio. Este servidor
permanece em espera, com o aplicativo carregado no
E3Run pronto para ser executado caso o servidor
principal falhe, ou caso o servidor de backup seja ativado
manualmente
Ativar backup em caso de falha local Habilita a troca automática de servidores quando uma
falha local é reportada no servidor principal. Falhas locais
são detectadas e reportadas pelo próprio aplicativo
através do método Application.ReportFailure. A troca de
servidores só é executada se o servidor de backup estiver
sem falhas
Endereços para PING de integridade da rede O algoritmo de Hot-Standby exige que seja declarada
uma terceira entidade de rede (as outras duas são os
servidores principal e o backup) para determinar se a rede
está funcionando. Se não é possível acessar o endereço
de integridade nem o servidor de backup, o servidor
principal assume que a interface de rede está com
problemas e termina imediatamente a execução do
Domínio. Este campo permite que vários endereços de
rede sejam registrados. As opções para este campo são
as seguintes:
· Os separadores permitidos para cada um dos
endereços são o espaço, a vírgula, o ponto e vírgula, a
tabulação e a quebra de linha
· Se pelo menos um dos endereços fornecidos neste
campo retornar sucesso, a rede é considerada sem
falhas
· Os nomes de servidores não são sensíveis à caixa
· Nomes repetidos são descartados
· Espaços em branco antes ou depois do endereço são
removidos
Tempo para ativação do servidor reserva Permite indicar o tempo de ativação para o servidor de
backup. O valor padrão é 15 segundos. Este tempo afeta
diretamente o time-out do ping entre os servidores. Se é
muito abaixo, como por exemplo uma troca em um
segundo e time-out de ping em 160 ms, podem ocorrer
trocas espontâneas de servidor, causadas por pequenas
falhas de rede
83 Domínios
OPÇÃO DESCRIÇÃO
Perfil de pré-ativação do servidor reserva Os perfis de pré-ativação disponíveis são Mínimo: Ativa
apenas os serviços básicos, Máximo: O Elipse Power
ativa o máximo de objetos quando está em espera
(Associações, Drivers, scripts e Bancos de Dados) ou
Definido pelo usuário: O usuário pode definir quais os
serviços deseja ativar. Cada uma das opções pode ser
habilitada ou desabilitada individualmente
Pré-ativar os seguintes serviços Permite ao usuário selecionar os serviços que deseja

ativar, desde que a opção anterior tenha sido habilitada
como Definido pelo usuário. As opções disponíveis são
Associações (Links): O valor padrão é desabilitado. Se
habilitado, Associações e propriedades do tipo Link de
XFolders e XObjects são avaliadas durante a ativação em
espera, Drivers de E/S (sem comunicação): O valor
padrão é desabilitado. Se habilitado, os IOServers são
criados durante a ativação em espera. NOTA: Esta opção
é importante em aplicativos com vários Drivers de
Comunicação, Scripts: O valor padrão é desabilitado. Se
habilitado, todos os scripts de eventos de objetos e de
bibliotecas são compilados e ativados durante a ativação
em espera ou Banco de Dados: O valor padrão é
habilitado. Isto significa que o Banco de Dados é
conectado durante a ativação em espera. Se desabilitado,
evita que a conexão com o Banco de Dados seja criada
durante a ativação em espera. Esta opção é habilitada
automaticamente quando o valor da propriedade
EnableSynchronization é igual a Verdadeiro
NOTA
Quando um Domínio é colocado em execução, o E3 Server sempre seleciona o servidor ativo por ordem alfabética,
independente de estar selecionado como principal ou backup. Este critério de desempate é utilizado sempre que
mais de um servidor se candidata a executar o Domínio. Para mais informações, consulte o capítulo Hot-Standby.
Quando o Hot-Standby está ligado, os seguintes procedimentos são necessários:

· Definir um diretório compartilhado na rede para conter a cópia principal dos arquivos do Domínio. Este diretório
deve residir em um computador que não faça parte do Domínio Elipse Power
· Criar em cada servidor do Elipse Power um diretório onde é mantida uma cópia atualizada dos arquivos do
Domínio. O E3Run utiliza esta cópia local dos arquivos de projeto e bibliotecas
· Abrir sempre o arquivo de Domínio da rede, utilizando o caminho de rede, como por exemplo \
\server\folder\Domínio.dom
· Quando utilizar o Elipse Power Studio, sempre editar os projetos e bibliotecas da cópia principal, ou seja, na
rede. Para aplicar as alterações, copie os projetos e bibliotecas alterados para o diretório local dos servidores do
Domínio. Após a cópia, clique em Executar Aplicativo no Elipse Power Studio para que as alterações sejam
aplicadas no processo de tempo de execução (E3Run)
NOTA
A REDUNDÂNCIA NÃO ESTÁ DISPONÍVEL EM MODO DEMO. Quando o modo Hot-Standby está ligado, é
necessário que todos os servidores tenham uma cópia dos arquivos do Domínio (.dom, .prj e .lib) e a mesma árvore
de diretórios.
3.9.4 Aba Penas Automáticas

Permite configurar a conexão com um servidor EPM (Elipse Plant Manager) que fornece dados para uma Pena
Automática utilizada em um E3Chart. Esta conexão só é necessária caso a aplicação tenha Tags historiados pelo EPM.
Caso contrário, esta configuração pode ser ignorada. Para mais informações sobre Penas Automáticas, consulte o
tópico Aba Penas no capítulo sobre o E3Chart. Para acessar este item, clique com o botão direito do mouse no ícone
Domínios 84
do E3 Admin na Área de Notificações do Windows, selecione a opção Domínio - Opções para abrir a janela da
figura a seguir e clique na aba Penas Automáticas.
Aba Penas Automáticas

Opções disponíveis na aba Penas Automáticas
OPÇÃO DESCRIÇÃO
URL do ponto de conexão Especifica o caminho ou ponto de conexão de um
servidor EPM ao qual uma Pena Automática se conecta
Usuário Nome de um usuário utilizado na conexão com um

servidor EPM
Senha Senha de um usuário utilizada na conexão com um

servidor EPM
Nomes das Interfaces Nome de um objeto ou objetos Interface de

Comunicação de um servidor EPM que expõe ou expõem
os endereços da fonte de dados. No caso de múltiplos
objetos, use espaços, vírgulas, pontos e vírgulas,
tabulações ou quebras de linha para separar os nomes
dos objetos
Tempo limite de conexão (ms) Especifica o tempo limite da conexão a um servidor EPM,
em milissegundos. O valor padrão desta opção é 10000,
ou seja, dez segundos
Tempo limite da sessão (ms) Especifica o tempo limite para a renovação da sessão de
comunicação com um servidor EPM, em milissegundos.
O valor padrão desta opção é 600000, ou seja, dez
minutos
Tempo limite de chamada (ms) Especifica o tempo limite de uma chamada a um servidor
EPM, em milissegundos. O valor padrão desta opção é
10000, ou seja, dez segundos
85 Domínios
OPÇÃO DESCRIÇÃO
Política de segurança Especifica a política de segurança ou criptografia usada
na conexão com um servidor EPM. As opções disponíveis
são None: Padrão, não utiliza nenhuma criptografia,
Basic128Rsa15: Utiliza o algoritmo RSA com chave de
128 bits na conexão, Basic256: Utiliza o algoritmo AES
com chave de 256 bits na conexão ou Basic256Sha256:
Utiliza o algoritmo SHA com chave de 256 bits na
conexão
Modo de segurança Especifica o modo de segurança que é usado na

conexão com um servidor EPM. As opções disponíveis
são None: Padrão, não utiliza nenhum modo de
segurança, Sign: Utiliza autenticação na conexão ou
SignAndEncrypt: Utiliza autenticação e criptografia na
conexão
Cache interno dos Tags historiados Especifica o momento da criação do cache interno de
dados dos Tags historiados. As opções disponíveis são
Criar cache interno sob demanda: Padrão, o cache é
criado somente após o Tag receber a primeira
requisição ou Criar cache interno na inicialização da
aplicação: O cache de dados de todos os Tags é criado
durante o processo de inicialização da aplicação
Valor padrão para o scan, caso o Tag não possua (ms) Especifica um intervalo de tempo entre variações de
valores de Tags que não possuam esta configuração,
como por exemplo Tags Internos. O valor padrão desta
opção é 1000, ou seja, um segundo. Nos casos em que
um Tag possui um intervalo de tempo configurado entre
variações de valores, este valor é utilizado
3.9.5 Aba Projetos

É possível adicionar, remover ou editar os projetos (arquivos .prj) de um Domínio. Para acessar este item, clique com
o botão direito do mouse no ícone do E3 Admin na Área de Notificações do Windows, selecione a opção Domínio -
Opções para abrir a janela da figura a seguir e clique na aba Projetos.
Aba Projetos
Domínios 86
Opções disponíveis na aba Projetos
OPÇÃO DESCRIÇÃO
Nome Esta opção lista os nomes dos projetos no sistema

projetos no sistema. Para adicionar um projeto, clique em
Adicionar e especifique o campo Nome do projeto. Para
remover um projeto, selecione-o e clique em Remover. O
arquivo de projeto não é apagado do disco, apenas
removido da lista de projetos do Domínio
Nome do projeto Digite o nome do arquivo do projeto, que deve ser um

caminho relativo ao diretório do Domínio, ou seja, o
diretório que contém o arquivo .dom, como por exemplo
Telas.prj ou Hidro\Estacao1.prj
Em manutenção (execução desabilitada) Esta opção permite desabilitar a execução de um projeto,

evitando a ocorrência de erros quando o Domínio é
executado. Quando esta opção está habilitada, o ícone
indica que o projeto não é utilizado. Os projetos com o
ícone estão habilitados e são executados
3.9.6 Aba Propriedades

Permite controlar configurações diversas do Domínio. Para acessar este item, clique com o botão direito do mouse no
ícone do E3 Admin na Área de Notificações do Windows, selecione a opção Domínio - Opções para abrir a janela da
figura a seguir e clique na aba Propriedades.
Aba Propriedades
O grupo Alarmes contém a opção Persistir sumário de alarmes, que permite salvar o sumário de alarmes e assim
evitar notificações duplicadas de alarmes ao abrir ou fechar um Domínio. Por padrão esta opção está desabilitada.
Para habilitá-la, selecione a opção Habilitado no item Habilitar e especifique um intervalo de tempo, em minutos, na
opção Intervalo de tempo. O intervalo de tempo padrão desta opção é de 1 (um) minuto. Estes alarmes persistidos
são carregados sempre que o Domínio é aberto e salvos no intervalo especificado na opção Intervalo de tempo ou
sempre que o Domínio é fechado. A persistência de alarmes não acontece ao parar ou executar um Domínio, pois o
sumário de alarmes é mantido em memória.
87 Domínios
NOTAS
· Em caso de servidores em modo Hot-Standby, ambos os servidores persistem os alarmes.
· Apenas os alarmes visíveis no sumário são persistidos.
· Ao desabilitar esta opção, os alarmes persistidos anteriormente são apagados, de forma a evitar informações
desatualizadas ao habilitar novamente esta opção.
O grupo Geral contém a opção Nome do Domínio, que permite configurar um nome amigável para um Domínio.
Caso esta opção seja deixada em branco, considera-se que o nome do Domínio corresponde ao nome do arquivo de
Domínio sem a extensão .dom. Este nome está disponível por script em tempo de execução usando a propriedade
Domain do objeto Informações do Domínio, como por exemplo "Application.GetObject('[?Server].Domain').Domain".
O grupo Pool de Processos IOServer contém as opções descritas nas tabelas a seguir.
Opções disponíveis no grupo Pool de Processos IOServer
OPÇÃO DESCRIÇÃO
Pool habilitado Habilita ou desabilita o pool de processos I/O Server.
NOTA: Certifique-se que os Drivers em uso na aplicação
suportam o recurso de pool de processos, ou seja, os
Drivers devem ter sido compilados com o IOKit versão
2.0.6 ou superior. Os Drivers que não suportam este
recurso devem ser configurados com a propriedade
DisableIOServerPool em Verdadeiro. O valor padrão
desta opção é Falso
Drivers por processo Define o número máximo de Drivers que executam em

cada processo I/O Server. NOTA: Este limite pode ser
ultrapassado caso o número de processos do pool
chegue ao máximo configurado na opção Número
máximo de processos. O valor padrão desta opção é 0
(zero)
Número máximo de processos Define o número máximo de processos I/O Server que
são criados pelo pool. O valor 0 (zero, padrão) nesta
opção permite um número ilimitado de processos
Esta configuração pode ser alterada com o Domínio em execução, porém somente afeta os Drivers iniciados após a
alteração, ou nas situações em que o Domínio é atualizado:
· Ao clicar em Executar Aplicativo no Elipse Power Studio
· Ao selecionar a opção Domínio - Atualizar, no menu do E3 Admin na Área de Notificações do Windows
· Ao gerar um evento que force o E3Run a receber a configuração do Domínio
NOTA
Para mais informações, consulte o tópico Pool de Processos I/O Server no capítulo Drivers.
O grupo Agrupamento de Operações Assíncronas contém as opções descritas na tabela a seguir.

Opções disponíveis no grupo Agrupamento de Operações Assíncronas
OPÇÃO DESCRIÇÃO
Número máximo de operações por grupo Define o número máximo de operações por Driver de
Comunicação armazenadas na memória do E3Run antes
de enviar para o I/O Server
Tempo máximo de espera (milissegundos) Define o tempo máximo que uma operação assíncrona
pode esperar no E3Run antes de ser enviada para o I/O
Server
O grupo Segurança contém as opções descritas na tabela a seguir.
Domínios 88
Opções disponíveis no grupo Segurança
OPÇÃO DESCRIÇÃO
Não permitir mudança de senha Impede que o usuário troque a senha em tempo de
execução
Permitir mudar senha expirada Permite que o usuário troque imediatamente a senha
expirada
Senha alfanumérica Determina que a senha deve conter letras e números
Caracteres maiúsculos e minúsculos Determina que a senha deve conter letras maiúsculas e
minúsculas
Não diferenciar maiúsculas de minúsculas Indica que a validação da senha é realizada sem
diferenciar maiúsculas e minúsculas. Não é recomendado
habilitar esta opção
Usuário diferente de senha Determina que o nome e a senha do usuário não podem
ser iguais. Esta opção não diferencia entre maiúsculas e
minúsculas
Tamanho mínimo da senha Indica se a senha deve ter um tamanho mínimo de

caracteres. Caso esta opção esteja habilitada, configure
no item Mínimo de caracteres um valor mínimo de
caracteres para a senha
Expiração de senha Indica se a senha de um usuário tem ou não um prazo de

validade. Antes de terminar este prazo, uma caixa de
diálogo é mostrada indicando quantos dias restam para
expirar e oferecendo a possibilidade de trocar a senha.
Após este período, a senha expira e deve ser trocada.
Definir este valor como 0 (zero) permite que a senha
deste usuário expire ao final do dia atual. NOTA: Caso
esta opção esteja habilitada, configure no item Dias para
expiração o prazo para que a senha expire e, se o valor
configurado é igual a 0 (zero), recomenda-se desabilitar
a opção Duração mínima de senha
Duração mínima de senha Indica se há um tempo mínimo em dias para que a senha
de um usuário seja usada antes que tenha que ser
trocada. O valor do item Duração mínima em dias deve
estar no intervalo entre 1 (um) e 730. Definir este valor
como 0 (zero) permite que este usuário altere a senha
imediatamente. NOTA: Caso a opção Expiração de
senha esteja configurada, o valor desta opção não pode
exceder o valor configurado no item Dias para
expiração
Mínimo de caracteres numéricos na senha Indica se a senha deve ter um número mínimo de
caracteres numéricos. Caso esta opção esteja habilitada,
configure no item Mínimo de caracteres numéricos um
valor mínimo de caracteres numéricos para a senha
Mínimo de letras na senha Indica se a senha deve ter um número mínimo de letras.
Caso esta opção esteja habilitada, configure no item
Mínimo de letras um valor mínimo de letras para a
senha
Mínimo de caracteres especiais na senha Indica se a senha deve ter um número mínimo de
caracteres especiais. Caso esta opção esteja habilitada,
configure no item Mínimo de caracteres especiais um
valor mínimo de caracteres especiais para a senha
89 Domínios
OPÇÃO DESCRIÇÃO
Histórico de senhas Indica se as últimas senhas deste usuário são
armazenadas e não podem ser utilizadas. Caso esta
opção esteja habilitada, configure no item Número de
senhas quantas senhas devem ser armazenadas. Após
atingido o valor indicado neste item, a senha mais antiga
é descartada e pode ser utilizada novamente
Bloqueio automático do usuário Determina a quantidade máxima de falhas de login para

que a conta seja bloqueada. Se esta opção está
habilitada, configure no item Número de tentativas a
quantidade máxima de tentativas
Desbloqueio automático do usuário Desbloqueia a conta depois de um certo número de

minutos. Se esta opção está habilitada, configure no item
Tempo para o desbloqueio em minutos o tempo para
desbloqueio da conta
Aviso de expiração de senha Determina a data em que inicia o envio de mensagens

diárias avisando sobre a data de expiração da senha.
Após esta data, se a senha não é trocada, o usuário é
bloqueado e somente o administrador pode
desbloqueá-lo. Se esta opção está habilitada, configure
no item Tempo antes da expiração em dias a data para
iniciar o envio das mensagens
Bloqueio de Senha
A conta de um usuário pode ser bloqueada nas seguintes condições:
· Se a senha expirar (o tempo de expiração pode ser um atributo global, de grupo ou de usuário)
· Se o usuário digitar a senha errada um determinado número de vezes seguidas, isto é, falhas de login
Uma vez bloqueada, a conta não permite login. Esta condição persiste até que um administrador desbloqueie a senha
manualmente, ou então o time-out de bloqueio expire.
NOTA
As opções do grupo Segurança não se aplicam aos usuários do Windows, apenas aos usuários do Domínio do
Elipse Power.
O grupo Viewer contém as opções descritas na tabela a seguir.

Opções disponíveis no grupo Viewer
OPÇÃO DESCRIÇÃO
Compactar bibliotecas Habilita ou desabilita a compactação de arquivos de
bibliotecas ElipseX para envio a um Elipse Power
Viewer. O valor padrão desta opção é habilitada, ou
seja, o arquivo é desfragmentado e são removidos
objetos não utilizados pelo Elipse Power Viewer,
diminuindo assim o tamanho do arquivo. Caso esta
opção esteja desabilitada, os arquivos de bibliotecas são
enviados sem alterações
Balões do servidor Habilita ou desabilita a exibição de uma janela com

avisos ativos do E3 Server no Elipse Power Viewer,
como por exemplo problemas na licença. Esta janela
pode ser fechada ou minimizada, mas é aberta
periodicamente enquanto houver avisos ativos
Domínios 90
3.9.7 Aba Registro de Eventos
Os eventos dividem-se nas categorias Eventos Padrão do Sistema e Eventos Manuais.
Eventos Padrão do Sistema são os eventos gerados automaticamente pelo Elipse Power, e que podem ter o registro
habilitado ou desabilitado individualmente:
· Login ou logout de usuário
· Troca de senha de usuário
· Falha de login de usuário
· Alteração na base de dados de usuário
· Bloqueio de conta de usuário
· Início ou término do Domínio
· Alteração no Domínio (inserir, remover, habilitar ou desabilitar projetos e bibliotecas, alterar a configuração do
Domínio)
· Atualização do Domínio (quando o usuário aplica as alterações realizadas em projetos usando o Elipse Power
Studio)
· Troca manual de servidor Hot-Standby
· Criação de usuário
· Mudança de usuário
· Remoção de usuário
· Alteração de nome de usuário
· Mudança em diretivas de usuário
· Criação de grupo
· Mudança de grupo
· Remoção de grupo
· Alteração de nome de grupo
· Mudança em diretivas de grupo
· Mudanças na aba Registro de Eventos
· Mudanças no grupo Segurança da aba Propriedades
· Desbloqueio de conta
Eventos Manuais são eventos definidos pela aplicação. Estes eventos são gerados em scripts de usuário, através da
chamada ao método Application.TrackEvent. Estes eventos podem ser gerados tanto no Elipse Power Viewer
quanto no Servidor (E3Run).
O Elipse Power Viewer é apenas um gerador de eventos manuais. Utilize o método Application.TrackEvent para
enviar o evento para o E3 Server.
O diagrama a seguir mostra como os diferentes processos do Elipse Power geram e tratam os eventos do sistema.
91 Domínios
Diagrama de processos
Cada E3 Server mantém uma lista interna dos eventos que devem ser registrados no Banco de Dados. Estes eventos
podem vir das seguintes fontes:
· Eventos gerados por Elipse Power Viewers usando o método Application.TrackEvent
· Eventos gerados internamente por um E3 Server
· Eventos gerados por um E3 Server Standby
O E3 Server Standby periodicamente envia uma lista de eventos para o E3 Server Hot, pois apenas este tem
condições de gravar eventos no Banco de Dados. Os eventos são colocados na fila de eventos do Hot, juntamente
com os demais eventos do sistema, isto é, o servidor Hot centraliza a gravação de eventos.
Se houver uma troca de servidor, os eventos que não haviam sido gravados são 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 são gravados.
Para configurar o registro de eventos do Elipse Power, clique com o botão direito do mouse no ícone do E3 Admin
na Área de Notificação do Windows, selecione a opção Domínio - Opções para abrir a janela da figura a seguir e
clique na aba Registro de Eventos.
Domínios 92
Aba Registro de Eventos
Opções disponíveis na aba Registro de Eventos
OPÇÃO DESCRIÇÃO
Registrar os eventos do sistema em uma tabela no Habilita o registro de eventos no Elipse Power. Ao
Banco de Dados do aplicativo selecionar esta opção, a opção Nome da tabela deve
ser obrigatoriamente preenchida
Nome da tabela Indique o nome da tabela onde são gravados os

eventos. A tabela informada é criada automaticamente
pelo E3Run. Os campos desta tabela são E3TimeStamp
(Data/Hora): Este campo é configurado pelo E3Run e
contém a data e hora em que o E3Run conseguiu enviar
o evento para o Banco de Dados, EventTime
(Data/Hora): Este campo é 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 então o parâmetro dtTimeStamp especificado para o
método Application.TrackEvent, EventMessage
(String): Mensagem do evento, com no máximo 200
caracteres e EventComment (String): Comentário sobre
o evento, com no máximo 200 caracteres
Selecionar automaticamente um Banco de Dados no Habilite esta opção para deixar que o E3Run selecione
aplicativo um objeto Servidor de Dados para gravar os dados. Se a
aplicação possui apenas um Servidor de Dados, este
objeto é usado. Se possuir mais de um, recomenda-se
selecionar a opção Usar este Banco de Dados
Usar este Banco de Dados Habilite esta opção para especificar o Servidor de Dados
onde são gravados os eventos. Se o nome do Servidor
de Dados foi informado incorretamente, os eventos
permanecem armazenados na fila de eventos do E3
Server, em memória, até que seja indicado um Servidor
de Dados válido
Marque abaixo os eventos que devem ser registrados Lista os eventos disponíveis no sistema para serem
registrados
93 Domínios
Se o E3Run tiver que escolher entre vários Servidores de Dados, normalmente é utilizado o primeiro Banco de Dados
ativado na execução do Domínio. Se durante a execução do Domínio, o usuário desabilitar o projeto que contém o
Servidor de Dados que estava sendo usado para gravar os eventos, o E3Run automaticamente seleciona outro
Servidor de Dados que esteja disponível na aplicação e continua com este Servidor de Dados até que o Servidor de
Dados anterior seja reativado. Isto implica que, se houver mais de um Servidor de Dados no projeto, é possível que
alguns eventos sejam gravados em um Servidor de Dados e outros eventos em outro Servidor de Dados. Por isto
recomenda-se indicar um Servidor de Dados específico quando houver mais de um Servidor de Dados no projeto.
Ao selecionar um evento na lista e pressionar a tecla F2, abre-se uma caixa de diálogo para edição do evento,
mostrada na figura a seguir.
Edição de eventos
Desmarque a opção Usar mensagem padrão para alterar a mensagem do evento. Clique em para inserir uma
macro dentro da mensagem. Apenas as macros permitidas para aquele evento são mostradas.
Visualização da macro disponível para o evento

As macros sempre estão no formato %MACRO%. As seguintes macros podem ser usadas:
· %%: Insere um sinal de porcentagem na mensagem
· %NAME%: Insere o nome do usuário ou grupo que foi afetado por um evento
· %NEWNAME%: Insere o novo nome de um usuário ou grupo que foi renomeado por um evento
· %USER%: Insere o nome do usuário que gerou o evento, ou "Anônimo" se não há nenhum usuário logado
· %MACHINE%: Insere o nome do computador onde o evento foi gerado
Domínios 94
· %SESSION%: Insere o nome do programa onde o usuário estava logado (Elipse Power Viewer, Elipse Power
Studio ou E3 Server)
· %CAUSE%: Informação adicional sobre um evento
Por exemplo, se a mensagem do evento Falha de Login é alterada para:

"Falhou login do usuário %USER% no computador %MACHINE% (usando um %SESSION%): %CAUSE%"
Se o usuário Admin escrever uma senha errada enquanto executa o login no Elipse Power Viewer que está
executando na máquina CLIENT004, o seguinte evento é gerado:
"Falhou login do usuário Admin no computador CLIENT004 (usando um Viewer): login ou senha
incorretos"
Os eventos padrão do sistema são descritos nos tópicos a seguir.
3.9.7.1 Login de Usuários

Usuário '%USER%' logou no '%SESSION%' na máquina '%MACHINE%'
Gerado sempre que ocorrer um login bem sucedido de um usuário no Elipse Power Studio ou no Elipse Power
Viewer, onde:
· %USER% contém o nome de login do usuário
· %SESSION% contém "Viewer" ou "Studio"
· %MACHINE% contém o nome do computador onde o usuário está logado
3.9.7.2 Logout de Usuários

Usuário '%USER%' terminou sessão de uso de '%SESSION%' na máquina '%MACHINE%'
Gerado sempre que ocorrer o logout de um usuário no Elipse Power Studio ou no Elipse Power Viewer ou sempre
que o programa é fechado sem um logout, e neste caso o logout é automático, onde:
· %USER% contém o nome de login do usuário
· %MACHINE% contém o nome do computador onde o usuário estava logado
3.9.7.3 Troca de Senha

A senha do usuário '%USER%' foi alterada
Gerado sempre que um usuário troca de senha utilizando o método ChangePassword no Elipse Power Viewer, onde:
· %USER% contém o nome de login do usuário cuja senha foi trocada
3.9.7.4 Falha de Login

O login do usuário '%USER%' no '%SESSION%' na máquina '%MACHINE%' falhou: '%CAUSE%'
Gerado sempre que falhar o login de um usuário no Elipse Power Viewer ou no Elipse Power Studio, onde:
· %USER% contém o nome de login informado
· %MACHINE% contém o nome do computador onde o usuário tentou logar
· %CAUSE% contém uma mensagem detalhada sobre esta falha. Consulte o tópico Causas de Eventos para mais
informações
3.9.7.5 Base de Usuários Alterada

Usuário '%USER%' alterou a base de usuários
Gerado sempre que a base de usuários é alterada, normalmente usando o menu Arquivos - Usuário do Elipse Power
Studio, onde:
· %USER% contém o nome de login do usuário que editou a base de usuários, ou "Anônimo" se não havia nenhum
usuário logado
95 Domínios
3.9.7.6 Conta Bloqueada
A conta do usuário '%USER%' foi bloqueada
Gerado sempre que a conta de um usuário é bloqueada por excesso de logins errados, onde:
· %USER% contém o nome de login do usuário cuja conta foi bloqueada
3.9.7.7 Domínio Iniciado

Domínio iniciado pelo usuário '%USER%' no '%SESSION%' na máquina '%MACHINE%'
Gerado sempre que o Domínio é iniciado ou colocado em execução, onde:
· %USER% contém o nome de login do usuário que colocou o Domínio em execução, ou "Anônimo" se não foi
requisitada autenticação quando o Domínio foi executado
· %SESSION% contém "Studio" ou "E3 Server" (menu da Área de Notificações do Windows)
· %MACHINE% contém o nome do computador onde o comando para executar o Domínio foi gerado
3.9.7.8 Domínio Finalizado

Domínio finalizado pelo usuário '%USER%' no '%SESSION%' na máquina '%MACHINE%'
Gerado sempre que o Domínio é parado, onde:
· %USER% contém o nome de login do usuário que parou o Domínio, ou "Anônimo" se não foi requisitada
autenticação quando o Domínio foi parado
· %SESSION% contém "Studio" ou "E3 Server" (menu da Área de Notificações do Windows)
· %MACHINE% contém o nome do computador onde o comando de parar o Domínio foi gerado
3.9.7.9 Domínio Atualizado

Domínio atualizado pelo usuário '%USER%' no '%SESSION%' na máquina '%MACHINE%'
Gerado sempre que o Domínio é atualizado ao clicar em Executar aplicativo no Elipse Power Studio, isto é,
quando são aplicadas no E3Run as alterações realizadas em arquivos PRJ e LIB, onde:
· %USER% contém o nome de login do usuário logado no Elipse Power Studio, ou "Anônimo" se não há nenhum
usuário logado
· %SESSION% contém "Studio"
· %MACHINE% contém o nome do computador onde o Elipse Power Studio estava executando
3.9.7.10 Domínio Modificado

Domínio modificado pelo usuário '%USER%' no '%SESSION%' na máquina '%MACHINE%': '%CAUSE
%'
Gerado sempre que o arquivo do Domínio (.dom) é modificado, onde:
· %USER% contém o nome do usuário que alterou o Domínio
· %SESSION% contém "Studio" ou "E3 Server"
· %MACHINE% contém o nome do computador onde o comando de modificar o Domínio foi gerado
· %CAUSE% contém uma mensagem detalhada sobre esta modificação. Consulte o tópico Causas de Eventos para
mais informações
3.9.7.11 Troca Manual de Servidores

Servidor reserva ativado pelo usuário '%USER%' no '%SESSION%' na máquina '%MACHINE%'
Gerado sempre que é forçada a ativação do servidor de backup de um Domínio, através da opção Servidor - Ativar
do menu do E3 Server, onde:
· %USER% contém o nome de login do usuário que ativou o servidor de backup, ou "Anônimo" se não foi
requisitada autenticação quando o servidor foi ativado
· %SESSION% contém "E3 Server" (menu da Área de Notificações do Windows)
· %MACHINE% contém o nome do computador onde o comando para ativar o servidor de backup foi gerado
Domínios 96
3.9.7.12 Usuário Criado
O usuário '%NAME%' foi criado por '%USER%'
Gerado sempre que um usuário é criado, onde:
· %NAME% contém o nome do usuário que foi criado
· %USER% contém o nome do usuário que executou esta operação
3.9.7.13 Usuário Modificado

O usuário '%NAME%' foi modificado por '%USER%'. '%CAUSE%'
Gerado sempre que um usuário é modificado, onde:
· %NAME% contém o nome do usuário que foi modificado
mais informações
3.9.7.14 Usuário Removido

O usuário '%NAME%' foi removido por '%USER%'
Gerado sempre que um usuário é removido, onde:
· %NAME% contém o nome do usuário que foi removido
3.9.7.15 Usuário Renomeado

O usuário '%NAME%' foi renomeado para '%NEWNAME%' por '%USER%'
Gerado sempre que um usuário é renomeado, onde:
· %NAME% contém o nome do usuário que foi renomeado
· %NEWNAME% contém o novo nome do usuário que foi renomeado
3.9.7.16 Diretivas de Usuário

Os direitos do usuário '%NAME%' foram modificados por '%USER%'
Gerado sempre que os direitos de um usuário são modificados, onde:
· %NAME% contém o nome do usuário cujos direitos foram modificados
3.9.7.17 Grupo Criado

O grupo '%NAME%' foi criado por '%USER%'
Gerado sempre que um grupo é criado, onde:
· %NAME% contém o nome do grupo que foi criado
3.9.7.18 Grupo Modificado

O grupo '%NAME%' foi modificado por '%USER%'. '%CAUSE%'
Gerado sempre que um grupo é modificado, onde:
· %NAME% contém o nome do grupo que foi modificado
mais informações
97 Domínios
3.9.7.19 Grupo Removido
O grupo '%NAME%' foi removido por '%USER%'
Gerado sempre que um grupo é removido, onde:
· %NAME% contém o nome do grupo que foi removido
3.9.7.20 Grupo Renomeado

O grupo '%NAME%' foi renomeado para '%NEWNAME%' por '%USER%'
Gerado sempre que um grupo é renomeado, onde:
· %NAME% contém o nome do grupo que foi renomeado
· %NEWNAME% contém o novo nome do grupo que foi renomeado
3.9.7.21 Diretivas de Grupo

Os direitos do grupo '%NAME%' foram modificados por '%USER%'
Gerado sempre que os direitos de um grupo são modificados, onde:
· %NAME% contém o nome do grupo cujos direitos foram modificados
3.9.7.22 Registro de Eventos do Domínio

Registro de Eventos do Domínio modificado pelo usuário '%USER%' no '%SESSION%' na máquina
'%MACHINE%': '%CAUSE%'
Gerado sempre que há uma modificação nas opções da aba Registro de Eventos da janela Configuração do Domínio,
onde:
· %USER% contém o nome do usuário que modificou a aba Registro de Eventos
· %SESSION% contém "E3 Server" (menu da Área de Notificação do Windows)
· %MACHINE% contém o nome do computador onde a aba Registro de Eventos foi modificada
mais informações
3.9.7.23 Segurança do Domínio

Segurança do Domínio modificada pelo usuário '%USER%' no '%SESSION%' na máquina '%
MACHINE%': '%CAUSE%'
Gerado sempre que há uma modificação nas opções do grupo Segurança na aba Propriedades da janela
Configuração do Domínio, onde:
· %USER% contém o nome do usuário que modificou o grupo Segurança na aba Propriedades
· %SESSION% contém "E3 Server" (menu da Área de Notificação do Windows)
· %MACHINE% contém o nome do computador onde o grupo Segurança na aba Propriedades foi modificado
mais informações
3.9.7.24 Conta Desbloqueada

A conta do usuário '%USER%' foi desbloqueada
Gerado sempre que a conta de um usuário é desbloqueada, onde:
· %USER% contém o nome da conta do usuário que foi desbloqueada
Domínios 98
3.9.7.25 Causas de Eventos
A tabela a seguir contém descrições detalhadas sobre as mensagens de eventos que contêm a macro %CAUSE%.
Mensagens de eventos com a macro %CAUSE%
EVENTO MENSAGEM PADRÃO EXEMPLO DE %CAUSE%
Falha de Login O login do usuário '%USER%' no '% · Login ou senha incorretos
SESSION%' na máquina '%MACHINE · Conta desabilitada
%' falhou: '%CAUSE%'
· Conta bloqueada
· Senha expirada
· Código de erro no formato
hexadecimal, como por exemplo
'erro 0x1234abcd'
Domínio Modificado Domínio modificado pelo usuário '% · Adicionado projeto

USER%' no '%SESSION%' na 'nomeprojeto' (habilitado)
máquina '%MACHINE%': '%CAUSE%' · Adicionado projeto
'nomeprojeto' (desabilitado)
· Removido projeto 'nomeprojeto'
· Projeto/biblioteca 'nomeprojeto'
renomeado para 'novonome'
· Movido projeto 'nomeprojeto'
· Habilitado projeto 'nomeprojeto'
· Desabilitado projeto 'nomeprojeto'
· Aplicadas alterações na janela de
edição do Domínio
Usuário Modificado O usuário '%NAME%' foi modificado 'opcao' modificado de 'valorantigo'

por '%USER%'. '%CAUSE%' para 'valornovo'. Consulte a tabela
Opções da janela Editar Usuário para
exemplos de mensagens
Grupo Modificado O grupo '%NAME%' foi modificado 'opcao' modificado de 'valorantigo'

por '%USER%'. '%CAUSE%' para 'valornovo'. Consulte a tabela
Opções da janela Editar Grupo para
exemplos de mensagens
Registro de Eventos do Domínio Registro de Eventos do Domínio 'opcao' modificado de 'valorantigo'

modificado pelo usuário '%USER%' para 'valornovo'. Consulte a tabela
no '%SESSION%' na máquina '% Opções da aba Registro de Eventos
MACHINE%': '%CAUSE%' para exemplos de mensagens
Segurança do Domínio Segurança do Domínio modificada 'opcao' modificado de 'valorantigo'

pelo usuário '%USER%' no '% para 'valornovo'. Consulte a tabela
SESSION%' na máquina '%MACHINE Opções do grupo Segurança na aba
%': '%CAUSE%' Propriedades para exemplos de
mensagens
Opções da janela Editar Usuário

OPÇÃO TIPO DE DADOS EXEMPLO DE MENSAGEM
Este usuário é um administrador Booleano 'Usuário é Administrador' modificado
de 'Habilitado' para 'Desabilitado'
Não permitir mudança de senha Booleano 'O usuário não pode alterar a sua
senha' modificado de 'Habilitado'
para 'Desabilitado'
Expiração de senha Booleano e Inteiro 'Tempo (em dias) até que a senha
expire' modificado de 'Padrão' para
'2'
99 Domínios
Duração mínima de senha Booleano e Inteiro 'Duração mínima (em dias) para que
uma senha possa ser trocada por
outra nova' modificado de 'Padrão'
para '1'
Tamanho mínimo da senha Booleano e Inteiro 'Quantidade mínima de caracteres

que a senha deve conter' modificado
de 'Padrão' para '1'
Senha alfanumérica Booleano 'A senha deve conter letras e

números' modificado de 'Padrão'
para 'Habilitado'
Mínimo de caracteres numéricos na Booleano e Inteiro 'Quantidade mínima de números que

senha a senha deve conter' modificado de
'Padrão' para '1'
Mínimo de letras na senha Booleano e Inteiro 'Quantidade mínima de letras que a

senha deve conter' modificado de
'Padrão' para '1'
Mínimo de caracteres especiais na Booleano e Inteiro 'Quantidade mínima de caracteres

senha especiais que a senha deve conter'
modificado de 'Padrão' para '1'
Caracteres maiúsculos e minúsculos Booleano 'A senha deve conter letras

maiúsculas e minúsculas' modificado
de 'Padrão' para 'Habilitado'
Conta desabilitada Booleano 'Esta conta está desabilitada'

modificado de 'Desabilitado' para
'Habilitado'
Conta bloqueada Booleano 'Esta conta está bloqueada'

modificado de 'Desabilitado' para
'Habilitado'
Forçar troca de senha Booleano 'O usuário deve trocar a senha no

próximo login' modificado de
'Desabilitado' para 'Habilitado'
Não diferenciar maiúsculas de Booleano 'Validar senhas sem validar

minúsculas maiúsculas e minúsculas (não
recomendado)' modificado de
'Padrão' para 'Habilitado'
Histórico de senhas Booleano e Inteiro 'Número de senhas usadas mais

recentemente por um usuário e que
não podem ser reutilizadas'
modificado de '1' para '5'
NOTA
Ao alterar a senha de um usuário no Elipse Power Studio, usando a aba Usuários da janela Permissões do Usuário
do menu Arquivo - Usuários ou utilizando o método UserAdministration do Viewer, a mensagem de evento é "O
usuário 'nomeusuario' foi modificado por 'outrousuario'. 'A senha do usuário foi alterada'".
Opções da janela Editar Grupo

senha' modificado de 'Padrão' para
'Habilitado'
Domínios 100
expire' modificado de 'Padrão' para
'1'
outra nova' modificado de 'Padrão'
para '1'

de 'Padrão' para '1'

números' modificado de 'Padrão'
para 'Habilitado'

'Padrão' para '1'

'Padrão' para '1'


de 'Padrão' para 'Habilitado'

'Padrão' para 'Habilitado'

NOTAS
· Para mais informações sobre a janela Editar Usuário, consulte o tópico Usuários no capítulo Segurança.
· Para mais informações sobre a janela Editar Grupo, consulte o tópico Grupos no capítulo Segurança.
· Opções com o valor Padrão em uma mensagem indicam que o valor daquela opção é herdado das opções gerais
do Domínio.
Opções da aba Registro de Eventos

Registrar os eventos do sistema em Booleano 'Registrar os eventos do sistema em
uma tabela no Banco de Dados do uma tabela no Banco de Dados do
aplicativo aplicativo' modificado de 'Habilitado'
para 'Desabilitado'
Nome da tabela String 'Nome da tabela' modificado de

'Tabela1' para 'Tabela2'
Selecionar automaticamente um Booleano 'Usar este Banco de Dados'

Banco de Dados no aplicativo modificado de 'DB1' para '(selecionar
automaticamente)'
101 Domínios
Usar este Banco de Dados Booleano e String 'Usar este Banco de Dados'
modificado de 'DB1' para 'DB2'
Evento Booleano 'nomeevento' modificado de

'Habilitado' para 'Desabilitado'
Opções do grupo Segurança na aba Propriedades

senha' modificado de 'Desabilitado'
para 'Habilitado'

números' modificado de

de 'Desabilitado' para 'Habilitado'

Usuário diferente de senha Booleano 'Nome de usuário e senha não

podem ser iguais' modificado de

de 'Desabilitado' para '1'
expire' modificado de 'Desabilitado'
para '1'
outra nova' modificado de
'Desabilitado' para '1'



modificado de 'Desabilitado' para '1'

Bloqueio automático do usuário Booleano e Inteiro 'Quantidade de falhas de login para

bloquear a conta do usuário'
Domínios 102
Desbloqueio automático do usuário Booleano e Inteiro 'Tempo (em minutos) para
desbloquear o usuário
automaticamente' modificado de
Aviso de expiração de senha Booleano e Inteiro 'Tempo (em dias) para avisar o
usuário antes que a senha expire'
3.9.8 Aba Servidores

É possível adicionar, remover ou editar os servidores de um Domínio. Use a lista da esquerda para selecionar um ou
mais servidores a alterar. A lista indica também se o servidor está habilitado , em modo Manutenção ou
desabilitado . Para acessar este item, clique com o botão direito do mouse no ícone do E3 Admin na Área de
Notificações do Windows, selecione a opção Domínio - Opções para abrir a janela da figura a seguir e clique na aba
Servidores.
Aba Servidores
Opções disponíveis na aba Servidores
OPÇÃO DESCRIÇÃO
Nome Lista com os nomes dos servidores no sistema

servidores no sistema. Para adicionar um servidor em
rede, clique em Adicionar e especifique os campos
Nome do servidor e Identificação do servidor na rede.
Para adicionar um servidor local, especifique o item
Caminho local de acesso aos arquivos de Domínio.
Para remover um projeto, selecione-o na lista e clique em
Remover
Nome do servidor Determina o nome do servidor. Este nome é definido pelo

usuário
Identificação do servidor na rede Digite o nome do servidor na rede. Deve ser o nome da
máquina com ou sem as barras duplas invertidas no
início, como por exemplo \\server ou server
103 Domínios
OPÇÃO DESCRIÇÃO
Pasta raiz dos arquivos do Domínio Indica a pasta onde estão localizados os arquivos do
Domínio (arquivos .prj, .lib, etc.) do servidor selecionado.
A opção Não especificar (utilizar a pasta do arquivo
.DOM) é o padrão, e indica que os arquivos estão na
mesma pasta do arquivo de Domínio (.dom). Caso seja
selecionada a opção Utilizar a seguinte pasta local, o
caminho digitado no campo específico deve conter
apenas a pasta, sem o nome nem a extensão do arquivo
de Domínio (.dom)
Em manutenção (execução desabilitada) Esta opção permite desabilitar o servidor e não utilizá-lo
na execução do Domínio. Quando esta opção é
habilitada, o ícone indica que o servidor não é
utilizado. Do contrário, o ícone indica que o servidor
pode ser utilizado
3.10 Outras Opções da Área de Notificação

Além das opções listadas na seção anterior, existem outras configurações acessadas através do menu do E3 Admin
na Área de Notificações do Windows, descritas nos tópicos a seguir.
3.10.1 Exportar Usuários

Esta opção permite exportar uma lista, em formato CSV (Comma-Separated Values), de todos os usuários configurados
no Domínio atual. Ao utilizar esta opção, a janela da figura a seguir é aberta para selecionar um diretório para salvar
o arquivo.
Janela Exportação de Usuários
Domínios 104
NOTAS
· Esta opção não está disponível em modo Demo.
· Esta opção deve ser realizada por um usuário com a permissão Configurar usuários/grupos.
· Usuários selecionados como Administradores sempre têm permissão para configurar usuários e grupos, mesmo
que esta opção tenha sido explicitamente negada na janela Permissões do usuário.
· Esta opção sempre exporta todas as informações sobre todos os usuários configurados no Domínio atual.
3.10.2 Atalhos
Esta opção permite executar aplicações presentes na instalação do Elipse Power diretamente pelo menu contextual
do ícone do E3 Admin, na Área de Notificação do Windows. As seguintes aplicações podem ser executadas:
· Elipse Event Log Viewer
· Elipse Power Studio
· E3 Tweak
· Elipse Power Viewer
O item Log Viewer abre a aplicação Elipse Event Log Viewer já com o arquivo correspondente à sessão ativa de
logs do Elipse Power. Para maiores informações sobre esta aplicação, consulte o Manual do Usuário do Elipse
Event Log, disponível no menu Iniciar - Programas - Elipse Software - Elipse Event Log.
Se já há um Domínio executando localmente, o item Elipse Power Viewer deste menu abre um Elipse Power Viewer
para o Domínio local. Do contrário, ou se a tecla SHIFT estiver pressionada, abre-se a janela inicial do Elipse Power
Viewer, onde é possível selecionar o servidor e outras opções, como descrito no tópico Elipse Power Viewer e
WebViewer - Execução do Elipse Power Viewer - Através do Menu Iniciar.
3.10.3 Licenças
É possível visualizar as diversas licenças disponíveis através do E3 Admin. Para isto, clique com o botão direito do
mouse no ícone do E3 Admin na Área de Notificações do Windows e selecione a opção Licenças. A janela da figura a
seguir é mostrada.
Janela E3 Admin - Licenças

105 Domínios
Opções disponíveis na janela E3 Admin - Licenças
OPÇÃO DESCRIÇÃO
Número da Chave Informa o número do dispositivo de proteção, um
número hexadecimal de oito dígitos com prefixo "HL" se
o dispositivo é do tipo Hardkey ou um número
hexadecimal de dezesseis dígitos com prefixo "SL" se o
dispositivo é do tipo Softkey. Se o dispositivo de
proteção não foi detectado, este número é preenchido
com zeros
E3 Server Indica o tipo de E3 Server
Elipse Power Studio Indica o número de licenças disponíveis e em uso do

Elipse Power Studio
Elipse Power Viewer Indica o número de licenças disponíveis e em uso do

Elipse Power Viewer
Elipse Power Viewer Only Indica o número de licenças disponíveis e em uso do

Elipse Power Viewer no modo Somente Leitura
Subestações Indica o número de licenças disponíveis e em uso de

Subestações
Alimentadores Indica o número de licenças disponíveis e em uso de

Alimentadores
Medidas do Power Indica o número de licenças disponíveis e em uso de

Medidas do Elipse Power
Turbinas Eólicas Indica o número de licenças disponíveis e em uso de

Turbinas Eólicas
Arranjos Fotovoltaicos Indica o número de licenças disponíveis e em uso de

Arranjos Fotovoltaicos
Inversores Indica o número de licenças disponíveis e em uso de

Inversores
Entradas do Fluxo de Potência Indica o número de licenças disponíveis e em uso de

Entradas do módulo de Fluxo de Potência
Disjuntores do Descarte de Cargas Indica o número de licenças disponíveis e em uso de

Disjuntores do módulo de Descarte de Cargas
Cargas Modeladas no Power Indica o número de licenças disponíveis e em uso de

Cargas modeladas no Elipse Power
Cargas Modeladas para Geração de Visualizações Indica o número de licenças disponíveis e em uso de
Esquemáticas Cargas modeladas para geração de Visualizações
Esquemáticas
Cargas para Estimador de Estados Indica o número de licenças disponíveis e em uso de

Cargas para o módulo do Estimador de Estados
Cargas para Modelagem da Distribuição Indica o número de licenças disponíveis e em uso de

Cargas para Modelagem da Distribuição
Disjuntores e Religadores da Autorrecuperação Indica o número de licenças disponíveis e em uso de

Disjuntores e Reguladores do módulo de
Autorrecuperação
Domínio Remoto (Servidor) Indica o número de licenças disponíveis e em uso do

Domínio Remoto (Servidor)
Domínio Remoto (Cliente) Indica o número de licenças disponíveis e em uso do

Domínio Remoto (Cliente)
Pontos de E/S Indica o número de pontos de comunicação
Tags do Storage Indica o número de Tags do Storage
Domínios 106
OPÇÃO DESCRIÇÃO
Drivers Indica o número de Drivers disponíveis e em uso
Servidor OPC Indica o número de licenças disponíveis e em uso do

Servidor OPC
Tempo máximo de execução Indica o tempo máximo permitido de execução de um

aplicativo
TrendAnalysis Indica o número de licenças disponíveis e em uso do

objeto TrendAnalysis
Serviço HASP Indica a versão do serviço de acesso a licenças

(HASPLMS)
Para mais informações sobre as limitações do modo Demo do Elipse Power, consulte o tópico Limitações do Modo
Demonstração.
NOTA
· Os usuários logados e identificados como E3DataAccess e E3AccessLayer, na coluna Programa da lista Usuários
Logados, não consomem licenças de Elipse Power Viewer de um E3 Server.
· Alterações nas propriedades de N1 a N4 de Tags de Comunicação e nas propriedades B1 a B4 e Size de Blocos
de Comunicação consomem licenças.
· Alterações nas propriedades ItemID de Tags de Comunicação OPC, Blocos de Comunicação OPC, Tags de
Comunicação OPC UA e Blocos de Comunicação OPC UA consomem licenças, bem como alterações nas
propriedades Size de Blocos de Comunicação OPC e Blocos de Comunicação OPC UA.
· Para os casos anteriores, recomenda-se desativar estes objetos em scripts, usando o método Deactivate, executar
as alterações desejadas e então reativar os objetos usando o método Activate.
3.10.4 Estatísticas
A janela E3 Admin - Estatísticas de Comunicação mostra os dados em tempo real sobre o tráfego de informações
na rede. A lista é atualizada automaticamente a cada segundo. Para abrir esta janela, clique com o botão direito do
mouse no ícone do E3 Admin na Área de Notificações do Windows e selecione a opção Estatísticas.
Janela E3 Admin - Estatísticas de Comunicação

Opções disponíveis na janela E3 Admin - Estatísticas de Comunicação
OPÇÃO DESCRIÇÃO
Programa Mostra o nome da aplicação conectada ao E3 Server
Computador Mostra o nome da máquina conectada ao E3 Server
Endereço Mostra o endereço IP da máquina conectada ao E3

Server
Dados enviados Mostra a quantidade de dados já enviados
Compressão no Envio Mostra a percentagem de compressão no envio
Pacotes Enviados Mostra a quantidade de pacotes já enviados
107 Domínios
OPÇÃO DESCRIÇÃO
Pacotes Pendentes Mostra a quantidade de pacotes ainda pendentes de
envio
Dados Pendentes Mostra a quantidade de dados ainda pendentes de envio
Dados recebidos Mostra a quantidade de dados já recebidos
Compressão no Recebimento Mostra a percentagem de compressão no recebimento
Pacotes Recebidos Mostra a quantidade de pacotes já recebidos
Conectado desde Mostra a data e hora em que o programa iniciou a

conexão
Atualizar Força a atualização das estatísticas
3.10.5 Monitor
A janela E3 Admin - Monitor mostra informações em tempo real sobre o estado dos servidores do Domínio. Para
isto, clique com o botão direito do mouse no ícone do E3 Admin na Área de Notificações do Windows e selecione a
opção Monitor.
Janela E3 Admin - Monitor

Opções disponíveis na janela E3 Admin - Monitor
OPÇÃO DESCRIÇÃO
Domínio atual Nome do Domínio ativo
Endereços de ping Lista com os endereços dos servidores de ping
Nome Nome do servidor
Endereço Endereço de rede do servidor
Ping Mostra o estado do ping de rede com este servidor
Relógio Mostra a hora local do servidor
Estado Mostra o estado do Domínio no servidor (Parado ou

Rodando)
Conexão Mostra o estado da conexão DCOM com o servidor
Domínios 108
OPÇÃO DESCRIÇÃO
Função Mostra uma lista de funções reportadas pelo servidor. As
opções disponíveis são Ativo: Este é o servidor ativo do
Domínio, Reserva: Este é o servidor standby do Domínio,
Falha(n): Servidor possui falhas locais reportadas,
Prioridade: O servidor requisitou prioridade para
executar o Domínio. Este indicador faz com que o
servidor ativo passe para o modo Standby, Candidato:
O servidor é candidato a executar o Domínio ou E/S: O
servidor possui IOServers ativos
3.10.6 Inicialização
Esta opção permite controlar o Domínio a ser iniciado automaticamente. O Domínio configurado só é executado se o
E3 Server não estiver em modo Demo. Para isto, clique com o botão direito do mouse no ícone do E3 Admin na Área
de Notificações do Windows e selecione a opção Inicialização. A janela da figura a seguir é mostrada.
Janela E3 Admin - Inicialização

Opções disponíveis na janela E3 Admin - Inicialização
OPÇÃO DESCRIÇÃO
O Domínio carregado Ao iniciar, executa automaticamente o Domínio
previamente carregado
O Domínio configurado Ao iniciar, executa automaticamente o Domínio

configurado pelo usuário
Nenhum Domínio Não inicia nenhum Domínio
3.10.7 Impressora
Esta opção mostra a lista das impressoras encontradas local ou remotamente, e permite que o usuário seleciona uma
para ser usada pelo E3 Server. Para isto, clique com o botão direito do mouse no ícone do E3 Admin na Área de
Notificações do Windows e selecione a opção Impressora. A janela da figura a seguir é mostrada.
Janela E3 Admin - Impressora

109 Domínios
Opções disponíveis na janela E3 Admin - Impressora
OPÇÃO DESCRIÇÃO
Nome da impressora Lista o nome das impressoras disponíveis
Padrão Permite selecionar esta impressora como padrão
Configurar Abre a janela de propriedades da impressora

selecionada
Procurar Permite selecionar outra impressora na rede e

estabelecer uma conexão
3.10.8 Sobre o E3 Admin

Esta opção mostra a versão do E3 Admin.
3.10.9 Reiniciar E3 Server

Esta opção permite reiniciar o E3 Server e aplicar imediatamente quaisquer alterações de licença.
Caso tenha sido definido um Domínio para iniciar automaticamente na janela Inicialização, a janela da figura a seguir
é mostrada.
Opções de reiniciar um E3 Server com inicialização configurada

As opções disponíveis nesta janela são Apenas reiniciar, sem nenhum Domínio, que apenas reinicia o E3 Server,
Executar o Domínio já configurado, que reinicia o E3 Server e carrega o Domínio configurado na janela
Inicialização, e Carregar o Domínio corrente, que reinicia o E3 Server e carrega o Domínio corrente, caso o E3
Server tenha sido parado enquanto um Domínio estava em execução.
Caso não tenha sido definido nenhum Domínio para iniciar automaticamente, a janela da figura a seguir é mostrada.
Opção de reiniciar um E3 Server sem inicialização configurada

Neste caso, o E3 Server é reiniciado e o usuário pode optar por executar ou não o Domínio corrente ao selecionar ou
desmarcar a opção Executar Domínio corrente ao reiniciar.
Domínios 110
NOTA
Por padrão, o E3 Server é reiniciado utilizando o usuário que parou o Domínio, mas caso o Domínio configurado
para inicialização seja diferente do Domínio antes do reinício, a janela de login pode ser mostrada para autenticação
neste novo Domínio.
3.10.10 Iniciar ou Parar o E3 Server

Esta opção para ou inicia o E3 Server. Ao ser acionada a opção Parar E3 Server, é pedida a confirmação da operação.
Se confirmada, o Domínio é parado e fechado, e são desconectados todos os Elipse Power Studios e Elipse Power
Viewers, caso existam. O usuário é notificado que isto não permite o uso de Elipse Power Studios remotos e do Hot-
Standby. Quando o E3 Server estiver parado, ele pode ser reiniciado pela opção Iniciar E3 Server.
3.10.11 Fechar o E3 Admin

O E3 Admin pode ser fechado sem precisar fechar o E3 Server, através da opção Fechar E3 Admin. Quando isto
acontece, o E3 Server continua executando, mas nenhum ícone aparece na Área de Notificações do Windows. Neste
caso, quando o E3 Admin não está aberto, as mensagens de erro aparecem como caixas de mensagens a todos os
usuários logados, e ativos, na máquina executando o E3 Server.
A qualquer momento, o E3 Admin pode ser reiniciado para controlar o E3 Server em execução, bastando para isto
iniciar o E3 Admin sem nenhum parâmetro. O instalador também cria um atalho para abrir o E3 Admin diretamente.
3.11 Domínios Remotos

A configuração de Domínios Remotos define que há comunicação entre diferentes servidores e Elipse Power Viewers,
onde uma aplicação é destinada a fornecer dados, e a outra a recebê-los. O Domínio que fornece dados a outro é
chamado de Domínio Servidor; já o Domínio que utiliza estes dados é chamado de Domínio Cliente. A configuração
de um Domínio como Domínio Cliente não impede que seja ao mesmo tempo um Domínio Servidor, e vice-versa.
Domínios Remotos não estão disponíveis em modo Demo.
3.11.1 Configuração da Conexão

A configuração das conexões com outros Domínios do Elipse Power deve ser realizada no Domínio Cliente, clicando
com o botão direito do mouse no ícone do E3 Admin na Área de Notificações do Windows, selecionando a opção
Domínios - Opções e então selecionando a aba Domínios Remotos.
111 Domínios
Aba Domínios Remotos
Neste caso, o Domínio referenciado pela configuração é o Domínio Servidor. É possível também que os Domínios se
referenciem entre si, sendo ao mesmo tempo servidores e clientes de Domínios Remotos. Para configurar o uso de
um Domínio Remoto, siga estes procedimentos:
1. Informe um apelido para o Domínio Remoto no campo Nome do Domínio. Este campo não é sensível a
maiúsculas ou minúsculas. Este nome é usado na aplicação para referenciar os objetos a serem acessados no
Domínio Remoto.
2. Especifique o caminho do arquivo .dom do Domínio 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 Domínio Remoto especificado no
caminho do arquivo .dom. Esta configuração é utilizada para encontrar os objetos do Domínio Remoto em tempo
de execução.
O grupo Servidores e opções de conexão contém a opção Avançado, que permite realizar configurações específicas
da conexão entre os Domínios, através da janela mostrada na figura a seguir.
Domínios 112
Janela Opções de Conexão
As opções desta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Opções de Conexão
OPÇÃO DESCRIÇÃO
Tempo limite de conexão (ms) Esta opção controla o tempo máximo que o Domínio
Remoto Cliente espera para estabelecer uma conexão
REC com o E3 Server do Domínio Servidor. Sua finalidade
é a mesma da chave ConnectionTimeout, configurável
pelo E3 Tweak. O valor padrão desta opção é 2000 ms
Tempo limite de chamada (ms) Esta opção controla o tempo máximo que o Domínio
Remoto Cliente espera pelo retorno de uma chamada ao
Domínio Remoto Servidor. Se este tempo é excedido, a
conexão é desfeita pelo cliente, mesmo que os limites
estabelecidos pelas opções Verificar PING e Utilizar
heartbeat na conexão ainda não tenham sido excedidos.
O valor padrão desta opção é 0 (zero), que desabilita o
tempo limite
Verificar PING Esta opção permite que, através de um pedido de echo

do protocolo ICMP, o Domínio Remoto verifique se o
Servidor responde dentro de um tempo limite (time-out).
Se não houver resposta, por qualquer motivo, considera-
se que o computador está fora da rede ou desligado.
Esta verificação, se habilitada, ocorre antes da conexão,
evitando a tentativa de conectar em um computador
indisponível, e enquanto a conexão estiver ativa,
forçando a desconexão imediata
Tempo limite de PING (ms) Um valor, em milissegundos, para a verificação do ping.

O valor padrão desta opção é 2000 ms
Utilizar heartbeat na conexão Esta opção permite que, através de um mecanismo do

protocolo REC, o Domínio Remoto Cliente verifique se o
Servidor está mantendo a conexão ativa, esperando que
sejam enviadas mensagens de heartbeat periódicas,
mesmo que não haja nenhuma outra comunicação a
realizar. Se excedido o dobro do tempo de heartbeat
configurado sem que o Cliente receba uma mensagem
qualquer do computador Servidor, considera-se que o
Servidor falhou ou está fora da rede, e força uma
desconexão imediata
113 Domínios
OPÇÃO DESCRIÇÃO
Período de heartbeat (ms) Um valor, em milissegundos, para o período de
heartbeat. O valor padrão desta opção é 2000 ms
Utilizar criação assíncrona de links Se esta opção estiver selecionada, as Associações são
criados em paralelo entre os diversos Domínios e o
resultado da operação vem assincronamente, à medida
que cada Servidor responder. A vantagem desta opção é
não trancar o tratamento geral de Associações do E3
Server. Apenas operações daquele mesmo Domínio
podem permanecer trancadas, caso a criação de
Associações demore muito, o que pode ocorrer em
redes lentas. NOTA: Esta opção não está disponível para
versões anteriores à 3.2, e as aplicações desenvolvidas
em versões anteriores falham com o código de erro
8004F108 (versão incompatível do REC). O valor padrão
desta opção é desmarcada
NOTA
Desmarcar simultaneamente as opções Verificar PING e Utilizar heartbeat na conexão torna a detecção de queda
da conexão extremamente lenta, caso o Servidor falhe. Recomenda-se que as duas opções estejam sempre
selecionadas.
No Elipse Power Studio, o caminho completo do compartilhamento é usado para que seja possível determinar os
objetos existentes no Domínio Remoto. O nome do arquivo .dom, sem o caminho, é usado para verificar se a conexão
remota está sendo realizada com o Domínio correto, em tempo de execução. Assim, se o nome de um Domínio
carregado no E3 Server remoto não é o correto, a conexão não é completada e os objetos remotos não ficam
acessíveis.
Outra possibilidade é manter uma cópia do Domínio Remoto na máquina Cliente, e digitar o caminho desta cópia no
campo Arquivo de Domínio. Desta forma, o Elipse Power Studio utiliza a cópia local para determinar quais objetos
existem, permitindo o trabalho offline. A cópia deve obrigatoriamente ter o mesmo nome do Domínio Remoto para
que a conexão funcione, não sendo necessário possuir a mesma hierarquia de diretórios.
Além disto, para que a conexão entre os Domínios possa ocorrer, todos os E3 Servers envolvidos devem executar a
mesma versão do Elipse Power.
Para que um E3 Server aceite receber conexões de outros Domínios, isto é, para que seja um servidor de Domínios
Remotos, não é necessária nenhuma configuração específica.
Após a correta configuração destes itens, é necessário apenas executar os E3 Servers para que as conexões remotas
sejam estabelecidas.
NOTA
Para mais informações sobre a configuração de Domínios Remotos, consulte o tópico Aba Domínios Remotos.
3.11.2 Licenças
Tanto o E3 Server executando o Domínio Cliente, quanto o que executa o Domínio Servidor, devem ter licenças
específicas para Domínios Remotos.
Quando esta licença existe, o E3 Server Servidor passa a aceitar um número ilimitado de conexões externas de outros
Domínios. Da mesma forma, no caso do E3 Server Cliente, é possível estabelecer um número ilimitado de conexões.
Para maiores informações sobre as limitações do modo Demo do Elipse Power, consulte o tópico Limitações do
Modo Demonstração.
3.11.3 Sintaxe dos Links

Com a configuração de Domínios Remotos, o Domínio Cliente pode acessar objetos do Domínio Servidor através de
scripts, utilizando o método Application.GetObject, ou através de Links, ou seja, de qualquer funcionalidade que crie
uma conexão com outro objeto, tais como expressões de eventos de usuário, propriedades do tipo Objeto de
ElipseX, fontes de Associações, de Alarmes ou de campos de Históricos e Storages, entre outros. Os objetos
acessados desta forma podem tanto ser objetos do Elipse Power Viewer quanto do Servidor.
Domínios 114
O acesso aos objetos de outro Domínio é realizado através do apelido ou Nome de Domínio, que deve preceder o
caminho completo de cada objeto, separado por dois pontos. Ou seja, para que as fontes de Links ou o comando
Application.GetObject referenciem outro Domínio, deve-se usar a sintaxe DOMINIO:CAMINHO, onde DOMINIO é o
apelido dado àquela conexão com o Domínio Remoto, e CAMINHO é o caminho completo de um objeto ou
propriedade daquele Domínio. No caso de Links, as fontes podem incluir expressões com referências a vários objetos,
podendo haver combinações entre objetos locais e de Domínios Remotos, como por exemplo Driver1.Tag1 +
Remoto:Driver2.Tag1 * 2.
O nome do Domínio Remoto também pode necessitar de colchetes, como por exemplo [DOMINIO]:CAMINHO. Neste
caso, aplicam-se as mesmas regras de nomes de objetos. Os nomes de Domínios necessitam de colchetes nos
seguintes casos:
· Contenha qualquer caractere que não seja uma letra (a-z | A-Z) quando usado como primeiro caractere do nome
do Domínio
· Contenha qualquer caractere que não seja uma letra (a-z | A-Z), um número (0-9) ou um sublinhado (_) quando
usado após o primeiro caractere do nome do Domínio
3.11.4 Permissões de Usuário

Assim como ocorre com o Elipse Power Viewer, o acesso aos objetos de um Domínio Remoto pode ser limitado ao
modo Somente Leitura. Quando isto ocorre, são aplicados os mesmo tipos de limitações de acesso que se aplicam
ao Viewer Only. Porém, diferente do Elipse Power Viewer, neste caso o controle é realizado apenas por usuário e
não por endereço IP ou por chave de produto. Para isto, usa-se a configuração de usuários na permissão Acesso
remoto de escrita ao Domínio, dentro do item de segurança Domínio.
Permissões de usuário
Com isto, pode ser necessário que a conexão com o Domínio Remoto especifique um determinado usuário para
poder ter acesso completo aos objetos do Domínio. Este usuário deve ser especificado no campo Usuário no
Domínio através da opção Utilizar a seguinte conta, na aba Domínios Remotos da configuração do Domínio Cliente.
Ali devem ser especificados o login e senha de um usuário existente no Domínio sendo acessado remotamente.
Além do acesso em modo Somente Leitura, é possível bloquear completamente o acesso remoto, o que exige que a
conexão com o Domínio Remoto especifique um determinado usuário para poder ganhar acesso aos objetos
remotos. Isto é feito através da permissão Acesso remoto ao Domínio, também do item de segurança Domínio.
115 Domínios
NOTA
A permissão Acesso remoto ao Domínio sempre tem precedência sobre a permissão Acesso remoto de escrita ao
Domínio. Isto significa que, quando a primeira permissão for negada, a segunda não é efetivada mesmo quando
explicitamente permitida. Não havendo nenhuma permissão de acesso configurada, qualquer Domínio pode se
conectar remotamente a outro, utilizando um usuário anônimo.
3.11.5 Hot-Standby
A conexão remota ao Domínio suporta Domínios com Hot-Standby nativamente. Para isto, basta apenas especificar os
nomes dos dois servidores, principal e backup, nos itens respectivos da área Identificação dos servidores na rede, na
aba Domínios Remotos. É importante ressaltar que, para o correto funcionamento do Hot-Standby, estes nomes
devem ser os mesmos especificados pelo Domínio Remoto acessado. Uma vez que haja esta configuração em tempo
de execução, o E3 Server sempre tenta conectar-se aos dois servidores, direcionando o acesso de todos os
comandos Application.GetObject e Links para o primeiro servidor que possa ser acessado e que indique estar
executando o Domínio. Caso os nomes dos servidores sejam modificados quando o Domínio Cliente estiver em
execução, este se desconecta e reinicia a conexão com os novos servidores.
3.11.6 Gerenciamento da Conexão

Mesmo quando não há configuração de Hot-Standby, existe um controle da conexão de Domínios Remotos entre os
E3 Servers Clientes e Servidores. A conexão utiliza o protocolo REC, o mesmo utilizado entre o E3 Server, Elipse
Power Viewer e Elipse Power Studio. Assim, a porta de conexão do REC e as possíveis configurações de firewall
associadas também se aplicam aos Domínios Remotos.
Com a conexão estabelecida, espera-se que haja um Domínio executando. Neste processo, a conexão é refeita
sempre que houver algum problema. Após ser encontrado o Domínio executando, verifica-se o nome correto do
Domínio, bem como o login do usuário, se necessário.
Assim como acontece com as conexões REC do Elipse Power Studio e do Elipse Power Viewer, as estatísticas de
comunicação das conexões de Domínios Remotos podem ser visualizadas na janela de Estatísticas do E3 Server,
acessíveis através do ícone do E3 Admin na Área de Notificações do Windows.
3.11.7 Desconexão
O Domínio Cliente pode não conseguir estabelecer a conexão com o Domínio Servidor por uma série de motivos.
Entre estes estão:
· O computador do Cliente ou do Servidor está fora da rede
· O Servidor não está executando o E3 Server
· O E3 Server do Servidor não está com o Domínio correto, ou o Domínio não foi iniciado
· O Domínio Servidor não aceita o usuário especificado pelo Domínio Cliente
· O E3 Server do Cliente ou do Servidor não possui licença de Domínio Remoto
· O E3 Server do Servidor é de uma versão antiga (2.5 ou inferior)
· Existe um firewall bloqueando a porta TCP/IP utilizada pelo REC, ou o Cliente e o Servidor estão usando portas
TCP/IP diferentes
· O apelido do Domínio não existe na configuração de Domínio Remoto
Quando uma destas situações ocorrer, todos os Links do Cliente referenciando o Domínio são desconectados, assim
como todos os métodos Application.GetObject referenciando o Domínio Remoto falham, ou seja, causam erros de
script. Quando o problema for resolvido, os Links devem conectar-se automaticamente. Já os comandos de
Application.GetObject devem ser executados novamente.
3.12 Gerando Logs no Elipse Power

O Elipse Power registra todos os eventos significativos de sua operação em logs no formato ETL (Event Trace Log).
Estes logs guardam informações sobre o funcionamento dos sistemas da Elipse Software, tais como o consumo de
memória do computador e operações de bancos de dados, entre outras. Os arquivos de log são salvos na pasta c:
\eelogs\e3, criada durante o processo de instalação, conforme a figura a seguir.
Domínios 116
Pasta de logs do Elipse Power
O nome de um arquivo de log informa o tipo e o ano, mês e dia de sua criação. Os tipos principais são Elipse Power,
PowerEngine e IOData, este último registrando dados da comunicação com equipamentos.
Estes arquivos de log são gerenciados por uma ferramenta da Elipse Software chamada Elipse Event Log Viewer,
disponível com a instalação do Elipse Power. Com esta ferramenta é possível visualizar os arquivos e gerenciar o
espaço que estes ocupam em disco, entre outras configurações. Para mais informações sobre o Elipse Event Log
Viewer, consulte o Manual do Usuário do Elipse Event Log, disponível no menu Iniciar - Programas - Elipse
Software - Elipse Event Log. O Elipse Event Log Viewer pode ser aberto das seguintes formas:
· Pelo menu Iniciar - Programas - Elipse Software - Elipse Event Log - Log Viewer
· Pelo menu Ferramentas - Log Viewer do Elipse Power Studio
· Pelo item Atalhos - Log Viewer do menu contextual do E3 Admin na Área de Notificação do Windows
117 Domínios
CAPÍTULO
Objeto Configuração do Power
4
O objeto Configuração do Power é essencial para o funcionamento das aplicações criadas no Elipse Power. Através
deste objeto é possível realizar a modelagem elétrica do sistema, bem como utilizar ferramentas para a geração
automática da aplicação, tanto no que diz respeito à parte de objetos de dados como de Telas. Este objeto também
possui um conjunto de configurações referentes à padronização de tipos de Medidas, tipos de Comandos, tipos de
Proteções, níveis de tensão, cores de Displays e cores de Chaves ou Disjuntores.
4.1 Definição de Padrões

A criação de padrões permite uma significativa redução do tempo de engenharia, facilitando o desenvolvimento de
novas aplicações e a expansão e manutenção de aplicações já existentes. Os tópicos a seguir apresentam os
diferentes tipos de padrões disponíveis no objeto Configuração do Power, e como cada um deles deve ser
configurado para o correto funcionamento da aplicação.
4.1.1 Padronização dos Tipos de Medidas Analógicas

O primeiro conceito de padronização do Elipse Power diz respeito aos tipos de Medidas Analógicas. Entende-se por
tipo de Medida as diferentes medições existentes na aplicação, como por exemplo Potência Ativa, Tensão de Linha
entre Fase A-B, Corrente na Fase A, Temperatura do Óleo, etc. O tipo de Medida pode concatenar a grandeza física
amostrada (por exemplo, "Potência Ativa [W]" ou "Temperatura [°C]") com a localização do medidor (por exemplo,
"Fase A" ou "Óleo").
Com a utilização do conceito de padrão de Medida, o usuário reaproveita a configuração de unidade da grandeza
amostrada (por exemplo, "V", "°C", "W", "Wh", "A", etc.) da fase elétrica onde a Medida está sendo amostrada e da
descrição da Medida (por exemplo, "Potência Ativa Trifásica"). Com isto, quando o usuário instanciar uma Medida na
aplicação (por exemplo, "Tensão no Terminal do Gerador"), esta Medida deve apenas apontar para este padrão para
receber as configurações adotadas pelo padrão relacionado. Desta forma, se o usuário quiser, por exemplo, alterar a
descrição da Medida, basta realizá-lo no padrão que automaticamente todas as Medidas que referenciarem este
padrão são atualizadas.
Alguns padrões são disponibilizados pelo próprio instalador do Elipse Power e não permitem que seus nomes, Fases
Elétricas e Unidades de Engenharia sejam alterados. Estes padrões nativos do Elipse Power possuem o prefixo
reservado "*" e não podem ser removidos da lista de padrões. Algumas destas Medidas com prefixo "*" podem ser
utilizadas por algoritmos específicos disponíveis no Elipse Power (por exemplo, Fluxo de Potência, Processador
Topológico e Estimador de Estado) ou pela biblioteca de objetos de Tela do Elipse Power, e por isto foram definidas
como nativas. Os tipos de Medidas Analógicas podem ser configurados em tempo de execução no objeto retornado
pela propriedade AnalogTypes do objeto Configuração do Power. A figura a seguir apresenta a aba Analógicas,
para criação e edição dos padrões de Medidas Analógicas.
Aba Analógicas
Objeto Configuração do Power 118

A barra de ferramentas desta aba contém as opções Adicionar , para criação de um novo tipo de Medida
Analógica, Remover , para excluir um tipo de Medida Analógica criada pelo usuário, e Ordenar , para ordenar a
visualização da lista de tipos de Medidas Analógicas.
As colunas campos de cada padrão de Medida Analógica estão apresentadas na tabela a seguir.
Colunas da área de edição dos padrões de Medidas Analógicas
COLUNA DESCRIÇÃO
Nome Nome do padrão. Só pode ser editado em padrões
criados pelo usuário, que não podem conter o caractere
reservado "*" como prefixo. Corresponde à propriedade
Name do objeto Tipo de Medida Analógica
Fase Elétrica Fase elétrica onde a Medida está sendo amostrada ou o

Comando está atuando. Permite os seguintes valores:
· -1 - epNone: A Medida ou o Comando não está
relacionado a nenhuma fase do sistema elétrico
(padrão)
· 0 - epABC: A Medida ou o Comando está relacionado
às três fases do sistema elétrico
· 1 - epA: A Medida ou o Comando está relacionado à
fase A do circuito elétrico
· 2 - epB: A Medida ou o Comando está relacionado à
fase B do circuito elétrico
· 3 - epC: A Medida ou o Comando está relacionado à
fase C do circuito elétrico
· 4 - epNeutral: A Medida ou o Comando está
relacionado ao neutro do circuito elétrico
· 5 - epAB: A Medida ou o Comando está relacionado às
fases A e B do circuito elétrico
· 6 - epBC: A Medida ou o Comando está relacionado às
fases B e C do circuito elétrico
· 7 - epCA: A Medida ou o Comando está relacionado às
fases C e A do circuito elétrico
· 8 - epDevice: A Medida ou o Comando está
relacionado às mesmas fases às quais o equipamento
está conectado
Corresponde à propriedade Phase do objeto Tipo de
Medida Analógica
Descrição Descrição do tipo da Medida. Este texto pode ser

utilizado para descrever a Medida apresentada em um
Display, identificar uma mensagem de alarme ou
descrever uma Pena em um gráfico. É possível utilizar
expressões nesta coluna. Corresponde à propriedade
Caption do objeto Tipo de Medida Analógica
Unidade Texto da unidade de engenharia referente ao tipo de

Medida. Não é recomendado o uso de multiplicadores
(por exemplo, Quilo, Mega, Giga, etc.), pois tais
multiplicadores devem ser configurados na instância da
Medida e não no seu padrão. Corresponde à propriedade
Unit do objeto Tipo de Medida Analógica
Mín. UE Valor mínimo da unidade de engenharia deste tipo de

Medida. Corresponde à propriedade EuLow do objeto
Tipo de Medida Analógica
Máx. UE Valor máximo da unidade de engenharia deste tipo de

Medida. Corresponde à propriedade EuHigh do objeto
Tipo de Medida Analógica
119 Objeto Configuração do Power

COLUNA DESCRIÇÃO
Ordenação Número inteiro que pode ser utilizado para ordenar, de
forma alternativa à alfabética, os tipos de medidores. Este
número é útil caso seja necessário apresentar as Medidas
em uma tabela com uma ordem determinada de
apresentação (por exemplo, Tensão antes de Potência
Ativa) que não seja a alfabética. Esta ordenação é utilizada
se a propriedade SortMode do objeto PowerExplorer
estiver configurada para 1 - smTypeSorting. Corresponde
à propriedade Order do objeto Tipo de Medida Analógica
NOTA
Os tipos de Medida padrão podem ter apenas as colunas Descrição e Ordenação modificadas.
4.1.2 Padronização dos Tipos de Medidas Discretas

A padronização de Medidas Discretas segue o mesmo conceito introduzido para a padronização das Medidas
Analógicas, porém com uma diferença: as Medidas Discretas permitem transformar valores em algo que tenha
significado para o operador do sistema. Um exemplo típico são valores que informam o estado de um Disjuntor
(aberto ou fechado), onde o valor coletado pelo sistema de automação pode ser, por exemplo, 0 (zero) ou 1 (um).
Do ponto de vista do operador do sistema, 0 (zero) pode não possuir significado algum, e como consequência, o
operador pode não ter certeza sobre o estado atual do equipamento. Além disto, em um mesmo sistema de
automação podem existir diferentes equipamentos, de diferentes fabricantes, onde em um deles 0 (zero) significa
aberto e em outro este valor significa fechado.
Para resolver este problema, o Elipse Power disponibiliza um ambiente que permite tanto definir os tipos de pontos
discretos existentes na aplicação (Estado de chaves, Estado de disjuntores, Funções de proteção, Indicações de
atuações de proteções, etc.), quanto relacionar um significado para cada possível valor que tal Medida Discreta possa
apresentar. Os tipos de Medidas Discretas podem ser configurados em tempo de execução no objeto retornado pela
propriedade DiscreteTypes do objeto Configuração do Power. A figura a seguir apresenta a aba Discretas, para
criação e edição dos padrões de Medidas Discretas.
Aba Discretas

A aba de configuração de padrões de Medidas Discretas é dividida em três áreas, cada uma com uma função
específica. A primeira, apresentada na figura a seguir, serve para criar ou editar novos tipos de Medidas Discretas
(por exemplo, Estado do Disjuntor, Função Religamento, etc.).
Área de edição dos tipos de Medidas Discretas

A barra de ferramentas desta área contém as opções Adicionar , para criação de um novo tipo de Medida Discreta,
Remover , para excluir um tipo de Medida Discreta criada pelo usuário, e Ordenar , para ordenar a visualização
da lista de tipos de Medidas Discretas.
As colunas de cada tipo de Medida Discreta estão apresentadas na tabela a seguir.
Colunas da área de edição dos padrões de Medidas Discretas
COLUNA DESCRIÇÃO
Nome Nome do padrão. Só pode ser editado em padrões
Name do objeto Tipo de Medida Discreta
Fase Elétrica Fase elétrica onde a Medida está sendo amostrada ou o

Comando está atuando. Permite os seguintes valores:
· -1 - epNone: A Medida ou o Comando não está
relacionado a nenhuma fase do sistema elétrico
· 0 - epABC: A Medida ou o Comando está relacionado
às três fases do sistema elétrico
· 1 - epA: A Medida ou o Comando está relacionado à
fase A do circuito elétrico
· 2 - epB: A Medida ou o Comando está relacionado à
fase B do circuito elétrico
· 3 - epC: A Medida ou o Comando está relacionado à
fase C do circuito elétrico
· 4 - epNeutral: A Medida ou o Comando está
relacionado ao neutro do circuito elétrico
· 5 - epAB: A Medida ou o Comando está relacionado às
fases A e B do circuito elétrico
· 6 - epBC: A Medida ou o Comando está relacionado às
fases B e C do circuito elétrico
· 7 - epCA: A Medida ou o Comando está relacionado às
fases C e A do circuito elétrico
· 8 - epDevice: A Medida ou o Comando está
relacionado às mesmas fases às quais o equipamento
está conectado
Corresponde à propriedade Phase do objeto Tipo de
Medida Discreta

COLUNA DESCRIÇÃO
Descrição Descrição do tipo da Medida. Esse texto pode ser
utilizado para descrever a Medida apresentada em um
descrever uma Pena em um gráfico. É possível utilizar
expressões nesta coluna. Corresponde à propriedade
Caption do objeto Tipo de Medida Discreta

forma alternativa à alfabética, os tipos de medidores. Este
número é útil caso seja necessário apresentar as Medidas
em uma tabela com uma ordem determinada de
apresentação que não seja a alfabética. Esta ordenação é
utilizada se a propriedade SortMode do objeto
PowerExplorer estiver configurada para 1 -
smTypeSorting. Corresponde à propriedade Order do
objeto Tipo de Medida Discreta
A segunda área deve ser utilizada pelo usuário para cadastrar ou selecionar os diferentes tipos de Conversões que
possam existir no sistema. As Conversões estão relacionadas às características construtivas do sistema de automação
e permitem que o Elipse Power suporte diferentes formas de interpretar valores provenientes de campo. A figura a
seguir apresenta a área de criação ou edição de Conversões.
Área de criação ou edição de Conversões

Ações relacionadas às Conversões na área inferior da aba
AÇÃO DESCRIÇÃO
Nova Adiciona uma nova Conversão ao tipo de Medida
Discreta selecionada na área superior da aba. Só é
permitido criar Conversões em Medidas que possuam
pelo menos um Significado criado
Renomear Renomeia a Conversão selecionada na caixa de seleção.

Só é permitido renomear Conversões criadas por
usuários
Remover Remove a Conversão selecionada na caixa de seleção. Só

é permitido remover Conversões criadas por usuários
A terceira e última área é utilizada para criar ou editar os possíveis Estados ou Significados da Medida Discreta (por
exemplo, uma chave na posição Aberta, Fechada, Intermediária ou Inválida), bem como relacioná-los ao valor da Fonte
(disponibilizado por um CLP, UTR, IED, etc.) para realizar a conversão em tempo de execução. Os valores das Fontes
podem variar em função da Conversão selecionada na segunda área, enquanto os Significados e descrições são fixos
para todas as Conversões e dependem apenas do tipo da Medida Discreta. A figura a seguir apresenta a área de
criação ou edição de Estados ou Significados.
Área de criação ou edição de Estados ou Significados

A barra de ferramentas de criação de Significados permite que o usuário realize as ações apresentadas na tabela a
seguir.

Ações relacionadas aos Estados ou Significados na área inferior da aba
COMANDO DESCRIÇÃO
Adicionar Adiciona um Significado à lista de possíveis estados da
Medida Discreta
Remover Exclui um Significado da lista de possíveis estados da

Medida Discreta
Mover para Cima Move para cima um determinado Significado da lista.

Esta ação altera o valor que este Estado tem na
aplicação
Mover para Baixo Move para baixo um determinado Significado da lista.

Esta ação altera o valor que este Estado tem na
aplicação
As colunas de cada Significado são apresentadas na tabela a seguir.

Colunas da área de edição dos Significados de Medidas Discretas
COLUNA DESCRIÇÃO
Significado Atribui um Significado para cada Estado possível que a
Medida Discreta pode apresentar em campo.
Corresponde à propriedade Name do objeto Semântica
Descrição Descrição do Estado. Este texto pode ser usado em

mostradores, alarmes e tabulares de Medidas para
descrever o Estado da variável. Corresponde à
propriedade Caption do objeto Semântica
Valor no aplicativo Indica o valor que a Medida Discreta tem dentro da

aplicação quando estiver neste Estado. Serve para
padronizar os valores discretos, independente das
Conversões utilizadas. Por exemplo, Chave Aberta tem
sempre valor igual a 0 (zero) dentro da aplicação
Valor na Fonte Valor que a Fonte (por exemplo, um Tag de

Comunicação) deve apresentar para indicar que seu
Estado é igual ao cadastrado na coluna Significado ou
Descrição. NOTA: O único valor que deve variar entre as
Conversões é a coluna Valor na Fonte, pois tanto a
coluna Significado quanto a coluna Valor no Aplicativo
são iguais em todas as Conversões
NOTAS
A coluna Significado é editável e o seu valor deve obedecer às seguintes regras:
· Deve ser único
· Não pode ser uma String vazia
· Não pode conter os caracteres especiais [ (colchete esquerdo), ] (colchete direito), \ (barra invertida), / (barra), :
(dois pontos), " (aspas duplas) e ? (ponto de interrogação)
· Não pode ser uma das seguintes palavras reservadas: "True", "False", "Nothing", "Empty" ou "Application"
· No caso de aplicativos já existentes, o valor desta coluna é baseado no valor da coluna Descrição, aplicando os
ajustes necessários para satisfazer as regras. Se a coluna Descrição não estiver definida, é criado um valor padrão
"Semantica"
4.1.3 Padronização dos Tipos de Comandos

O cadastro dos Tipos de Comandos deve ser realizado na aba Comandos do objeto Configuração do Power. Alguns
exemplos de Tipos de Comandos são: posição de disjuntor, posição de tap de transformador e troca no modo de
operação da proteção, entre outros.
Assim como na padronização dos Estados ou Significados das Medidas Discretas, cada Tipo de Comando pode ter
uma ou várias Ações de Comando. Exemplos de requisições de ações são Subir posição de tap, Abrir chave e

Habilitar função de religamento. Os Tipos de Comandos podem ser configurados em tempo de execução no objeto
retornado pela propriedade CommandTypes do objeto Configuração do Power. A figura a seguir mostra a aba de
configuração de padrões de Comandos.
Aba de configuração de padrões de Comandos

A aba de configuração de padrões de Comandos está dividida em quatro áreas distintas. A primeira, apresentada na
figura a seguir, serve para criar ou editar os Tipos de Comandos existentes na aplicação.
Área de configuração dos tipos de Comandos

A barra de ferramentas desta área contém as opções Adicionar , para criação de um novo tipo de Comando
(permite adicionar tanto Comandos Discretos quanto Comandos de Passo), Remover , para excluir um tipo de
Comando criado pelo usuário, e Ordenar , que ordena a visualização da lista de tipos de Comandos.
A segunda área, chamada de Conversões, serve para o usuário cadastrar os diferentes valores de escrita que cada
Ação de Comando pode ter. Por exemplo, o comando de Abrir um Disjuntor pode ter que escrever o valor
"129" (TRIP-Pulse On), se executado via protocolo DNP3, ou escrever o valor "0" (Single Command), se esta ação é via
protocolo IEC 870-5-104. A figura a seguir apresenta a área de criação ou edição de Conversões.
Área de criação ou edição de Conversões de Comandos

Ações relacionadas às Conversões
AÇÃO DESCRIÇÃO
Nova Adiciona uma nova Conversão ao tipo de Comando
selecionado na área superior da aba

AÇÃO DESCRIÇÃO
Renomear Renomeia a Conversão selecionada na caixa de seleção.
Só é permitido renomear Conversões criadas por
usuários
Remover Remove a Conversão selecionada na caixa de seleção. Só

é permitido remover Conversões criadas por usuários
A terceira área, apresentada na figura a seguir, permite que o usuário crie novas Ações de Comando, que determinam
características de um Comando que são utilizadas nas Unidades de Comando. Também é permitido nesta área que o
usuário altere os valores que podem variar em relação à Conversão selecionada.
Área de criação ou configuração das Ações de Comando

A barra de ferramentas desta área tem as opções Adicionar , para criação de uma nova Ação de Comando, e
Remover , para excluir uma Ação de Comando criada pelo usuário. Ambas ferramentas só são acessíveis em Tipos
de Comandos criados pelo usuário (sem o prefixo "*" no nome).
Os campos disponíveis para edição na terceira área são apresentados na tabela a seguir.
Campos de edição de Ações de Comando
CAMPO DESCRIÇÃO
Select automático antes de Operate Se Verdadeiro, toda vez que o objeto de Comando
receber uma chamada do método Operate, primeiro é
executado o script cadastrado no evento OnSelect, e
depois é executado o script cadastrado no evento
OnOperate. Esta opção corresponde à propriedade
AutoSelect do objeto Conversão
Tempo limite de feedback (ms) Tempo, em milissegundos, que a rotina de verificação de

execução do Comando espera para constatar se o
Comando foi realizado com sucesso ou não. Este tempo
deve ser dimensionado conforme a qualidade do link de
comunicação e o atraso de transporte. Este valor é
opcional e deve ser utilizado apenas se o usuário
necessita tratar erros de execução de Comandos. Para
verificar o valor de retorno, use as propriedades
OperateFeedbackTag, CancelFeedbackTag ou
SelectFeedbackTag, configuradas no objeto Comando.
Esta opção corresponde à propriedade
FeedbackTimeout do objeto Conversão
Máximo de retentativas Indica o número de retentativas de execução do

Comando (além da tentativa inicial). A retentativa ocorre
enquanto o limite estabelecido nesta propriedade não é
atingido e a Ação de Comando não foi terminada com
sucesso, cancelada ou abortada. Esta opção
corresponde à propriedade MaxRetries do objeto
Conversão
Tempo entre retentativas (ms) Indica o tempo, em milissegundos, entre as retentativas

de execução de um Comando. Se este valor for igual a 0
(zero), a retentativa é executada o mais rápido possível.
Esta opção corresponde à propriedade RetryPeriod do
objeto Conversão

CAMPO DESCRIÇÃO
Nome Nome da Ação de Comando. Este valor só pode ser
modificado em Ações criadas pelo usuário. Este nome é
utilizado no objeto Unidade de Comando para criar uma
associação das configurações de Comando. Esta opção
corresponde à propriedade Name do objeto Significado
Descrição Descrição da Ação de Comando. Este texto pode ser

usado em botões para explicitar qual a Ação que este
botão realiza. Por exemplo: "Abrir", "Fechar", "Habilitar",
"Desabilitar", etc. Esta opção corresponde à propriedade
Caption do objeto Significado
Operate Value Valor que deve ser escrito na propriedade

OperateWriteTag do objeto de Comando quando o
método Operate é chamado. Esta opção corresponde à
propriedade OperateValue do objeto Valores da
Conversão
Operate Feedback Valor que a propriedade OperateFeedbackTag

configurada no objeto de Comando deve apresentar
após a execução do método Operate. Este valor é
necessita tratar erros de execução de Comandos. Esta
opção corresponde à propriedade
OperateFeedbackValue do objeto Valores da Conversão
Select Value Valor que deve ser escrito na propriedade

SelectWriteTag do objeto de Comando quando o
método Select é chamado. Esta propriedade só deve ser
configurada quando o Comando é do tipo Select ou
Operate. Esta opção corresponde à propriedade
SelectValue do objeto Valores da Conversão
Select Feedback Valor que a propriedade SelectFeedbackTag

após a execução do método Select. Este valor é opcional
e deve ser utilizado apenas se o usuário necessita tratar
erros de execução de Comandos. Esta opção
corresponde à propriedade SelectFeedbackValue do
objeto Valores da Conversão
Cancel Value Valor que deve ser escrito na propriedade

CancelWriteTag do objeto de Comando quando o
método Cancel é chamado. Esta propriedade só deve
ser configurada quando o Comando é do tipo Select ou
Operate. Esta opção corresponde à propriedade
CancelValue do objeto Valores da Conversão
Cancel Feedback Valor que a propriedade CancelFeedbackTag

após a execução do método Cancel. Este valor é
necessita tratar erros de execução de Comandos. Esta
CancelFeedbackValue do objeto Valores da Conversão
A quarta e última área, apresentada na figura a seguir, permite que o usuário defina os scripts que são realizados
quando os métodos Operate, Select e Cancel são chamados nos objetos de Comando.

Área de definição dos scripts de Comando
A descrição das ferramentas da área de criação de scripts de Comando está na tabela a seguir.
Barra de ferramentas para scripts de Comando
COMANDO DESCRIÇÃO
Adicionar Adiciona um script ao evento selecionado na caixa de
seleção
Remover Exclui o script do evento selecionado na caixa de

seleção
AppBrowser Abre o AppBrowser
Procurar Procura por palavras no script
Procurar Anterior Procura a ocorrência anterior de uma palavra
Procurar Próximo Procura a próxima ocorrência de uma palavra
Substituir Substitui ocorrências de uma palavra
Compilar Script Verifica os scripts do evento corrente
Compilar Scripts da Conversão Verifica todos os scripts da Conversão corrente
Compilar Scripts do Comando Verifica todos os scripts do Comando corrente
A caixa de seleção permite que o usuário escolha o evento a ser editado. A tabela a seguir contém a descrição dos
eventos disponíveis para edição.
Eventos disponíveis nos Comandos
EVENTO DESCRIÇÃO
OnOperate Define o que é executado quando o método Operate
disponível na instância do objeto de Comando é
chamado. A tarefa mais básica realizada neste evento é a
escrita do valor OperateValue (configurado na área de
Ações de Comandos) na propriedade OperateWriteTag
(configurada no objeto de Comando)
OnSelect Define o que é executado quando o método Select,

disponível na instância do objeto de Comando, é
escrita do valor SelectValue (configurado na área de
Ações de Comandos) na propriedade SelectWriteTag
OnCancel Define o que é executado quando o método Cancel,

disponível na instância do objeto de Comando, é
escrita do valor CancelValue (configurado na área de
Ações de Comandos) na propriedade CancelWriteTag

EVENTO DESCRIÇÃO
OnOperateFinished Evento acionado quando a propriedade
OperateFeedbackTag (configurada no objeto de
Comando) apresentar o valor igual ao campo Operate
Feedback (configurado na área de Ações de Comandos).
Este evento também ocorre nas seguintes situações:
término do tempo limite de feedback, pedido de
cancelamento do Comando, ou falha na execução do
método Operate. Este evento pode ser utilizado para
gerar logs e mensagens de status da operação
OnSelectFinished Evento acionado quando a propriedade

SelectFeedbackTag (configurada no objeto de
Comando) apresentar o valor igual ao campo Select
Este evento também ocorre nas seguintes situações:
término do tempo limite de feedback, pedido de
cancelamento do Comando, ou falha na execução do
método Select. Este evento pode ser utilizado para gerar
logs e mensagens de status da operação
OnCancelFinished Evento acionado quando a propriedade

CancelFeedbackTag (configurada no objeto de
Comando) apresentar o valor igual ao campo Cancel
Este evento também ocorre no término do tempo limite
de feedback ou quando uma falha for detectada na
execução do método Cancel. Este evento pode ser
utilizado para gerar logs e mensagens de status da
operação
Cada evento possui um conjunto de parâmetros que permite que o script acesse tanto valores configurados na área
de criação ou configuração das Ações de Comando, quanto valores passados via chamada de métodos em tempo de
execução. Estes parâmetros são apresentados na tabela a seguir.
Parâmetros disponíveis nos scripts de métodos e eventos dos Comandos
PARÂMETRO DESCRIÇÃO
ActorID Disponibiliza para o script o nome do usuário que
requisitou o Comando. Este valor deve ser passado como
parâmetro na chamada dos métodos Operate, Select e
Cancel dos objetos de Comando
WriteValue Este parâmetro disponibiliza os valores configurados na

área de criação de Ações de Comando para os eventos
OnOperate, OnSelect e OnCancel:
· No evento OnOperate, este parâmetro possui o valor
do campo Operate Value
· No evento OnSelect, este parâmetro possui o valor do
campo Select Value
· No evento OnCancel, este parâmetro possui o valor do
campo Cancel Value
FeedbackValue Este parâmetro disponibiliza os valores configurados na

área de criação de Ações de Comando para os eventos
OnOperate, OnSelect e OnCancel:
· No evento OnOperate, este parâmetro possui o valor
do campo Operate Feedback
· No evento OnSelect, este parâmetro possui o valor do
campo Select Feedback

PARÂMETRO DESCRIÇÃO
· No evento OnCancel, este parâmetro possui o valor do
campo Cancel Feedback
Failed Booleano utilizado para indicar a detecção de falhas nos

scripts dos eventos. Este parâmetro pode ser preenchido
nos eventos OnOperate, OnSelect e OnCancel, e pode
ser tratado nos eventos OnOperateFinished,
OnSelectFinished e OnCancelFinished
Canceled Booleano disponível nos eventos OnOperateFinished e

OnSelectFinished para indicar que a finalização do
Comando foi provocada por uma chamada do método
Cancel
FeedbackError Booleano disponível nos eventos OnOperateFinished,

OnSelectFinished e OnCancelFinished para indicar que a
finalização do Comando foi provocada por time-out
(FeedbackError igual a Verdadeiro)
ScriptError Booleano disponível nos eventos OnOperateFinished,

OnSelectFinished e OnCancelFinished para indicar que
ocorreu erro de script
Para acessar valores da instância do objeto de Comando nos scripts de eventos, utilize a expressão
Application.GetObject, informando a propriedade que deseja acessar. Exemplo:
Set Tag = Application.GetObject(OperateWriteTag)
4.1.4 Padronização dos Tipos de Proteções

O cadastro dos tipos de Proteções deve ser realizado na aba Proteções do objeto Configuração do Power. Algumas
Proteções já são fornecidas por padrão pelo Elipse Power, como Proteção de Sobrecorrente, Proteção de Subtensão,
etc. Além das existentes, também é possível criar novas Proteções. Os tipos de Proteções podem ser configurados em
tempo de execução no objeto retornado pela propriedade ProtectionTypes do objeto Configuração do Power.
A figura a seguir apresenta a aba de criação e edição dos padrões de Proteções.

Aba Proteções
A barra de ferramentas desta aba contém as opções Adicionar , para criação de um novo tipo de Proteção,
Remover , para excluir um tipo de Proteção criado pelo usuário, e Ordenar , para ordenar a visualização da lista
de tipos de Proteções.
As colunas de cada padrão de Proteção são apresentadas na tabela a seguir.
Colunas de edição dos padrões de Proteção
COLUNA DESCRIÇÃO
Nome Nome do Padrão. Só pode ser editado em padrões
Name do objeto Tipo de Proteção
Sigla Texto livre que configura uma sigla especificando o tipo

de Proteção. Esta propriedade pode ser alterada mesmo
em Proteções fornecidas automaticamente pelo Elipse
Power. Corresponde à propriedade Acronym do objeto
Tipo de Proteção
Descrição Descrição do tipo de Proteção. Este texto pode ser

utilizado para descrever a Proteção apresentada em um
qualquer outra visualização desejada. Corresponde à
propriedade Caption do objeto Tipo de Proteção

forma alternativa à alfabética, os tipos de Proteções. Este
número é útil caso seja necessário apresentar as
Proteções em uma tabela, com uma ordem determinada
de apresentação que não seja a alfabética. Esta
ordenação é utilizada se a propriedade SortMode do
objeto PowerExplorer estiver configurada para 1 -
smTypeSorting. Corresponde à propriedade Order do
objeto Tipo de Proteção

NOTA
Os tipos de Proteção padrão podem ter apenas as colunas Sigla, Descrição e Ordenação modificadas.
4.1.5 Padronização dos Níveis de Tensão

A aba Tensões permite que o usuário configure as cores dos equipamentos em função de suas tensões nominais
(propriedade BaseVoltage). Estas cores são acessíveis em tempo de execução nas propriedades VoltageColor dos
Terminais, são usadas pelo Modelador Elétrico durante a edição e podem ser configuradas em tempo de execução
no objeto retornado pela propriedade VoltageColors do objeto Configuração do Power. A cor do nível (padrão) é
utilizada quando algum equipamento apresentar uma tensão inexistente em sua tabela de cores. A aba de cadastro
dos níveis de tensão é apresentada na figura a seguir.
Aba Tensões
A barra de ferramentas desta aba contém as opções Adicionar , para criação de um novo nível de tensão, Remover
, para excluir um nível de tensão, e Ordenar , para ordenar a visualização da lista de níveis de tensão.
As colunas disponíveis para edição dos níveis de tensão são apresentadas na tabela a seguir.
Colunas de edição dos níveis de tensão
COLUNA DESCRIÇÃO
Tensão Nominal (kV) Valor, em kV, do nível de tensão cadastrado.
Corresponde à propriedade NominalVoltage do objeto
Cor de Tensão
Cor energizada Cor referente ao nível de tensão cadastrado, quando o

Terminal está energizado. Corresponde à propriedade
ColorEnergized do objeto Cor de Tensão
Seguir cor energizada Quando esta opção é selecionada, a cor desenergizada

desta tensão é um tom mais escuro da cor selecionada
na opção Cor energizada. Corresponde à propriedade
FollowEnergized do objeto Cor de Tensão
Cor não-energizada Cor referente ao nível de tensão cadastrado, quando o

Terminal não está energizado. Esta opção só pode ser
configurada se a opção Seguir cor energizada estiver
desmarcada. Corresponde à propriedade
ColorDeEnergized do objeto Cor de Tensão
4.1.6 Padronização das Cores dos Estados de Chaves e Disjuntores

A aba Chaves/Disjuntores permite que o usuário configure as cores retornadas nas propriedades StateColor dos
objetos Chave e Disjuntor, de acordo com seu estado. A aba de configuração das cores das Chaves e Disjuntores é
apresentada na figura a seguir.

Aba Chaves/Disjuntores
As colunas disponíveis para edição das cores das Chaves e Disjuntores estão descritos na tabela a seguir.
Colunas de edição de cores das Chaves e Disjuntores
COLUNA DESCRIÇÃO
Estado da Chave / Disjuntor Descreve o estado da Chave ou Disjuntor. Esta coluna é
somente de leitura
Valor no aplicativo Valor apresentado pelo medidor de estados de Chaves e

Disjuntores quando o equipamento está no respectivo
estado. Esta coluna é somente de leitura
Cor (qualidade boa) Cor apresentada pela Chave ou Disjuntor no diagrama

quando a Medida indica o respectivo estado com
qualidade de comunicação boa (propriedade Quality do
Tag maior ou igual a 192)
Cor (qualidade ruim) Cor apresentada pela Chave ou Disjuntor no diagrama

quando a Medida indica o respectivo estado com
qualidade de comunicação ruim (propriedade Quality do
Tag menor que 192)
As cores dos estados e suas respectivas qualidades podem ser configuradas por script usando o objeto retornado
pela propriedade SwitchGearColors do objeto Configuração do Power, conforme a tabela a seguir.
Opções de configuração de cores para estados de Chaves e Disjuntores
ESTADO QUALIDADE COR PADRÃO DESCRIÇÃO
Aberto Boa Verde ou RGB(0, 255, 0) Corresponde à
propriedade
ColorOpenGood do objeto
Cores dos Estados de
Chaves ou Disjuntores
Aberto Ruim Verde escuro ou RGB(0, Corresponde à

128, 0) propriedade
ColorOpenBad do objeto
Fechado Boa Vermelho ou RGB(255, 0, 0) Corresponde à

propriedade
ColorClosedGood do
objeto Cores dos Estados
de Chaves ou Disjuntores
Fechado Ruim Vermelho escuro ou Corresponde à

RGB(128, 0, 0) propriedade
ColorClosedBad do objeto

ESTADO QUALIDADE COR PADRÃO DESCRIÇÃO
Intermediário Boa Amarelo ou RGB(255, 255, Corresponde à
128) propriedade
ColorIntermediateGood do
Intermediário Ruim Oliva ou RGB(128, 128, 64) Corresponde à

propriedade
ColorIntermediateBad do
Inválido Boa Branco ou RGB(255, 255, Corresponde à

255) propriedade
ColorInvalidGood do
Inválido Ruim Cinza ou RGB(128, 128, 128) Corresponde à

propriedade
ColorInvalidBad do objeto
4.1.7 Padronização das Cores das Medidas

A aba Medidas permite que o usuário configure as cores retornadas, em tempo de execução, nas propriedades
MeasurementColor das Medidas e Fontes de Medida, de acordo com seu estado. Esta tabela de cores pode ser
configurada em tempo de execução no objeto retornado pela propriedade MeasurementColors do objeto
Configuração do Power. A aba de configuração das cores das Medidas é apresentada na figura a seguir.
Aba Medidas
As colunas disponíveis para edição das cores dos Displays estão descritas na tabela a seguir.
Colunas de edição das cores dos Displays de Medidas
COLUNA DESCRIÇÃO
Estado da Medida Descreve o estado do medidor, que considera quatro
diferentes possibilidades: Normal (qualidade boa),
Alarme não-reconhecido, Alarme reconhecido e
Qualidade ruim. Esta propriedade é somente de leitura
Cor Cor mostrada quando o medidor estiver no respectivo

estado
Pisca? Indica se o Display deve piscar quando o medidor estiver

no respectivo estado
As cores dos estados das Medidas e suas respectivas informações de pisca podem ser configuradas por script
usando o objeto retornado pela propriedade MeasurementColors do objeto Configuração do Power, conforme as
tabelas a seguir.

Opções de configuração de cores para os estados das Medidas
ESTADO COR PADRÃO DESCRIÇÃO
Normal (qualidade boa) Amarelo ou RGB(255, 255, 0) Corresponde à propriedade
ColorNormal do objeto Cores de
Medidas
Alarme não-reconhecido Vermelho ou RGB(255, 0, 0) Corresponde à propriedade

ColorNAck do objeto Cores de
Medidas
Alarme reconhecido Azul ou RGB(0, 0, 255) Corresponde à propriedade

ColorAlarm do objeto Cores de
Medidas
Qualidade ruim Branco ou RGB(255, 255, 255) Corresponde à propriedade

ColorBad do objeto Cores de
Medidas
Opções de pisca para os estados das Medidas

ESTADO PADRÃO DE PISCA DESCRIÇÃO
Normal (qualidade boa) Falso Corresponde à propriedade
BlinkNormal do objeto Cores de
Medidas
Alarme não-reconhecido Verdadeiro Corresponde à propriedade

BlinkNAck do objeto Cores de
Medidas
Alarme reconhecido Falso Corresponde à propriedade

BlinkAlarm do objeto Cores de
Medidas
Qualidade ruim Falso Corresponde à propriedade

BlinkBad do objeto Cores de
Medidas
4.2 Modelador Elétrico

A primeira etapa a ser seguida durante o processo de criação de uma nova aplicação no Elipse Power é a
identificação de todos os elementos e dispositivos que compõem o sistema elétrico a ser controlado. Durante esta
etapa, o programador da aplicação deve reunir todas as informações relevantes sobre o sistema, seus diagramas
unifilares, a nomenclatura dos componentes da rede elétrica e a interconexão entre eles. O nível de detalhamento de
tais informações vai depender dos módulos de análise elétrica adicionados à aplicação final do Elipse Power,
podendo ser mais ou menos detalhado conforme a necessidade do usuário.
O Elipse Power provê uma ferramenta completa de desenho e modelagem de redes de energia elétrica. Esta
ferramenta foi desenvolvida com a finalidade de oferecer ao usuário um ambiente único, que permita tanto visualizar
quanto cadastrar os dispositivos que constituem o sistema elétrico, suas interligações e seus parâmetros. Esta
ferramenta está à disposição do usuário através da aba Modelador Elétrico do objeto Configuração do Power,
conforme apresentado na figura a seguir.

Ferramenta de desenho e modelagem do sistema elétrico a ser controlado
NOTA
O Modelador Elétrico gera um arquivo no formato EDB, contendo todas as informações do sistema.
4.2.1 Barras de Ferramentas

O Modelador Elétrico possui barras de ferramentas que permitem tanto criar novos elementos elétricos quanto
navegar pelo sistema modelado. As barras de ferramentas disponíveis são Alinhamento e Grade, Geral, Bays e
Linhas de Transmissão e Elementos. A descrição das opções contidas nestas barras de ferramentas está disponível
nas tabelas a seguir.
Opções disponíveis na barra de ferramentas Alinhamento e Grade
OPÇÃO DESCRIÇÃO
Ativar ou Desativar Grade Ativa ou desativa a grade no ambiente de modelagem
Ativar ou Desativar Alinhar à Grade Ativa ou desativa o alinhamento de objetos em relação à

grade
Alinhar à Esquerda Alinha os objetos à esquerda
Alinhar à Direita Alinha os objetos à direita
Alinhamento Superior Alinha os objetos pelo topo
Alinhamento Inferior Alinha os objetos pela base
Alinhamento Central Horizontal Alinha os objetos horizontalmente pelo centro
Alinhamento Central Vertical Alinha os objetos verticalmente pelo centro
Alinhar à Grade Alinha os objetos à grade

Opções disponíveis na barra de ferramentas Geral
OPÇÃO DESCRIÇÃO
Voltar Volta ao elemento anterior no histórico de navegação
(BACKSPACE)
Avançar Avança para o próximo elemento no histórico de

navegação (ALT + Tecla de seta à direita)
Diagrama de Sistema Mostra o nível de Sistema da modelagem (ALT + HOME)
Selecionar Habilita o modo de seleção
Organizar Diagrama Automaticamente Agrupa os elementos simetricamente, de forma a

facilitar a visualização e a navegação
Localizar Elemento Permite localizar um elemento (CTRL + L). A pesquisa é

feita tanto pelo nome do elemento quanto pelo seu
nome parcial, mostrando uma lista com todos os
elementos encontrados. Ao clicar em OK ou selecionar
um elemento da lista, este elemento é selecionado no
Modelo Elétrico. NOTA: A pesquisa de elementos
considera apenas o nome de um elemento, e não o seu
caminho completo
Mostrar ou Esconder Descrição Mostra ou esconde o nome dos equipamentos na tela

de modelagem
Zoom de Área Aplica zoom em uma área específica
Enquadrar Enquadra o diagrama na área de desenho (CTRL +

Cinco ou CTRL + CLEAR). NOTA: O atalho de teclado
para esta opção, no teclado numérico, está disponível
somente quando a opção NUM LOCK está desabilitada
Mover Permite mover a área de desenho
Editor de Cabos Abre a janela Editor de Cabos utilizada nos

Alimentadores
Gerenciar Visualizações Esquemáticas Permite criar ou remover Visualizações Esquemáticas
Mostrar Visualizações Esquemáticas Mostra ou esconde as miniaturas das Visualizações

Esquemáticas existentes no Modelo Elétrico
Gerar Visualização Esquemática Gera as Visualizações Esquemáticas automaticamente.

NOTA: Esta ferramenta requer uma licença específica
para uso
Reconhecer Leiaute da Visualização Esquemática Reconhece o leiaute da Visualização Esquemática

selecionada, que foi alterado pela ferramenta de
sincronização apesar de estar selecionada a opção de
preservá-lo
Opções disponíveis na barra de ferramentas Bays e Linhas de Transmissão

OPÇÃO DESCRIÇÃO
Criar Bay com o(s) Equipamento(s) Selecionado(s) Cria um Bay com o(s) equipamento(s) selecionado(s)
Adicionar o(s) Equipamento(s) Selecionado(s) ao Bay Adiciona o(s) elemento(s) selecionado(s) ao Bay
Selecionado selecionado
Remover do Bay o(s) Equipamento(s) Selecionado(s) Remove do Bay o(s) equipamento(s) selecionado(s)
Criar Linha de Transmissão com o(s) Segmento(s) de Cria uma Linha de Transmissão com o(s) Segmento(s) de
Linha Selecionado(s) Linha selecionado(s)
Adicionar o(s) Segmento(s) de Linha Selecionado(s) à Adiciona o(s) Segmento(s) de Linha à Linha de
Linha de Transmissão Selecionada Transmissão selecionada

OPÇÃO DESCRIÇÃO
Remover da Linha de Transmissão o(s) Segmento(s) de Remove da Linha de Transmissão o(s) Segmento(s) de
Linha Selecionado(s) Linha selecionado(s)
Opções disponíveis na barra de ferramentas Elementos

OPÇÃO DESCRIÇÃO
Trancar ou Destrancar Ferramenta Quando ativada, mantém a última ferramenta
selecionada ativa
Subestação Insere uma Subestação
Segmento de Linha de Transmissão Insere uma Linha de Transmissão (tecla L)
Alimentador Insere um Alimentador
Parque Eólico Insere um Parque Eólico
Planta Fotovoltaica Insere uma Planta Fotovoltaica
Conector Insere um Conector (tecla J)
Trecho Insere um Trecho (tecla B). NOTA: Este elemento não

está disponível para Visualizações Esquemáticas
Nó Insere um Nó
Nó Externo Insere um Nó Externo. NOTA: Este elemento só pode

ser inserido manualmente em Visualizações
Esquemáticas
Nó de Fronteira Insere um Nó de Fronteira. NOTA: Este elemento só

existe em Visualizações Esquemáticas
Disjuntor Insere um Disjuntor. NOTA: Este elemento não está

disponível para Plantas Fotovoltaicas
Chave Insere uma Chave
Chave Fusível Insere uma Chave Fusível
Transformador de Dois Enrolamentos Insere um Transformador de Dois Enrolamentos
Transformador de Três Enrolamentos Insere um Transformador de Três Enrolamentos. NOTA:

Este elemento está disponível para Subestações e
Plantas Fotovoltaicas e não está disponível para
Alimentadores e Parques Eólicos
Carga Insere uma Carga. NOTA: Este elemento só está

disponível para Subestações
Gerador Insere um Gerador. NOTA: Este elemento está

disponível para Subestações e Alimentadores e não está
disponível para Parques Eólicos e Plantas Fotovoltaicas
Reator Insere um Reator. NOTA: Este elemento está disponível

para Subestações e Alimentadores e não está disponível
para Parques Eólicos e Plantas Fotovoltaicas
Capacitor Insere um Capacitor. NOTA: Este elemento está

disponível para Subestações e Alimentadores e não está
disponível para Parques Eólicos e Plantas Fotovoltaicas
Barramento Insere um Barramento. NOTA: Este elemento só está

disponível para Subestações
Transformador da Distribuição Insere um Transformador da Distribuição. NOTA: Este

elemento só está disponível para Alimentadores
Religador Insere um Religador. NOTA: Este elemento não está


OPÇÃO DESCRIÇÃO
Regulador de Tensão Insere um Regulador de Tensão. NOTA: Este elemento
só está disponível para Subestações e Alimentadores e
não está disponível para Parques Eólicos e Plantas
Fotovoltaicas
Turbina Eólica Insere uma Turbina Eólica. NOTA: Este elemento só está
disponível para Parques Eólicos
Estação Meteorológica Insere uma Estação Meteorológica. NOTA: Este

elemento está disponível para Parques Eólicos e Plantas
Fotovoltaicas e não está disponível para Subestações e
Alimentadores
Arranjo Fotovoltaico Insere um Arranjo Fotovoltaico. NOTA: Este elemento só

está disponível para Plantas Fotovoltaicas
Inversor Insere um Inversor. NOTA: Este elemento só está

Caixa de Junção Insere uma Caixa de Junção. NOTA: Este elemento só

está disponível para Plantas Fotovoltaicas
Conector de Corrente Contínua Insere um Conector de Corrente Contínua. NOTA: Este

elemento só está disponível para Plantas Fotovoltaicas
Trecho de Corrente Contínua Insere um Trecho de Corrente Contínua. NOTA: Este

Nó de Corrente Contínua Insere um Nó de Corrente Contínua. NOTA: Este

Converter Trecho para Conector Converte os Trechos selecionados em Conectores
Converter Conector para Trecho Converte os Conectores selecionados em Trechos
Além das barras de ferramentas, o Modelador Elétrico contém uma ferramenta auxiliar de zoom, chamada Visor. Esta
ferramenta facilita a localização de uma parte do Modelo Elétrico quando este não estiver totalmente visível na área
de desenho.
Ferramenta Visor
Existem ainda ferramentas disponíveis diretamente na área de desenho, quando um ou mais objetos são
selecionados.

Opções disponíveis na área de desenho
OPÇÃO DESCRIÇÃO
Rotacionar Permite rotacionar os objetos selecionados em passos
de 45 graus
Redimensionar Permite redimensionar os objetos selecionados
Mover Barramento Permite mover as extremidades de Barramentos,

podendo assim modificar tanto o tamanho quanto o
ângulo de inclinação destes objetos
Ao passar o ponteiro do mouse sobre um objeto, este é destacado. Caso o objeto possua dois ou mais Terminais,
estes são identificados.
Objeto destacado
4.2.2 Atalhos de Teclado

Para facilitar a navegação e a criação dos diagramas, o Modelador Elétrico disponibiliza uma série de atalhos de
teclado para algumas de suas ferramentas ou para operações realizadas mais frequentemente. A tabela a seguir lista
os atalhos de teclado disponíveis.
Atalhos de teclado para ferramentas do Modelador Elétrico
ALT + HOME Retorna ao nível de Sistema
ALT + Tecla de seta à direita Avança para o próximo elemento no histórico de

navegação
B Insere um Trecho (Branch)
BACKSPACE Volta para o elemento anterior no histórico de

navegação
Clique com o botão central do mouse Move (Pan) a área de desenho
CTRL + Zero (0) Enquadra todos os objetos
CTRL + A Seleciona todos os objetos
CTRL + Arrastar Copia os objetos selecionados
CTRL + Botão direito do mouse Zoom de área

CTRL + Roda de rolagem do mouse Mais ou menos zoom
CTRL + Tecla de seta para baixo Move o objeto selecionado para baixo (passo curto)
CTRL + Tecla de seta à esquerda Move o objeto selecionado para a esquerda (passo
curto)
CTRL + Tecla de seta à direita Move o objeto selecionado para a direita (passo curto)
CTRL + Tecla de seta para cima Move o objeto selecionado para cima (passo curto)
CTRL + Y Refaz a última operação (Redo)
CTRL + Z Desfaz a última operação (Undo)
DELETE Remove os objetos selecionados
Tecla de seta para baixo Move os objetos selecionados para baixo
ESC Retorna ao modo Seleção
F11 Decrementa a propriedade StrokeThickness da

Subestação ou Alimentador selecionado ou em edição
F12 Incrementa a propriedade StrokeThickness da

Subestação ou Alimentador selecionado ou em edição
F2 Edita o nome do(s) objeto(s) selecionado(s)
F7 Decrementa o tamanho da fonte das Descrições (nomes

dos objetos)
F8 Incrementa o tamanho da fonte das Descrições (nomes

dos objetos)
J Insere um Conector (Jumper)
L Insere um Segmento de Linha de Transmissão (Line

Segment)
Tecla de seta à esquerda Move os objetos selecionados para a esquerda
Tecla de seta à direita Move os objetos selecionados para a direita
SHIFT + Arrastar Move os objetos selecionados sem seguir o

espaçamento definido na grade
SHIFT + Duplo-clique do mouse Seleciona todos os objetos do tipo clicado
SHIFT + Tecla de seta à esquerda Rotaciona os objetos selecionados no sentido anti-

horário, em passos de 45 graus
SHIFT + Tecla de seta à direita Rotaciona os objetos selecionados no sentido horário,

em passos de 45 graus
TAB Seleciona o próximo elemento, conforme a ordem de

criação
Tecla de seta para cima Move os objetos selecionados para cima
4.2.3 Sistema
O nível mais abrangente de visualização e edição disponível no Modelador Elétrico é o nível Sistema, onde é possível
criar Subestações, Alimentadores, e outros elementos que compõem a visão mais macro do sistema elétrico, além de
poder definir as conexões entre estes elementos. A partir daí, para editar as Subestações e Alimentadores criados,
clique duas vezes no objeto desejado. Esta tela também pode ser acessada clicando em Diagrama de Sistema
quando se está em outro nível de edição, como por exemplo em uma Subestação ou Alimentador. As propriedades
deste objeto podem ser consultadas no Manual de Referência e Scripts do Elipse Power.

Diagrama de Sistema
Quando é realizada a conexão da Subestação com um Alimentador no nível Sistema, cria-se automaticamente um
objeto Nó Externo dentro de cada elemento: um Nó Externo dentro da Subestação que representa o Alimentador e
um Nó Externo dentro do Alimentador que representa a Subestação. O mesmo ocorre se a conexão é entre duas
Subestações ou dois Alimentadores. A figura a seguir representa a modelagem da Subestação SE2. Nela é possível
observar os objetos do tipo Nó Externo para representar a Subestação SE1 (LinkNode1) e para representar o
Alimentador SE2_AL1 (LinkNode2).
Representação de Alimentadores
4.2.4 Subestação
Para inserir uma nova Subestação no nível Sistema, clique em Subestação e em seguida clique na área de desenho.
As propriedades deste objeto podem ser consultadas no Manual de Referência e Scripts do Elipse Power.
Para editar uma Subestação, clique duas vezes neste objeto no nível Sistema para abrir uma nova tela e modelar os
elementos internos da Subestação. No ambiente de modelagem da Subestação é possível inserir todos os
equipamentos que compõem uma Subestação e conectá-los entre si, possibilitando não somente a configuração dos
modelos elétricos dos equipamentos, mas também suas interligações. A figura a seguir apresenta a tela de
modelagem de Subestações.

Subestação inserida no nível Sistema
4.2.5 Segmento de Linha de Transmissão e Linha de Transmissão

Segmentos de Linha de Transmissão são utilizados para conectar duas Subestações. Uma Linha de Transmissão é um
agrupamento de um ou mais Segmentos de Linha. Para inserir uma nova Linha de Transmissão no nível Sistema, é
preciso primeiro inserir um Segmento de Linha. Para isto, clique em Segmento de Linha de Transmissão ,
selecione uma Subestação e arraste o ponteiro do mouse até a outra Subestação.
Para inserir uma Linha de Transmissão, selecione todos os Segmentos de Linha que desejar e clique em Criar Linha
de Transmissão com o(s) Segmento(s) de Linha Selecionado(s) .
Segmento de Linha e Linha de Transmissão

Segmentos de Linha e Linhas de Transmissão só podem ser criados e visualizados no nível Sistema. As propriedades
destes objetos podem ser consultadas no Manual de Referência e Scripts do Elipse Power.
4.2.6 Alimentador
Para inserir um novo Alimentador no nível Sistema, clique em Alimentador e em seguida clique na área de
desenho. Para conectar um Alimentador a uma Subestação, clique em Conector , selecione o Alimentador e arraste
o ponteiro do mouse até a Subestação. Esta mesma operação também pode ser utilizada para conectar um
Alimentador a outro. As propriedades deste objeto podem ser consultadas no Manual de Referência e Scripts do
Elipse Power.

NOTA
Um Alimentador pode ser conectado a mais de uma Subestação. Neste caso, a primeira Subestação à qual o
Alimentador se conecta é considerada a Subestação pai, ou seja, a Subestação que o alimenta. Esta configuração
pode ser alterada modificando-se a propriedade Substation do Alimentador.
Para editar um Alimentador, clique duas vezes no objeto no nível Sistema para abrir uma nova tela e modelar os
elementos internos do Alimentador. A figura a seguir apresenta a tela de modelagem de um Alimentador.
Tela de modelagem de um Alimentador
4.2.7 Parque Eólico

Para inserir um novo Parque Eólico no nível Sistema, clique em Parque Eólico e em seguida clique na área de
desenho. As propriedades deste objeto podem ser consultadas no Manual de Referência e Scripts do Elipse Power.
Para editar um Parque Eólico, clique duas vezes neste objeto no nível Sistema para abrir uma nova tela e modelar os
elementos internos do Parque Eólico. No ambiente de modelagem do Parque Eólico é possível inserir todos os
equipamentos que compõem um Parque Eólico e conectá-los entre si, possibilitando não somente a configuração dos
modelos elétricos dos equipamentos, mas também suas interligações. A figura a seguir apresenta a tela de
modelagem de Parques Eólicos.
Parque Eólico inserido no nível Sistema

4.2.8 Planta Fotovoltaica
Para inserir uma nova Planta Fotovoltaica no nível Sistema, clique em Planta Fotovoltaica e em seguida clique na
área de desenho. As propriedades deste objeto podem ser consultadas no Manual de Referência e Scripts do Elipse
Power.
Para editar uma Planta Fotovoltaica, clique duas vezes neste objeto no nível Sistema para abrir uma nova tela e
modelar os elementos internos da Planta Fotovoltaica. No ambiente de modelagem da Planta Fotovoltaica é possível
inserir todos os equipamentos que compõem uma Planta Fotovoltaica e conectá-los entre si, possibilitando não
somente a configuração dos modelos elétricos dos equipamentos, mas também suas interligações. A figura a seguir
apresenta a tela de modelagem de Plantas Fotovoltaicas.
Planta Fotovoltaica inserida no nível Sistema
4.2.9 Visualizações Esquemáticas

Em sistemas elétricos de grande porte, como por exemplo em redes de distribuição, a quantidade de elementos
representados tanto no nível do Sistema quanto nas próprias Subestações e Alimentadores pode se tornar tão grande
a ponto de prejudicar o entendimento. Para isto, foram criadas as Visualizações Esquemáticas, que consistem em
áreas de desenho onde são representados apenas os elementos mais relevantes de um ou mais sistemas complexos.
Os elementos representados nas Visualizações Esquemáticas são chamados de Objetos Virtuais, e são uma
representação do objeto real que pertence à Subestação ou ao Alimentador.
4.2.9.1 Perfis
As Visualizações Esquemáticas são geradas com base em um perfil pré-definido, chamado (default), ou em perfis
criados pelo usuário. Em um perfil são informados quais tipos de equipamentos devem fazer parte da Visualização
Esquemática, e em que situações eles devem ser considerados.
A janela da figura a seguir permite a criação, remoção ou edição de filtros. Esta janela pode ser aberta nas janelas de
Geração e Edição ou na janela de Gerenciamento.

Janela Perfis Esquemáticos
A opção Perfil mostra a lista dos Perfis existentes. Se esta janela foi aberta a partir da janela Visualizações
Esquemáticas, o Perfil selecionado é o primeiro da lista, em ordem alfabética. Se a janela foi aberta a partir das janela
Gerar Visualização Esquemática ou da janela de edição, o Perfil selecionado é o mesmo Perfil que estava selecionado
naquelas janelas.
A opção Adicionar Perfil permite a criação de um novo Perfil. Esta opção mostra uma janela solicitando um nome
para o Perfil, que é adicionado à lista de Perfis e selecionado, sendo gravado diretamente no Modelo Elétrico.
Janela Adicionar perfil

Se já existir um Perfil com o nome informado, uma mensagem de aviso é mostrada para o usuário e o Perfil não é
criado, conforme a figura a seguir.
Nome de Perfil duplicado

A opção Remover Perfil permite remover o Perfil selecionado, exceto o Perfil (default). Uma mensagem é
mostrada pedindo a confirmação do usuário, conforme a figura a seguir.

Confirmação da remoção de um Perfil
A opção Editar Perfil permite renomear o Perfil, exceto o Perfil (default). Esta opção mostra uma janela para que
o usuário informe o novo nome. Ao ser aberta, a janela já vem preenchida com o nome atual do Perfil.
Janela Renomear perfil selecionado

A lista de equipamentos mostra todos os tipos de equipamentos disponíveis em um Alimentador do Modelo Elétrico.
A coluna Tipo de Equipamento permite selecionar quais equipamentos fazem parte do Perfil, ou seja, quais os
equipamentos devem fazer parte da Visualização Esquemática. A coluna Filtro permite informar em que casos aquele
equipamento selecionado deve realmente ser incluído na Visualização Esquemática. Só é permitido editar o filtro dos
equipamentos que estão selecionados. Para editar um filtro, clique em Editar filtro para abrir a janela da figura a
seguir.
Janela Definição do filtro

A edição do filtro varia conforme o tipo de equipamento, uma vez que nem todos os equipamentos possuem as
propriedades RemoteControlType e HasSelfHealingControl. Clique em OK para converter as informações desta
janela para uma expressão mostrada na coluna Filtro da janela Perfis Esquemáticos.

Equipamento com filtro
Clique em Aplicar para salvar as configurações realizadas para o Perfil selecionado, sem fechar a janela. Esta janela
permite salvar as configurações de um Perfil e selecionar outros Perfis na lista de seleção para editá-los. Se um Perfil é
editado e outro Perfil é selecionado sem que as modificações do primeiro Perfil tenham sido salvas, uma mensagem
de aviso é mostrada informando que as modificações devem ser salvas ou vão ser perdidas.
Mensagem de Perfil modificado
4.2.9.2 Geração e Edição

Para gerar uma Visualização Esquemática automaticamente, clique em Gerar Visualização Esquemática na barra
de ferramentas do Modelador Elétrico para abrir a janela da figura a seguir.

Janela Gerar Visualização Esquemática
A opção Perfil permite a seleção do Perfil que deve orientar a geração da Visualização Esquemática. A opção Editar
Perfil abre a janela Perfis Esquemáticos, para a edição do Perfil selecionado.
A coluna Alimentadores mostra a lista dos Alimentadores existentes no Modelo Elétrico. Caso existam Alimentadores
pré-selecionados no Modelador Elétrico no momento em que a janela é aberta, estes são marcados automaticamente
nesta lista e é garantido que o primeiro que estiver marcado vai estar visível. Os Alimentadores são mostrados em
ordem alfabética.
A lista Equipamentos forçados deve conter os equipamentos que vão entrar na Visualização Esquemática
independente do que estiver configurado no Perfil. A opção Adicionar equipamentos forçados permite a inclusão
de equipamentos na lista. Esta opção só está habilitada quando houver pelo menos um Alimentador selecionado. Ao
clicar nesta opção, a janela da figura a seguir é aberta para a seleção de quais equipamentos vão ser forçados.

Janela Equipamentos Forçados
Apenas os equipamentos que fazem parte dos Alimentadores selecionados são mostrados nesta janela, sem incluir os
Conectores e Trechos que já estão forçados.
A opção Remover Equipamento Forçado permite remover um ou mais equipamentos forçados. Esta opção só
está habilitada se houver pelo menos um equipamento selecionado na lista, e a remoção é realizada sem a
confirmação do usuário.
A opção Preservar o leiaute da Visualização Esquemática na sincronização configura se o leiaute original deve ser
preservado ou não quando esta Visualização Esquemática é sincronizada.
A opção Ativar pré-processamento orgânico permite gerar um diagrama de rede em forma radial, ao invés da
forma padrão semiespiral. Selecionar esta opção produz melhores resultados em diagramas com vários
Alimentadores interconectados, ao passo que deixar esta opção desmarcada produz melhores resultados em
diagramas com apenas um Alimentador.
A opção Incluir alimentadores vizinhos permite que os Alimentadores vizinhos aos Alimentadores selecionados para
visualização também sejam incluídos.
A opção Incluir disjuntores de saída das Subestações permite que o Disjuntor ou Religador de saída do Alimentador
também seja representado na Visualização Esquemática.
As opções Uma Visualização Esquemática para cada Alimentador e Uma Visualização Esquemática única
configuram se deve ser gerada uma Visualização Esquemática para cada Alimentador selecionado ou uma única
Visualização Esquemática que represente todos os Alimentadores, respectivamente.
Clique em Gerar para gerar uma ou mais Visualizações Esquemáticas, conforme as configurações. Esta opção só está
habilitada se o usuário selecionar pelo menos um Alimentador. Ao clicar na opção é realizada uma verificação de
consistência de que todos os equipamentos forçados na lista pertencem aos Alimentadores selecionados. Se um
Alimentador foi selecionado e seus equipamentos também foram selecionados, mas posteriormente é removida a
seleção deste Alimentador, os equipamentos forçados neste caso não são utilizados na geração da Visualização
Esquemática. A mensagem da figura a seguir é mostrada, de acordo com as configurações realizadas pelo usuário.
Mensagem de equipamento sem uso

Ao clicar em Sim, as Visualizações Esquemáticas são geradas e os equipamentos forçados que não pertencem a
nenhum Alimentador não são salvos em nenhuma Visualização Esquemática. Ao clicar em Não, a geração das
Visualizações Esquemáticas é cancelada e a janela não é fechada, para que seja possível corrigir o problema,
removendo manualmente os objetos ou incluindo os Alimentadores.

Após a criação, é possível editar as propriedades da Visualização Esquemática. Clique em Gerenciar Visualizações
Esquemáticas na janela de gerenciamento para mostrar a janela da figura a seguir.
Janela Editar Visualização Esquemática

Nesta janela é possível editar qual o Perfil a Visualização Esquemática usa, quais Alimentadores fazem parte desta
Visualização, quais são os equipamentos forçados, se o leiaute da Visualização Esquemática deve ou não ser
preservado caso seja sincronizada, e se o pré-processamento orgânico deve ou não ser ativado. Além disto, é
possível editar o Perfil selecionado clicando em Editar Perfil .
4.2.9.3 Gerenciamento
É possível gerenciar as Visualizações Esquemáticas já geradas ou criar novas usando a janela Visualizações
Esquemáticas, mostrada na figura a seguir.
Janela Visualizações Esquemáticas

Para cada Visualização Esquemática mostrada na lista é possível definir um nome e um nome curto. A primeira coluna
mostra o ícone nos casos em que a Visualização Esquemática é sincronizada e o leiaute precisa ser reconhecido
pelo usuário. As opções disponíveis nessa janela são mostradas na tabela a seguir.

Opções disponíveis na janela Visualizações Esquemáticas
OPÇÃO DESCRIÇÃO
Adicionar Visualização Esquemática Adiciona uma nova Visualização Esquemática vazia
Remover Visualização Esquemática Remove as Visualizações Esquemáticas selecionadas
Editar Visualização Esquemática Abre a janela para edição da Visualização Esquemática

selecionada
Sincronizar Visualização(ões) Esquemática(s) Sincroniza as Visualizações Esquemáticas selecionadas,

conforme descrito no tópico Sincronização
Reconhecer Leiaute da Visualização Esquemática Reconhece o leiaute da Visualização Esquemática

selecionada, que foi alterado pela ferramenta de
sincronização apesar de estar selecionada a opção de
preservá-lo, conforme descrito no tópico
Reconhecimento de Leiaute
A opção Editar perfis permite editar os perfis das Visualizações Esquemáticas, conforme descrito no tópico Perfis.
4.2.9.4 Sincronização
Quando já existe uma Visualização Esquemática gerada para um ou mais Alimentadores, e estes Alimentadores
tiverem modificações tais como inclusão ou remoção de algum equipamento, é possível sincronizar as Visualizações
Esquemáticas para refletirem o novo estado do Alimentador. Isto pode ser realizado clicando em Sincronizar
Visualização(ões) Esquemática(s) na janela de Gerenciamento.
Caso a Visualização Esquemática selecionada esteja com a opção Preservar o layout da Visualização Esquemática
na sincronização selecionada e o leiaute não possa ser mantido, a Visualização é sinalizada com o ícone tanto na
janela de gerenciamento quanto na miniatura.
Leiaute não preservado

Caso tenham sido incluídos equipamentos no Alimentador e estes façam parte da Visualização Esquemática após a
sincronização, estes equipamentos são inseridos no canto superior esquerdo da área de desenho, de forma que
estejam visíveis para que o usuário ajuste o seu posicionamento.
4.2.9.5 Reconhecimento de Leiaute

Uma vez que todos os equipamentos tenham sido ajustados e que a Visualização Esquemática sincronizada esteja
correta do ponto de vista do usuário, é possível sinalizar para o Modelador Elétrico que esta Visualização foi
verificada e está correta. Para isto, clique em Reconhecer Leiaute da Visualização Esquemática na janela de
gerenciamento ou na barra de ferramentas do Modelador Elétrico.

4.2.10 Equipamentos
A ferramenta de modelagem elétrica do Elipse Power permite que uma série de equipamentos possam ser inseridos
nos modelos elétricos. Estes equipamentos estão descritos nos tópicos a seguir.
4.2.10.1 Arranjo Fotovoltaico

Conjunto de módulos fotovoltaicos ou subarranjos fotovoltaicos mecânica e eletricamente integrados, incluindo a
estrutura de suporte. As propriedades deste objeto podem ser consultadas no Manual de Referência e Scripts do
Elipse Power.
4.2.10.2 Caixa de Junção

Invólucro no qual subarranjos fotovoltaicos, séries fotovoltaicas ou módulos fotovoltaicos são conectados em paralelo
e que também aloja dispositivos de proteção ou seccionamento. As propriedades deste objeto podem ser
consultadas no Manual de Referência e Scripts do Elipse Power.
4.2.10.3 Capacitor
Elemento que representa um capacitor ou um banco de capacitores. As propriedades deste objeto podem ser
4.2.10.4 Carga
Elemento que representa uma carga concentrada em uma subestação de energia elétrica. As propriedades deste
objeto podem ser consultadas no Manual de Referência e Scripts do Elipse Power.
4.2.10.5 Carga de Distribuição

Elemento que representa uma carga concentrada em uma rede de distribuição. Por exemplo, um Transformador de
Distribuição conectado a um ou mais consumidores. As propriedades deste objeto podem ser consultadas no Manual
de Referência e Scripts do Elipse Power.
4.2.10.6 Chave
Dispositivo capaz de abrir ou fechar um ou mais circuitos elétricos. As propriedades deste objeto podem ser
4.2.10.7 Chave Fusível

Dispositivo capaz de abrir ou fechar um ou mais circuitos elétricos. Este dispositivo possui um elemento fusível capaz
de interromper o circuito quando da ocorrência de uma sobrecorrente que ultrapasse seu limite operacional. As
propriedades deste objeto podem ser consultadas no Manual de Referência e Scripts do Elipse Power.
4.2.10.8 Disjuntor
Dispositivo com capacidade de conduzir e interromper corrente em circuitos elétricos. As propriedades deste objeto
podem ser consultadas no Manual de Referência e Scripts do Elipse Power.
4.2.10.9 Estação Meteorológica

Elemento que agrupa diversos dispositivos de medição de condições climáticas ou meteorológicas, como por
exemplo velocidade e direção do vento, temperatura e precipitação pluviométrica. As propriedades deste objeto
podem ser consultadas no Manual de Referência e Scripts do Elipse Power.
4.2.10.10 Gerador
Máquina síncrona capaz de converter energia mecânica em energia elétrica. As propriedades deste objeto podem ser
4.2.10.11 Inversor
Conversor estático de potência que converte a corrente contínua do gerador fotovoltaico em corrente alternada. As

4.2.10.12 Reator
Elemento que representa um reator ou um banco de reatores. As propriedades deste objeto podem ser consultadas
no Manual de Referência e Scripts do Elipse Power.
4.2.10.13 Regulador de Tensão

Autotransformador com controle automático de tap, que permite elevar ou reduzir a tensão no lado da carga,
mantendo-a dentro de uma faixa de valores pré-estabelecidos. As propriedades deste objeto podem ser consultadas
4.2.10.14 Religador
Dispositivo com capacidade de conduzir e interromper automaticamente a corrente em circuitos elétricos. As
4.2.10.15 Transformador da Distribuição

Elemento que engloba características de uma carga concentrada de uma rede de distribuição e de um Transformador
de Dois Enrolamentos, necessário para se conectar consumidores em seu enrolamento secundário. As propriedades
deste objeto podem ser consultadas no Manual de Referência e Scripts do Elipse Power.
4.2.10.16 Transformador de Dois Enrolamentos

Dispositivo composto de um núcleo magnético e dois enrolamentos, capaz de introduzir um acoplamento mútuo entre
dois circuitos elétricos. As propriedades deste objeto podem ser consultadas no Manual de Referência e Scripts do
Elipse Power.
4.2.10.17 Transformador de Três Enrolamentos

Dispositivo composto de um núcleo magnético e três enrolamentos, capaz de introduzir um acoplamento mútuo entre
três circuitos elétricos. As propriedades deste objeto podem ser consultadas no Manual de Referência e Scripts do
Elipse Power.
4.2.10.18 Turbina Eólica

Máquina síncrona capaz de converter energia mecânica em energia elétrica. As propriedades deste objeto podem ser
4.2.11 Elementos de Conexão

Para permitir a modelagem da interconexão entre os equipamentos que constituem um sistema elétrico, a ferramenta
de modelagem do Elipse Power provê um conjunto de elementos que facilitam a ligação entre equipamentos. Estes
elementos estão descritos nos tópicos a seguir.
4.2.11.1 Conector
Condutor de impedância desprezível que serve para conectar terminais de equipamentos em Subestações e
Alimentadores. As propriedades deste objeto podem ser consultadas no Manual de Referência e Scripts do Elipse
Power.
4.2.11.2 Conector de Corrente Contínua

Trecho de impedância nula que interconecta dois pontos da rede de corrente contínua de uma Planta Fotovoltaica. As
4.2.11.3 Nó
Representa um ponto de conexão entre dois ou mais objetos. As propriedades deste objeto podem ser consultadas
4.2.11.4 Nó de Corrente Contínua

Ponto de conexão de um ou mais Conectores de Corrente Contínua ou Trechos de Corrente Contínua de uma Planta
Fotovoltaica. As propriedades deste objeto podem ser consultadas no Manual de Referência e Scripts do Elipse
Power.

4.2.11.5 Nó de Fronteira
Representa um ponto de conexão entre objetos que estão representados em uma Visualização Esquemática, mas que
pertencem a Subestações ou Alimentadores diferentes. As propriedades deste objeto podem ser consultadas no
Manual de Referência e Scripts do Elipse Power.
4.2.11.6 Nó Externo
Representa um ponto de conexão de uma Subestação ou Alimentador com um outro objeto externo ao diagrama, que
pertence a uma outra Subestação ou Alimentador. As propriedades deste objeto podem ser consultadas no Manual
de Referência e Scripts do Elipse Power.
4.2.11.7 Terminal de Barramento

Condutor ou grupo de condutores com impedância desprezível, que serve para conectar diversos equipamentos em
uma Subestação. As propriedades deste objeto podem ser consultadas no Manual de Referência e Scripts do Elipse
Power.
4.2.11.8 Trecho
Condutor com impedância significativa que modela os cabos que constituem uma rede de distribuição de energia
elétrica (Alimentadores). As propriedades deste objeto podem ser consultadas no Manual de Referência e Scripts do
Elipse Power.
4.2.11.9 Trecho de Corrente Contínua

Trecho de condutor que interliga dois pontos da rede de corrente contínua de uma Planta Fotovoltaica. As
4.2.11.10 Vértice Gráfico

A ferramenta de Vértice deve ser utilizada para alterar o caminho percorrido por Conectores, Trechos e Linhas de
Transmissão. As propriedades deste objeto podem ser consultadas no Manual de Referência e Scripts do Elipse
Power.
4.3 Ferramentas
O objeto Configuração do Power dispõe de uma série de ferramentas que auxiliam na construção e manutenção do
sistema elétrico. Para acessar estas ferramentas, clique com o botão direito do mouse no objeto Configuração do
Power e selecione a opção Modelo Elétrico.
4.3.1 Sincronizar Objetos de Dados

Uma vez que tenha sido realizada a modelagem do sistema elétrico no Modelador Elétrico, é possível criar os objetos
de dados nativos do Elipse Power automaticamente através da ferramenta Sincronizar Objetos de Dados, disponível
no menu contextual Modelo Elétrico do objeto Configuração do Power. Para mais informações sobre esta ferramenta,
consulte o capítulo Sincronização de Objetos de Dados.
4.3.2 Sincronizar Objetos de Dados Existentes

Esta ferramenta é um caso particular de sincronização de objeto de dados, onde apenas os objetos nativos que já
existem no Elipse Power são sincronizados com o Modelo Elétrico. Objetos que tenham sido criados no Modelo
Elétrico não são importados utilizando esta ferramenta. Para mais informações, consulte o tópico Sincronização de
Objetos de Dados Existentes no capítulo Sincronização de Objetos de Dados.
4.3.3 Importar para Tela(s)

A partir do Modelo Elétrico também é possível gerar automaticamente as Telas que vão representar Alimentadores,
Linhas de Transmissão, Parques Eólicos, Plantas Fotovoltaicas ou Subestações na aplicação, utilizando a ferramenta
Importar para Tela(s). Para mais informações, consulte o capítulo Importação para Telas.
4.3.4 Sincronizar de Base de Dados Externa

Caso o usuário possua uma base de dados independente com a modelagem do sistema elétrico, como por exemplo
uma modelagem executada em um sistema GIS (Geographic Information System) comercial, ou já possua um Modelo
Elétrico, é possível criar um novo Modelo Elétrico ou sincronizar esta base de dados externa para o Modelo Elétrico

existente, respectivamente. Para isto, clique com o botão direito do mouse no objeto Configuração do Power e
selecione a opção Modelo Elétrico - Sincronizar de Base de Dados Externa.
Opção Sincronizar de Base de Dados Externa

Ao selecionar esta opção, a ferramenta cria no Modelo Elétrico os elementos existentes na base de dados externa.
Caso os elementos já existam, eles são sincronizados. Caso a base externa tenha sido alterada e alguns elementos
tenham sido removidos, estes são removidos do Modelo Elétrico. É importante ressaltar que os objetos existentes no
Modelo Elétrico que não sejam provenientes da base de dados externa permanecem inalterados.
As alterações são realizadas apenas no arquivo de Modelo Elétrico (EDB). Não é realizada qualquer alteração nos
objetos nativos do Elipse Power que já tiverem sido sincronizados.
Para a utilização destas ferramentas é necessário uma DLL específica, personalizada para cada cliente. Esta DLL é
responsável pela conexão com o banco de dados externo, leitura de todas as informações cadastrais relativas ao
modelo elétrico do cliente e criação deste sistema. Para maiores informações sobre como adquirir a DLL, entre em
contato com a Elipse Software.
4.3.5 Estatísticas
Para auxiliar na visualização das licenças dos Estudos Elétricos, o objeto Configuração do Power dispõe de uma
ferramenta chamada Estatísticas, que mostra a contagem dos objetos relevantes para as licenças de cada Estudo.
Para acessar esta ferramenta, clique com o botão direito do mouse no objeto Configuração do Power e selecione a
opção Modelo Elétrico - Estatísticas.

Opção Modelo Elétrico - Estatísticas
A janela a seguir é mostrada. São listados apenas os objetos relevantes para o cálculo de licenças para os diferentes
Estudos Elétricos.

Janela Estatísticas do Modelo
Para as licenças do Fluxo de Potência, a contagem é mostrada ao final da tabela, no item Total de entradas.
Para os demais Estudos Elétricos as informações aparecem detalhadas nos campos Descarte de Cargas, Estimador
de Estados, Modelagem de Carga da Distribuição e Autorrecuperação.

CAPÍTULO
Sincronização de Objetos de Dados
5
O Elipse Power trata de forma distinta, porém vinculada, o Modelo Elétrico e os objetos de dados da aplicação.
Enquanto o Modelo Elétrico é armazenado em um arquivo no formato EDB e possui informações e configurações
sobre os componentes do sistema, os objetos de dados são armazenados em arquivos de projeto e permitem que
uma série de programações sejam adicionadas, tais como scripts, Associações para Tags de Comunicação,
Associações para objetos de Tela, Alarmes ou Históricos, entre outras. Após criar os equipamentos no Modelador
Elétrico, os componentes do sistema podem ser sincronizados para arquivos de projeto clicando com o botão direito
do mouse no objeto Configuração do Power e selecionando a opção Modelo Elétrico - Sincronizar Objetos de
Dados, conforme mostrado na figura a seguir.
Opção Sincronizar Objetos de Dados

A janela da figura a seguir é aberta. Por padrão a opção Sincronizar todos os Objetos de Dados do Modelo Elétrico
já vem selecionada, indicando que todos os objetos são sincronizados.
Sincronização de Objetos de Dados 158

Janela Sincronização de Objetos de Dados
Caso haja necessidade de sincronizar objetos específicos, desmarque a opção Sincronizar todos os Objetos de
Dados do Modelo Elétrico e selecione os objetos desejados no grupo Sincronizar apenas os Objetos de Dados
selecionados, conforme a figura a seguir.
Sincronização somente dos objetos selecionados

NOTAS
· A opção OK só está disponível se houver pelo menos um item selecionado.
· O item Linhas de Transmissão da árvore de objetos agrupa tanto Linhas de Transmissão quanto Segmentos de
Linha de Transmissão.
Os objetos selecionados do Modelo Elétrico são lidos e a ferramenta procura por objetos equivalentes nativos no
Elipse Power. Quando um objeto é encontrado, suas propriedades são atualizadas.
Por objeto equivalente entende-se que seja um objeto com o mesmo ID e tipo de objeto que está no Modelo Elétrico,
ou então um objeto com o mesmo tipo, mesmo nome e ID igual a 0 (zero).
Caso o objeto não seja encontrado, é criado um novo objeto. Caso este objeto seja do tipo Contêiner ou Agrupador
(Alimentadores, Linhas de Transmissão, Parques Eólicos, Plantas Fotovoltaicas ou Subestações), é preciso definir onde
é criado. Para isto, a janela apresentada na figura a seguir é aberta.
159 Sincronização de Objetos de Dados

Criação de objetos durante a sincronização de objetos de
dados
Esta janela mostra uma lista de projetos e pastas já existentes no Domínio, para que seja selecionado o destino do
objeto de dados a ser criado. Se desejar, o usuário pode criar uma nova pasta ou um novo projeto, utilizando as
opções Nova Pasta ou Novo Projeto, respectivamente.
A seleção realizada nesta lista é, a princípio, aplicada apenas ao objeto que está sendo criado no momento. Se a
opção Utilizar a mesma localização para todos os objetos é selecionada, então todos os demais objetos,
independente do tipo, que precisarem ser criados têm como destino a mesma localização selecionada. Caso a opção
Utilizar a mesma localização para todos os objetos deste tipo seja selecionada, então esta seleção vale apenas
para objetos com o mesmo tipo do objeto criado. Caso seja necessária a criação de um objeto de tipo diferente, a
janela é mostrada novamente.
Se a opção Criar um projeto novo para cada objeto é selecionada, então toda a configuração realizada para seleção
de um projeto existente é ignorada, e para cada objeto novo a ser importado é criado um novo projeto. O projeto
recebe o nome do objeto e é inserido automaticamente no Domínio.
Após finalizada a sincronização, todos aqueles objetos que existam no Elipse Power e que não tenham sido
atualizados a partir do Modelo Elétrico, porque não existem mais no modelo, têm seus IDs zerados. Nenhum objeto é
removido, apenas o ID em 0 (zero) indica que este objeto não tem mais um correspondente no Modelo Elétrico. Desta
forma, caso os objetos tenham alguma configuração realizada pelo usuário, nada é perdido.
É possível visualizar os objetos criados e alterados através do Organizer. Os objetos de dados criados já possuem
algumas configurações básicas, mas permitem que sejam inseridos elementos como Medidas, Comandos,
Intertravamentos, Alarmes, Storage, Pastas de Dados, scripts, Associações e, em alguns casos, outros objetos de
dados do Elipse Power.
Todos os objetos descritos no tópico Equipamentos do capítulo Objeto Configuração do Power possuem um objeto
de dados correspondente nativo do Elipse Power, exceto os objetos Nó, Nó Externo, Nó de Fronteira, Terminal da
Barra, Conector e Vértice Gráfico. As propriedades destes equipamentos podem ser encontradas no Manual de
Referência e Scripts do Elipse Power.

Resultado da sincronização de objetos
de dados
NOTA
Podem ocorrem casos em que um objeto é movido de lugar no Modelo Elétrico. Por exemplo, um Disjuntor que
pertencia a uma Subestação e agora pertence a outra, ou objetos que eram agrupados em um Bay e agora estão
em outro. Nestes casos, quando o objeto é equivalente mas apenas está fora de lugar, este é aproveitado na
sincronização e movido para o local correto.
5.1 Sincronização de Objetos de Dados Existentes

A ferramenta de Sincronização de Objetos de Dados tem como objetivo modelar todos os objetos do Modelo Elétrico
em objetos nativos do Elipse Power, alterando suas propriedades e criando os objetos inexistentes no lado do Elipse
Power, se necessário. Uma ferramenta adicional é a Sincronização de Objetos de Dados Existentes, que realiza esta
mesma tarefa, exceto pelo fato de que não são criados objetos novos. Esta ferramenta apenas atualiza todas as
propriedades dos objetos já existentes no Elipse Power e zera os IDs daqueles objetos que não possuem mais
correspondente no Modelo Elétrico.
Para acessar esta ferramenta, clique com o botão direito do mouse no objeto Configuração do Power e selecione a
opção Modelo Elétrico - Sincronizar Objetos de Dados Existentes, conforme a figura a seguir.

Opção Sincronizar Objetos de Dados Existentes
NOTA
No caso de objetos que tenham sido movidos de lugar no Modelo Elétrico, a ferramenta Sincronização de Objetos
de Dados Existentes tenta mover também os objetos no Elipse Power. Para isto, caso seja necessária a criação de
um novo Bay, este é criado.
5.2 Configuração SCADA

Um objeto nativo do Elipse Power se caracteriza por conter uma estrutura de dados que permite configurar o
equipamento da forma como existe em campo. Quando um objeto é criado, possui algumas características
previamente configuradas e permite a configuração de outras.
A criação dos objetos de dados nativos do Elipse Power pode ser realizada através da ferramenta de sincronização a
partir de um Modelo Elétrico ou manualmente através do Organizer. A estrutura permitida para cada equipamento é a
seguinte:
· Comandos e Unidades de Comando
· Intertravamentos
· Medidas e Fontes de Medidas
· Proteções
· Terminais, cuja quantidade varia conforme o tipo do objeto
5.2.1 Comandos e Unidades de Comando

Os Comandos que um objeto pode conter devem ser criados na pasta Commands de cada objeto. Para adicionar
esta pasta, clique com o botão direito do mouse no objeto e selecione a opção Adicionar - Commands.

Opção Adicionar - Commands
Existem dois tipos de Comandos que podem ser inseridos na pasta Commands, o Comando de Passo e o Comando
Discreto. Para inserir um Comando, clique com o botão direito do mouse na pasta Commands, selecione a opção
Inserir e o tipo de Comando.

Opção de inserir um Comando de Passo ou Discreto
Os tipos de Comandos disponíveis são configurados no objeto Configuração do Power, na aba Comandos, conforme
visto no tópico Padronização dos Tipos de Comandos.
Nos Comandos é possível inserir as Unidades de Comando. Por padrão, Comandos Discretos são criados contendo
uma Unidade de Comando, e podem ter quantas Unidades de Comando sejam necessárias. Por outro lado,
Comandos de Passo são criados com duas Unidades de Comando e não é permitido inserir outras Unidades de
Comando sem antes remover as pré-existentes. Para inserir Unidades de Comando, clique com o botão direito do
mouse no Comando e selecione a opção Inserir - Unidade de Comando.

Opção Inserir - Unidade de Comando
O tipo de Unidade de Comando também é definido na aba Comandos do objeto Configuração do Power, e varia
conforme o tipo de Comando Discreto ou de Passo ao qual a Unidade pertence.
Para que um Comando funcione corretamente, algumas propriedades precisam ser configuradas, conforme a tabela a
seguir.
Propriedades que precisam ser configuradas em Comandos e Unidades de Comando
OBJETO PROPRIEDADES
Comando Discreto · CommandType
· Conversion
Comando de Passo · CommandType

· Conversion
· HighPosition
· LowPosition
Unidade de Comando · CommandName

· SelectWriteTag
· SelectFeedbackTag
· OperateWriteTag
· OperateFeedbackTag
· CancelWriteTag
· CancelFeedbackTag

As propriedades dos Comandos Discreto e de Passo e também das Unidades de Comando podem ser consultadas
5.2.2 Intertravamentos
Os Intertravamentos têm a função de informar quando há uma restrição para a execução de algum Comando. Esta
restrição é aplicada a todos os Comandos que estão no mesmo nível e nos níveis inferiores. Por exemplo, um
Intertravamento criado em um Bay permite que todos os Comandos presentes no Bay sejam intertravados nos
equipamentos. Da mesma forma, um Intertravamento criado em uma Unidade de Comando tem influência apenas
nesta Unidade.
Os Intertravamentos devem ser criados na pasta Interlocks. Para inserir esta pasta, clique com o botão direito do
mouse no objeto desejado e selecione a opção Adicionar - Interlocks.
Opção Adicionar - Interlocks

Para inserir um Intertravamento, clique com o botão direito do mouse na pasta Interlocks e selecione a opção Inserir
- Intertravamento.

Opção Inserir - Intertravamento
Pode-se adicionar diversos Intertravamentos em cada pasta, e é preciso que apenas um dos Intertravamentos criados
seja infringido para haver o disparo do Intertravamento.
Para que um Intertravamento funcione corretamente, as propriedades ComparisonOperator, ComparisonValue e
Measurement precisam ser configuradas.
As propriedades dos Intertravamentos podem ser consultadas no Manual de Referência e Scripts do Elipse Power.
5.2.3 Medidas e Fontes de Medidas

As Medidas que um objeto pode conter devem ser criadas na pasta Measurements ou nos Terminais de cada objeto,
dependendo de onde vem esta informação no equipamento de campo. Alguns objetos nativos já são criados
contendo esta pasta e alguma Medida. Outros, porém, são criados apenas com seus Terminais.
Para adicionar a pasta Measurements, clique com o botão direito do mouse no objeto e selecione a opção Adicionar
- Measurements.

Opção Adicionar - Measurements
Uma vez que a pasta já exista, é possível adicionar os diversos tipos de Medidas, Analógicas ou Discretas. Para isto,
clique com o botão direito do mouse na pasta Measurements, selecione a opção Inserir e selecione o tipo de
Medida, Analógica ou Discreta.

Opção de inserir uma Medida Analógica ou Discreta
A inserção de Medidas deve sempre levar em consideração o local onde está sendo requisitada a referida Medida.
Por exemplo, se em campo no Terminal 1 de um Disjuntor existe um transdutor de corrente, deve ser adicionada a
Medida Analógica de Corrente no Terminal 1 do Disjuntor na aplicação. Por outro lado, se em campo o Disjuntor
pode ou não estar inserido em um rack, na aplicação deve ser adicionada uma Medida do tipo *BreakerRackPosition
na pasta Measurements para indicar este estado.
Dentro de uma Medida, seja ela Analógica ou Discreta, é possível inserir uma ou mais Fontes de Medidas, indicando a
forma como a informação é recebida pela aplicação. Estas Fontes podem ser de entrada ou provenientes de um
Estudo Elétrico.
Para inserir uma nova Fonte de Medida, selecione a Medida, clique com o botão direito do mouse em Adicionar e
selecione o tipo de Fonte de Medida.

Opção de adicionar uma Fonte de Medida
Os tipos de Fontes de Medida disponíveis estão descritos na tabela a seguir.
Tipos de Fontes de Medida
FONTE DE MEDIDA DESCRIÇÃO
Operator Fonte de entrada onde o valor é informado manualmente
pelo operador do sistema elétrico
Scada Fonte de entrada onde o valor é recebido por uma

variável de comunicação
CCLink Fonte de entrada onde o valor é recebido por outro

centro de controle
Billing Fonte de entrada onde o valor é recebido pelo sistema

de tarifação
Calculated Fonte de entrada onde o valor é calculado
Database Fonte de entrada onde o valor é recebido através de um

campo de tabela em um banco de dados. NOTA: É
responsabilidade da aplicação configurar a consulta e os
métodos para receber estes dados de um banco de
dados
TopologyProcessor Fonte cujo valor é proveniente de um Estudo Elétrico do

tipo Processador Topológico
PowerFlow Fonte cujo valor é proveniente de um Estudo Elétrico do

tipo Fluxo de Potência
StateEstimator Fonte cujo valor é proveniente de um Estudo Elétrico do

tipo Estimador de Estados

FONTE DE MEDIDA DESCRIÇÃO
LoadSchedding Fonte cujo valor é proveniente de um Estudo Elétrico do
tipo Descarte de Cargas
DistLoadModeling Fonte cujo valor é proveniente de um Estudo Elétrico do

tipo Modelagem de Carga da Distribuição
SelfHealing Fonte cujo valor é proveniente de um Estudo Elétrico do

tipo Autorrecuperação
ExternalReader Fonte cujo valor é proveniente de um Estudo Elétrico do

tipo Leitor Externo
Por padrão, cada Medida é criada contendo uma Fonte de Medida do tipo Operator. Para as Fontes de Medida de
entrada, com exceção da Fonte Operator, é necessário configurar qual variável fornece os valores. Esta configuração é
realizada na propriedade Tag da Medida Analógica ou Discreta.
Para que uma Medida funcione corretamente, algumas propriedades precisam ser configuradas, conforme a tabela a
seguir.
Propriedades que precisam ser configuradas em Medidas
OBJETO PROPRIEDADES
Medidas Analógicas · MeasurementType
· ActiveSource
· StudyInputSource
· UnitPrefix
Medidas Discretas · MeasurementType

· ActiveSource
· StudyInputSource
As propriedades das Medidas Analógicas e Discretas, e também das Fontes de Medidas, podem ser consultadas no
5.2.4 Proteções
Todos os equipamentos permitem a inserção da pasta Protections, desde a Subestação, Alimentador, Linha de
Transmissão, até qualquer um dos equipamentos que podem ser inseridos nestes objetos.
Para adicionar esta pasta, clique com o botão direito do mouse no objeto desejado e selecione a opção Adicionar -
Protections.

Opção Adicionar - Protections
Para inserir uma Proteção, clique com o botão direito do mouse na pasta Protections e selecione a opção Inserir -
Proteção.

Opção Inserir - Proteção
Ao criar uma nova Proteção, o Elipse Power já cria automaticamente a pasta Measurements com as Medidas
Discretas do tipo Modo de Proteção (ProtectionMode) e Atuação da Proteção (ProtectionOperate). Este local é o
indicado para criar todas as Medidas relacionadas a esta Proteção, tais como configurações, inicialização da Proteção
e perfil de proteção, entre outras.
Além da pasta Measurements, é possível criar a pasta Commands, onde podem ser criados os Comandos de
alteração do modo de proteção ou mudança no perfil de proteção, entre outros.
Para que uma Proteção funcione corretamente, as propriedades ProtectionType e ElectricalPhase precisam ser
configuradas.
As propriedades das Proteções podem ser consultadas no Manual de Referência e Scripts do Elipse Power.
5.2.5 Terminais
Quando um objeto é criado, são criados automaticamente os seus Terminais, cuja quantidade varia de um a três
conforme o tipo de objeto. Dentro de cada Terminal é criada uma Medida Discreta do tipo *TerminalState, que
indica o estado daquele Terminal.

Objeto Terminal
Não é permitido remover os Terminais de um objeto nativo e nem inserir novos Terminais. É permitido apenas inserir
novas Medidas e alarmes dentro dos Terminais existentes, através do menu Inserir.
Opção de inserir uma Medida Analógica ou Discreta

As propriedades do objeto Terminal podem ser consultadas no Manual de Referência e Scripts do Elipse Power.

CAPÍTULO
Drivers
6
O Elipse Power permite a comunicação com equipamentos de aquisição de dados, controladores, CLPs
(Controladores Lógicos Programáveis), UTRs (Unidades Terminais Remotas), ou qualquer outro tipo de equipamento,
através de Drivers de Comunicação próprios ou Servidores OPC, de acordo com o tipo do equipamento ou tipo de
comunicação necessária.
NOTAS
· Os objetos de Drivers (Driver de Comunicação, Pasta de Comunicação, Tag de Comunicação, Bloco de
Comunicação, Elemento de Bloco de Comunicação, Driver de Comunicação OPC, Grupo de Tags OPC, Pasta OPC,
Tag de Comunicação OPC, Bloco de Comunicação OPC, Elemento de Bloco de Comunicação OPC, Driver de
Comunicação OPC UA, Assinatura OPC UA, Pasta OPC UA, Tag de Comunicação OPC UA, Bloco de Comunicação
OPC UA e Elemento de Bloco de Comunicação OPC UA) podem ser configurados para funcionarem como Áreas de
Alarme.
· Todas as opções do editor dos objetos de Drivers que estão disponíveis via menu contextual, através do clique
com o botão direito do mouse, também estão disponíveis utilizando o atalho de teclado SHIFT + F10, que
corresponde à tecla de aplicação ou de menu .
· A Janela de Propriedades dos objetos de Drivers no Editor de objetos pode ser aberta utilizando os atalhos de
teclado ALT + ENTER ou ALT + Duplo-clique do mouse.
6.1 Driver de Comunicação

O Driver de Comunicação é um módulo do Elipse Power que possibilita a comunicação com um determinado
equipamento usando arquivos .dll. Estes Drivers são desenvolvidos pela Elipse Software, bem como por terceiros, a
partir de um DDK (Driver Development Kit) fornecido pela Elipse Software, em linguagem de programação C/C++.
Cada Driver implementa uma família de equipamentos ou protocolos diferentes, de acordo com o tipo de
equipamento ou protocolo de comunicação. Novos Drivers são costumeiramente desenvolvidos pela Elipse Software.
Para inserir um Driver de Comunicação em um projeto, clique com o botão direito do mouse no nome do projeto no
Explorer e selecione a opção Inserir - Driver de Comunicação. No modo Domínio, clique com o botão direito do
mouse no item Objetos de Servidor - Drivers e OPC, selecione a opção Inserir Driver de Comunicação Em e logo
após o nome do projeto desejado.
Inserindo um Driver de Comunicação no modo Domínio
175 Drivers
A janela a seguir é aberta para localização do Driver.
Janela Localizar Driver

Ao selecionar um Driver válido, o Elipse Power Studio exibe sua janela própria de configuração. Logo em seguida,
abre-se a janela de importação de Tags de Comunicação, se disponível.
Ao inserir um Driver de Comunicação em uma aplicação do Elipse Power Studio, abre-se o Editor do objeto,
Editor do Driver de Comunicação

As opções disponíveis neste Editor estão descritas na tabela a seguir.
Opções disponíveis no Editor do Driver de Comunicação
OPÇÃO DESCRIÇÃO
Adicionar Adiciona uma nova Pasta de Comunicação, um novo Tag
de Comunicação ou um novo Bloco de Comunicação ao
Driver de Comunicação, um novo Tag de Comunicação
ou um novo Bloco de Comunicação a uma Pasta de
Comunicação ou um novo Elemento de Bloco de
Comunicação a um Bloco de Comunicação
Remover Remove o item selecionado no Editor
Drivers 176
OPÇÃO DESCRIÇÃO
Configurar o Driver Abre a janela de configurações extras do Driver de
Comunicação
Tag Browser Abre uma janela que permite importar Tags de

Comunicação diretamente do Driver de Comunicação
Ativar ou Desativar Comunicação Ativa ou desativa a comunicação do Driver de

Comunicação. A opção de ativação só está disponível se
a propriedade DriverLocation está configurada
Contagem de Tags Apresenta o número total de Tags de Comunicação no

Driver de Comunicação
NOTAS
· A opção Ativar ou Desativar Comunicação implica em um número suficiente de licenças para todos os Tags de
Comunicação e Elementos de Bloco de Comunicação presentes no Driver de Comunicação. Se não há licenças
suficientes para todos os Elementos de Bloco de Comunicação, o Bloco de Comunicação inteiro não comunica.
Consulte o tópico Licenças para mais informações sobre este comportamento.
· A opção Contagem de Tags leva em consideração o número de Tags de Comunicação mais o número de
Elementos de Bloco de Comunicação presentes no Driver de Comunicação.
6.1.1 Configuração
Para determinar o Driver a ser usado, clique na propriedade DriverLocation ou clique com o botão direito do mouse
no Driver de Comunicação e selecione a opção Procurar DLL. Uma caixa de diálogo para selecionar o arquivo .dll que
contém o Driver é exibida, conforme a figura a seguir.
Selecionando um Driver
Para mais informações sobre a configuração individual de cada Driver, consulte os respectivos arquivos de ajuda que
acompanham os Drivers, onde constam instruções sobre a configuração dos parâmetros [P] e demais propriedades,
acessíveis pela janela de configuração do Driver.
177 Drivers
6.1.1.1 Teste de Comunicação
Ao configurar um Driver, o usuário pode realizar um procedimento de teste a fim de verificar se os valores estão
corretos e sendo atualizados sem problemas. Ao clicar com o botão direito do mouse no Driver de Comunicação, é
possível utilizar a opção Ativar Comunicação.
Desta forma, o Driver especificado é carregado e os valores das variáveis podem ser visualizados no campo Valor de
cada Tag de Comunicação no Editor deste objeto. Caso algum dos Tags de Comunicação possua a propriedade
AllowRead em Falso, ou ainda se o Tag de Comunicação não possuir um valor a ser reportado, esta linha aparece
com a cor cinza.
Caso o Tag de Comunicação apresente erro de comunicação a linha se torna vermelha, e caso a comunicação esteja
sem problemas a linha tem a cor azul. Para interromper o monitoramento, clique com o botão direito do mouse no
Driver de Comunicação novamente e selecione a opção Desativar Comunicação.
6.1.2 Funcionamento
O I/O Server é o módulo do Elipse Power responsável pela comunicação com um equipamento. É no processo do
I/O Server que é carregada a DLL do Driver e efetuada a comunicação com o equipamento.
Os Tags de Comunicação possibilitam a leitura ou escrita de um conjunto de valores, utilizando o Driver de
Comunicação onde estão inseridos. Podem ser utilizados também os Blocos de Comunicação para a leitura simultânea
de mais de uma variável. Para acessar cada valor do Bloco de Comunicação utilize o Elemento de Bloco de
Comunicação, que pode ser incluído dentro do objeto. Estes objetos são discutidos nos tópicos seguintes.
Por padrão, o Elipse Power cria um I/O Server para cada Driver de Comunicação em tempo de execução. Baseado no
tempo de varredura, a propriedade Scan de cada Tag, o Driver de Comunicação requisita periodicamente o valor de
cada um. Sempre que o valor ou a qualidade do Tag de Comunicação é alterado, o valor é repassado para o Driver
de Comunicação.
A verificação do tempo de ciclo de cada variável é realizada de forma sequencial. Caso o ciclo de uma variável esteja
vencido, o I/O Server prossegue com o questionamento do valor, passando para a próxima variável até que a
verificação de toda a planilha esteja completa, para então retornar ao topo para uma nova varredura.
Pode-se reservar um tempo de ciclo menor para as variáveis com necessidade de atualização mais veloz, e um tempo
de ciclo maior para as variáveis sem tanta prioridade de atualização. Deve-se ressaltar, entretanto, que a performance
da comunicação depende de uma série de fatores, incluindo o tipo de equipamento, o tipo de interface da
comunicação utilizada, velocidade (baud rate) e taxa de erros, entre outros.
Sempre que o Elipse Power enviar uma solicitação de atribuição de valores para uma ou mais variáveis, esta
solicitação é executada com prioridade em relação à varredura dos Tags de Comunicação.
No caso de falha de um I/O Server, o Elipse Power automaticamente realiza uma reinicialização daquele módulo, de
forma a normalizar o funcionamento. Por outro lado, o I/O Server interrompe o funcionamento caso não exista
nenhum E3Run (Principal ou Standby) para receber os dados.
Através da propriedade ShareServer, é possível compartilhar o mesmo I/O Server entre vários Drivers de
Comunicação. O primeiro Driver de Comunicação a executar é o responsável por iniciar os procedimentos de
comunicação, como abrir uma porta serial ou iniciar uma interface de comunicação. Os próximos Drivers de
Comunicação compartilhados utilizam o mesmo I/O Server aberto pelo primeiro, o que permite o compartilhamento
das interfaces de comunicação utilizadas pelo Driver de Comunicação.
Isto pode ser vantajoso, já que muitos dos dispositivos de comunicação, tais como modems, portas seriais e outras
interfaces, permitem apenas uma conexão, o que impediria a utilização simultânea por mais de um Driver de
Comunicação. Com o compartilhamento pode-se reutilizar a mesma conexão para mais de um objeto. Deve-se
ressaltar que as configurações dos Drivers de Comunicação compartilhados devem ser iguais para que o
compartilhamento de Drivers de Comunicação funcione corretamente.
Quando o Domínio está em execução, tem-se acesso à interface de execução do Driver de Comunicação, denominada
Gerenciador de Drivers.
Drivers 178
Acesso ao Gerenciador de Drivers
O Gerenciador de Drivers permite visualizar todos os Drivers de Comunicação em execução, exibindo as
propriedades. Nesta janela é possível ordenar os Drivers de Comunicação por qualquer coluna, clicando no nome da
coluna desejada. Também é possível filtrar os valores das colunas, exceto para as colunas Erros de leitura e Erros de
escrita, clicando em e digitando um filtro para a coluna desejada.
Gerenciador de Drivers
Opções disponíveis na janela Gerenciador de Drivers
OPÇÃO DESCRIÇÃO
Nome Informa o nome do Driver
Objeto(s) Informa o nome do objeto Driver de Comunicação

associado ao Driver
Erros de leitura Mostra o total de leituras do Driver, a quantidade de

erros de leitura e percentual de erros em relação ao total
de leituras
Erros de escrita Mostra o total de escritas do Driver, a quantidade de

erros de escrita e percentual de erros em relação ao
total de escritas
Processo Mostra o identificador do processo do I/O Server no

sistema operacional
Estado Mostra o estado atual do Driver (configurado, iniciando,

executando, finalizando, finalizado ou em erro). Se o
Driver está em erro, mostra uma descrição do erro
179 Drivers
OPÇÃO DESCRIÇÃO
Compartilhado Mostra as palavras SIM ou NÃO, informando se o Driver
é compartilhado ou não
Log Mostra o status do log (habilitado ou desabilitado)
Caminho Informa o caminho do Driver no sistema operacional
Habilitar Log Habilita o log do Driver em tempo de execução, sem a

necessidade de reconfigurar a aplicação. Através desta
mesma opção pode-se interromper este procedimento
de gravação
Atualizar Força a atualização dos dados exibidos
6.1.2.1 Utilização de Estampa de Tempo

Alguns equipamentos e protocolos permitem o envio de informações de tempo juntamente com os valores das
variáveis. Os Drivers de Comunicação para tais equipamentos podem, a cada variável consultada, retornar também a
informação deste relógio armazenada na propriedade TimeStamp de cada Tag de Comunicação, com resolução de
um milissegundo.
Quando um equipamento não suporta este tipo de informação, ou quando o Driver não está preparado para isto, o
Driver de Comunicação insere na estampa de tempo o valor de data e hora atual, a partir do relógio do computador.
De posse da estampa de tempo, o Elipse Power utiliza esta informação tanto para a verificação e gravação de
alarmes quanto para a geração de arquivos históricos.
No caso dos Tags de Comunicação serem Elementos de Bloco de Comunicação, é informada a mesma estampa de
tempo para todos os Elementos de Bloco de Comunicação, já que foram consultados no mesmo instante de tempo.
No caso do Driver suportar leituras de variáveis tanto como Bloco de Comunicação quanto como Tag de
Comunicação, caso os Elementos de Bloco de Comunicação possam representar eventos distintos, deve-se preferir o
uso de Tags de Comunicação.
Para mais informações sobre quais equipamentos possuem esta característica, entre em contato com o fabricante.
Para saber quais Drivers ou tipos de variáveis dentro dos equipamentos utilizam a estampa de tempo, consulte a
ajuda dos Drivers ou diretamente o suporte técnico da Elipse Software.
6.1.2.2 Tags Reportados por Eventos

Tags reportados por eventos podem retornar mais de um valor a cada leitura ou então não retornar valor algum.
Os Tags reportados por eventos são destinados à leitura de dados sob demanda, geralmente armazenados no Driver
até serem lidos em uma operação de leitura. São normalmente utilizados para a leitura de eventos, dados de
memória de massa e mensagens não solicitadas recebidas do equipamento.
A documentação do Driver deve especificar quais Tags de Comunicação disponíveis para a aplicação são reportados
a eventos.
A utilização mais comum é para a coleta de Sequência de Eventos (SOE, ou Sequence Of Events). Por exemplo, em
equipamentos que armazenem em memória sequências muito rápidas de variações de Tags digitais ou que
armazenem dados de telemetria em tabelas na memória, os dados podem ser armazenados na memória em tabelas,
como demonstrado nas figuras a seguir.
Tabela com três eventos e apenas um campo de dados
Drivers 180
Tabela com três eventos e seis campos de dados
Para o primeiro exemplo, é necessário um Tag de Comunicação para ler o valor A. O campo Tempo é retornado na
propriedade TimeStamp deste Tag de Comunicação. Já para o segundo exemplo é necessário um Bloco de
Comunicação com seis Elementos de Bloco de Comunicação (de A até F), com o campo Tempo mais uma vez
retornado na propriedade TimeStamp do Bloco de Comunicação.
Em Tags de Comunicação comuns, não reportados por eventos, pode-se configurar um tempo de varredura (scan)
que determina o período em que o valor do Tag de Comunicação é lido. A cada operação de leitura, o Tag retorna
um valor ou Tag de Comunicação, um bloco de valores ou Bloco de Comunicação, ou então pode retornar erro. Para
ler as tabelas descritas anteriormente, neste caso, são necessárias três operações de leitura em cada tabela para
poder ler os três eventos, ou seja, as três linhas da tabela.
Os Tags de Comunicação reportados por eventos também permitem configurar um tempo de varredura. Para estes
Tags de Comunicação, entretanto, cada operação de leitura pode retornar uma série de valores ou blocos de valores,
com qualidades e estampas de tempo próprios, ou seja, no caso de utilizar Tags de Comunicação reportados por
eventos para ler as tabelas anteriores, é possível obter os três eventos, ou seja, os dados das três linhas de cada
tabela, de uma vez só em uma única operação de leitura ou um único scan.
A leitura dos valores retornados por Tags de Comunicação reportados por eventos é realizada através do evento
OnRead do Tag de Comunicação. A cada operação de leitura que retorne valores, a aplicação dispara uma sucessão
de eventos OnRead. Para cada valor ou evento retornado, a aplicação preenche as propriedades do Tag de
Comunicação (valor, estampa de tempo e qualidade) com os valores do evento específico e então dispara o evento
OnRead.
Caso o Driver não possua eventos ou valores a retornar, a operação de leitura reportada a eventos, ao contrário do
que ocorre com os Tags de Comunicação comuns, pode não retornar dado algum e nem gerar erros, como se a
operação de leitura não houvesse ocorrido.
O tempo de varredura ou scan de Tags de Comunicação reportados por eventos geralmente pode ser configurado
com um valor bem baixo, pois o consumo de CPU, caso não existam valores a retornar, é geralmente desprezível.
A propriedade TimeStamp destes Tags de Comunicação em geral contém um valor fornecido pelo próprio
equipamento.
NOTA
Os Tags de Comunicação reportados por eventos devem ser configurados com a propriedade EnableDeadBand
desabilitada. Isto evita que eventos com valores muito próximos sejam desprezados pela aplicação.
6.1.2.2.1 Gravação de Eventos em um Histórico

O uso mais comum da leitura de Tags de Comunicação reportados por eventos é a gravação dos eventos retornados
em um objeto Histórico. Para isto, siga estes procedimentos:
1. Crie um objeto Histórico com varredura desabilitada, ou seja, com a propriedade ScanTime igual a zero, e sem
banda morta, ou seja, com a propriedade DeadBand igual a zero.
2. Associe as propriedades TimeStamp e os valores do Tag de Comunicação ao Histórico. Pode-se também
associar outras propriedades, caso seja importante armazená-las.
3. Utilize o método WriteRecord do objeto Histórico no evento OnRead do Tag de Comunicação.
Desta forma, garante-se que cada valor reportado a evento que chegar seja gravado sequencialmente no Histórico
associado.
6.1.2.3 Pool de Processos I/O Server

Em aplicações com centenas de Drivers, os recursos necessários para executar os processos I/O Server para cada
Driver podem esgotar a capacidade do sistema operacional. Nestes casos, pode ser necessário habilitar o Pool de
Processos IOServer na aba Propriedades da configuração do Domínio.
181 Drivers
Quando este Pool está habilitado, cada processo I/O Server pode executar mais de um Driver, economizando desta
forma recursos do sistema operacional e permitindo que uma aplicação chegue a executar milhares de Drivers.
Apenas Drivers que suportam a criação de novas instâncias dinâmicas, ou seja, Drivers compilados com o IOKit v2.0.6
ou superior, podem ser utilizados neste Pool. Se um Driver que não tem este suporte é adicionado ao Pool, este Driver
não é executado, ou seja, falha. Para estes casos, configure a propriedade DisableIOServerPool do Driver de
Comunicação para Verdadeiro para que este Driver execute fora do Pool, em um processo I/O Server exclusivo.
Na aba Propriedades da configuração do Domínio, pode-se controlar o número máximo de processos I/O Server no
Pool, bem como o número máximo de Drivers que executam em cada I/O Server.
Opções de comportamento do Pool de Processos I/O Server
DRIVERS POR PROCESSO NÚMERO MÁXIMO DE PROCESSOS COMPORTAMENTO DO POOL
0 M À medida que os Drivers da aplicação
são ativados, é criado um processo
I/O Server para cada Driver, até atingir
o número máximo M. Depois deste
ponto, cada novo Driver que é ativado
é adicionado ao I/O Server do Pool
que contém a menor quantidade de
Drivers
N 0 À medida que os Drivers da aplicação
são ativados, o Elipse Power os
adiciona a um processo I/O Server do
Pool que ainda não tenha atingido o
número máximo N de Drivers
executando dentro do Pool. Se todos
os processos do Pool estiverem no
limite máximo, então um novo I/O
Server é adicionado ao Pool
N M À medida que os Drivers da aplicação
são ativados, o Elipse Power os
adiciona a um processo I/O Server do
Pool que ainda não tenha atingido o
número máximo N de Drivers
executando dentro do Pool. Se todos
os processos do Pool estiverem no
limite máximo, o comportamento
depende da quantidade de processos
no Pool, e se o número de processos
do Pool é menor que o máximo M,
então um novo processo é adicionado
ao Pool, caso contrário o Driver é
adicionado no processo que tiver
menos Drivers executando. NOTA:
Neste modo, o número máximo de
Drivers por processo (N) pode ser
ultrapassado caso o número total de
Drivers do aplicativo exceda N × M
NOTAS
· Ao agrupar Drivers em um mesmo processo I/O Server, perde-se o isolamento entre estes Drivers. Desta forma, se
ocorrer uma falha em um destes Drivers, o I/O Server é fechado e todos os Drivers que executavam naquele I/O
Server têm de ser reiniciados.
· Existe um limite no número de Drivers que podem executar em um processo I/O Server. Este limite depende de
diversas variáveis, tais como o sistema operacional em uso, a quantidade de memória, threads e recursos que cada
Driver específico está ocupando. Em linhas gerais, não se deve adicionar mais do que 100 Drivers em um único I/O
Server, sob pena de exceder os limites do sistema operacional.
Drivers 182
6.1.3 Pasta de Comunicação
A Pasta de Comunicação define grupos e subdiretórios de forma a organizar as variáveis. Cada Pasta de
Comunicação pode ser renomeada conforme a necessidade e novas Pastas de Comunicação podem ser inseridas
dentro de outras. Para utilizar este recurso, siga este procedimento:
1. No Organizer, clique com o botão direito do mouse no Driver de Comunicação e selecione a opção Inserir - Nova
Pasta.
Inserindo uma nova Pasta
6.1.4 Tag de Comunicação

O Tag de Comunicação possibilita a leitura ou a escrita de um conjunto de valores utilizando um Driver de
Comunicação. É utilizado para definir a troca de informações com os equipamentos de aquisição, que consistem em
uma única variável independente.
O Tag de Comunicação pode ser uma variável analógica, de entrada, de saída, contador, ou ponto digital, entre
outras. Vários pontos digitais podem ser agrupados no Tag de Comunicação e acessados através das propriedades,
como bits de dados. Os Tags de Comunicação são configurados através de uma série de parâmetros N, de N1 a N4,
que variam de acordo com o Driver a ser utilizado. Para utilizar este recurso, siga estes procedimentos:
1. Clique com o botão direito do mouse no Driver de Comunicação e selecione a opção Inserir - Tag de
Comunicação.
183 Drivers
Inserindo um Tag de Comunicação
2. A janela da figura a seguir é mostrada, perguntando quantos Tags devem ser criados no Driver de Comunicação e
qual o nome. Este nome é autoincrementado e, se esta opção é deixada em branco, os Tags de Comunicação são
criados com um nome padrão.
Inserindo Tags de Comunicação

Caso o equipamento utilizado para coletar os dados informe valores de Tags de Comunicação que precisam ser
convertidos, pode-se utilizar as escalas dos Tags de Comunicação, que são basicamente uma especificação de uma
conversão linear entre duas bases diferentes.
Para isto, deve-se habilitar a propriedade EnableScaling do Tag de Comunicação e informar os parâmetros DeviceLow
e DeviceHigh, através das respectivas propriedades, que seriam os limites inferior e superior do dado vindo do
equipamento, além de informar os parâmetros EULow e EUHigh, através das respectivas propriedades, que são 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 informações sobre as funcionalidades das propriedades deste objeto
podem ser encontradas no Manual de Referência e Scripts do Elipse Power, em seu capítulo respectivo.
Drivers 184
6.1.5 Bloco de Comunicação
O Bloco de Comunicação é utilizado para definir a troca de informações com os equipamentos de aquisição, que
consistem de uma ou mais variáveis, desde que seja consecutivo no endereçamento dentro do dispositivo externo.
Dependendo do método de comunicação utilizado, podem economizar tempo de comunicação, obtendo um número
maior de atualizações em um mesmo intervalo de tempo se comparado com o Tag de Comunicação. Os Blocos de
Comunicação são configurados através de uma série de parâmetros B, de B1 a B4, que variam de acordo com o
Driver a ser utilizado, além da propriedade Size, que define o número de Elementos de Bloco de Comunicação ou
índices disponíveis no Bloco de Comunicação. Para utilizar este recurso, siga estes procedimentos:
1. Clique com o botão direito do mouse no Driver de Comunicação e selecione a opção Inserir - Bloco de
Comunicação.
Inserindo um Bloco de Comunicação

2. A janela da figura a seguir é mostrada, perguntando quantos Blocos de Comunicação devem ser criados no Driver
de Comunicação e qual o nome. Este nome é autoincrementado e, se esta opção é deixada em branco, os Blocos
de Comunicação são criados com um nome padrão.
185 Drivers
Inserindo Blocos de
Comunicação
3. A caixa de diálogo da figura a seguir é mostrada, para determinar o número de Elementos de Bloco de
Comunicação neste objeto. Nesta opção é possível indicar o mapeamento de todos os Elementos de Bloco de
Comunicação ou somente em um determinado intervalo de Elementos de Bloco de Comunicação.
Configurando o Bloco de Comunicação

4. Informe o tamanho do Bloco de Comunicação e a opção de mapeamento.
5. Clique em OK.
6. Caso necessite, configure as propriedades do objeto.
Algumas das propriedades do Bloco de Comunicação podem ser configuradas através da Lista de Propriedades, sem
a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para maiores informações, consulte o Manual de Referência e Scripts do
Elipse Power.
6.1.6 Elemento de Bloco de Comunicação

Os Elementos de Bloco de Comunicação representam as associações de cada uma das posições no Bloco de
Comunicação, de forma a serem utilizados como se fossem Tags de Comunicação. Os Elementos de Bloco de
Comunicação podem apontar livremente para cada índice dentro de um Bloco de Comunicação. Podem existir dois
Elementos de Bloco de Comunicação apontando para o mesmo índice do Bloco de Comunicação, e também um
número menor, igual ou maior de Elementos de Bloco de Comunicação do que o número de variáveis declaradas no
Bloco de Comunicação. Para utilizar este recurso, siga este procedimento:
1. Clique com o botão direito do mouse no Bloco de Comunicação e selecione a opção Inserir - Elemento de
Comunicação.
Drivers 186
Inserindo um Elemento de Bloco de Comunicação
Caso o equipamento utilizado para coletar os dados informe valores de Elementos de Bloco de Comunicação que
precisam ser convertidos, pode-se utilizar as escalas dos Elementos de Bloco de Comunicação, que são basicamente
uma especificação de uma conversão linear entre duas bases diferentes.
Para isto, deve-se habilitar a propriedade EnableScaling do Elemento de Bloco de Comunicação e informar os
parâmetros DeviceLow e DeviceHigh, através das respectivas propriedades, que são os limites inferior e superior do
dado vindo do equipamento, além dos parâmetros EULow e EUHigh, através das respectivas propriedades, que são os
limites inferior e superior do dado já em unidades de engenharia.
Algumas das propriedades do Elemento de Bloco de Comunicação podem ser configuradas através da Lista de
Propriedades, sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a
na Lista de Propriedades e execute os devidos ajustes. Para maiores informações, consulte o Manual de Referência e
Scripts do Elipse Power.
6.2 Servidor OPC

Além de possuir um cliente OPC (Driver OPC), o Elipse Power funciona também como Servidor OPC DA (Data Access)
2.0x. Isto permite ao Elipse Power expor todos os objetos existentes no Domínio em execução (Tags de Comunicação,
por exemplo) para softwares externos ao Elipse Power. Como exemplos, pode-se citar o Elipse SCADA, o Elipse
Power (que pode estar executando em outra aplicação como cliente), ou um cliente OPC de outro fabricante, basta
que o cliente implemente o padrão OPC DA 2.0x ou superior.
NOTA
O Servidor OPC no Elipse Power é um módulo adicional a partir da versão 3.0, e necessita de licença específica no
dispositivo de proteção. Entre em contato com a Elipse Software para mais informações.
6.2.1 Características
Para usar o Servidor OPC do Elipse Power não é necessária nenhuma configuração extra, basta executar o Domínio
para que qualquer cliente OPC possa se comunicar com o Elipse Power. Para conectar-se ao servidor OPC do Elipse
Power de um cliente qualquer, selecione o servidor identificado como Elipse.OPCSvr.1.
O Servidor OPC permite que qualquer cliente importe facilmente toda a definição de Tags existentes no Domínio
(função Browse). Naturalmente, os Tags fornecidos são apenas os objetos que são parte do servidor, ou seja, itens de
Tela (Elipse Power Viewer) não são acessíveis pelo Servidor OPC.
187 Drivers
Por ser baseado na mesma tecnologia de associações usada nas associações internas entre objetos, o Servidor OPC
do Elipse Power permite que clientes usem Tags que sejam expressões matemáticas, e com o recurso de conexão e
desconexão transparente durante a execução.
6.2.2 Informações de Status

Através da informação de status (funcionalidade padrão do OPC), o cliente OPC pode identificar se o servidor do
Elipse Power encontra-se sem Domínio, em modo Standby ou executando normalmente. Os valores possíveis para o
status do OPC são os seguintes:
· OPC_STATUS_RUNNING: Domínio executando normalmente
· OPC_STATUS_SUSPENDED: Domínio em modo Standby
· OPC_STATUS_NOCONFIG: Domínio parado ou sem Domínio
6.2.3 Desconexão
Para os clientes OPC que suportam o mecanismo de desligamento (shutdown), sempre é enviado um aviso quando o
Domínio é parado ou entra em modo Standby. Após o aviso, todos os clientes são desconectados.
6.3 Driver de Comunicação OPC

O Driver de Comunicação OPC é o módulo responsável por coletar dados de equipamentos externos através da
execução de um Servidor OPC, que pode ser fornecido por qualquer empresa. Os Tags podem ser importados para o
Driver OPC dentro do Elipse Power, que neste caso atua como um OPC Client, ou ainda podem ser criados a partir do
Elipse Power. Para utilizar um Driver OPC, siga este procedimento:
1. Clique com o botão direito do mouse no nome do projeto no Explorer e selecione a opção Inserir - Driver de
Comunicação OPC. No modo Domínio, clique com o botão direito do mouse no item Objetos de Servidor -
Drivers e OPC, selecione a opção Inserir Driver de Comunicação OPC Em e logo após o nome do projeto
desejado.
Inserindo um Driver OPC

Ao inserir um Driver OPC em uma aplicação no Elipse Power Studio, abre-se o Editor do objeto, conforme a figura a
seguir.
Drivers 188
Editor do Driver de Comunicação OPC
As opções disponíveis neste Editor estão descritas na tabela a seguir.
Opções disponíveis no Editor do Driver OPC
OPÇÃO DESCRIÇÃO
Adicionar Adiciona um Grupo de Tags OPC ao Driver de
Comunicação OPC, um Tag de Comunicação OPC, um
Bloco de Comunicação OPC ou uma Pasta OPC ao
Grupo de Tags OPC, ou um Elemento de Bloco OPC ao
Bloco de Comunicação OPC
Remover Remove o item selecionado no Editor
Selecionar Servidor Seleciona o Servidor OPC
Ativar ou Desativar Comunicação Ativa e desativa a comunicação do Driver de

Comunicação OPC. A opção de ativação só está
disponível se a propriedade ServerId está configurada
Importar Tags Importa Tags de Comunicação OPC para o Driver de

Comunicação OPC
Informações Sobre o Servidor Mostra uma janela com as configurações do Driver de

Comunicação OPC
Contagem de Tags Apresenta o número total de Tags de Comunicação OPC

no Driver de Comunicação OPC
NOTAS
· A opção Ativar ou Desativar Comunicação implica em um número suficiente de licenças para todos os Tags de
Comunicação OPC e Elementos de Bloco OPC presentes no Driver de Comunicação OPC. Se não há licenças
suficientes para todos os Elementos de um Bloco de Comunicação OPC, o Bloco de Comunicação OPC inteiro não
comunica. Consulte o tópico Licenças para mais informações sobre este comportamento.
· A opção Contagem de Tags leva em consideração o número de Tags de Comunicação OPC mais o número de
Elementos de Bloco OPC presentes no Driver de Comunicação OPC.
A identificação dos outros objetos pertencentes ao Driver OPC pode ser inserida manualmente, ou então ser trazida
automaticamente do Servidor OPC. Para isto, abra a Janela de Propriedades do Driver, clicando com o botão direito
do mouse no objeto e selecionando a aba OPC Driver.
189 Drivers
Aba OPC Driver
Informe o Endereço e ID do Servidor e clique em Selecionar. A janela da figura a seguir é mostrada.
Seleção do Servidor OPC

As opções disponíveis no item Opções de busca dos servidores OPC estão descritas na tabela a seguir.
Opções disponíveis no item Opções de busca dos servidores OPC
OPÇÃO DESCRIÇÃO
Tentar enumerador padrão ou registro (recomendado) O Elipse Power tenta procurar as especificações do
Driver tanto pelo Registro do Windows quanto pelo
enumerador padrão OPC (OPCENUM)
Tentar apenas enumerador padrão (serviço OPCENUM) O Elipse Power tenta procurar as especificações do
Driver apenas pelo enumerador padrão OPC
(OPCENUM)
Tentar apenas pesquisa no registro O Elipse Power tenta procurar as especificações do

Driver apenas pelo Registro do Windows
Drivers 190
Clicando em OK, o Elipse Power Studio mostra os dados do Driver, indicando os caminhos e o nome do servidor.
Para ativar a comunicação do Driver OPC, clique em Ativar Comunicação.
Ativar comunicação do
Driver OPC
Quando a comunicação é ativada, são habilitadas as opções Informações Sobre o Servidor e Importar Tags, além da
opção Desativar Comunicação. Para utilizar estas opções, clique com o botão direito do mouse no Driver OPC e
selecione a opção desejada.
191 Drivers
Opções habilitadas quando o
Driver OPC está ativo
A opção Informações Sobre o Servidor mostra uma janela com as configurações do Driver.
Informações do Servidor OPC

Através da opção Importar Tags, é possível importar Tags para o Driver OPC. Quando esta opção é selecionada, a
caixa de diálogo da figura a seguir é mostrada.
Drivers 192
Mensagem referente à importação de Tags OPC
As opções disponíveis nesta caixa de diálogo são as seguintes:
· Sim: O Elipse Power, ao executar a localização dos Tags OPC, tenta automaticamente detectar quais Tags são do
tipo Bloco e, neste caso, qual o número de Elementos. Para isto, o Elipse Power precisa ler o valor de cada um, o
que dependendo do servidor e do número de Tags, pode ser demorado
· Não: O Elipse Power não lê os valores dos Tags OPC ao realizar a operação de busca. Esta operação é mais
rápida, porém não cria automaticamente Tags OPC de tipo Bloco e seus Elementos
· Cancelar: Cancela a importação
A janela de importação dispõe dos recursos mostrados na figura a seguir.
Importação de Tags OPC

Opções disponíveis na janela Importação de Tags OPC
OPÇÃO DESCRIÇÃO
Nome dos Itens Filtra os Tags a partir do nome dos itens especificados.
Podem ser utilizados caracteres curingas, tais como *
(asterisco) ou ? (ponto de interrogação)
Tipo de dados Filtra os Tags a partir do tipo de dados especificado no

campo, que pode ser Integer, Long, Single, etc.
193 Drivers
OPÇÃO DESCRIÇÃO
Tipo de acesso Filtra os Tags a partir do tipo de acesso especificado no
campo, que pode ser Leitura, Escrita ou Leitura e
Escrita
Mostrar apenas itens com IDs não encontrados no Filtra os Tags para que a aplicação mostre apenas os
projeto itens com IDs não encontrados no projeto
Projeto corrente Mostra os objetos selecionados para adição no projeto

corrente
Servidor OPC Mostra os Tags disponíveis no servidor para importação
Para executar a importação, selecione o Tag desejado e arraste-o para o Driver ou Grupo OPC desejado. Para
desativar a comunicação do Driver OPC, clique em Desativar Comunicação.
Algumas das propriedades do Driver OPC podem ser configuradas através da Lista de Propriedades, sem a
necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Elipse Power.
6.3.1.1 Funcionamento
A comunicação do cliente OPC do Elipse Power com um servidor OPC é feita por um processo separado. Este
processo, quando o Driver OPC é ativado pelo Elipse Power Studio, executa na conta do usuário atual do Windows.
Em tempo de execução, por outro lado, este processo é executado na conta SYSTEM. Alguns servidores OPC podem
ser sensíveis à conta em que estão executando e, por este motivo, pode ser necessário reconfigurar o processo para
que seja executado por um usuário específico. Para isto, siga estes procedimentos:
1. Abra o menu Iniciar - Painel de Controle - Ferramentas Administrativas - Serviços de Componente (Start -
Control Panel - Administrative Tools - Component Services), ou digite dcomcnfg no prompt de comando do
Windows.
2. Expanda o item Config DCOM (DCOM Config) em Serviços de componente - Computadores - Meu computador
(Component Services - Computers - My Computer), clique com o botão direito do mouse no item E3OpcClient e
selecione a opção Propriedades (Properties).
3. Selecione a aba Identidade (Identity), selecione o item Este usuário (This user) e preencha as informações da
conta.
4. Clique em OK e reinicie o computador para que as modificações sejam aplicadas.
6.3.2 Grupo de Tags OPC

O objeto Grupo de Tags OPC agrupa uma série de Tags OPC que compartilham os mesmos parâmetros de
atualização (tempo de varredura e banda morta). É sempre necessário existir um Grupo de Tags OPC para poder criar
Tags OPC. Para inserir um Grupo de Tags OPC, siga este procedimento:
1. Clique com o botão direto do mouse no Driver OPC e selecione a opção Inserir - Grupo de tags OPC.
Drivers 194
Inserindo um Grupo de Tags OPC
Algumas das propriedades do Grupo de Tags OPC podem ser configuradas através da Lista de Propriedades, sem a
Elipse Power.
6.3.3 Pasta OPC

O objeto Pasta OPC define grupos ou subdiretórios, de forma a melhor organizar as variáveis. Cada Pasta OPC pode
ser renomeada conforme a necessidade, e novas Pastas podem ser inseridas dentro de outras. Em tempo de
execução, se a Pasta OPC é desabilitada, todo o conteúdo é desativado. Para utilizar este recurso, siga este
procedimento:
1. Clique com o botão direito do mouse no Grupo OPC e selecione a opção Inserir - Nova Pasta.
195 Drivers
Inserindo uma Pasta OPC
6.3.4 Tag de Comunicação OPC

O Tag de Comunicação OPC é um objeto para leitura ou escrita de valores em um equipamento. A leitura do Tag é
realizada automaticamente pelo Servidor OPC, com tempo de varredura definido no Grupo OPC no qual está inserido.
Para utilizar este recurso, siga estes procedimentos:
1. Clique com o botão direito do mouse no Grupo OPC e selecione a opção Inserir - Tag de Comunicação OPC.
Inserindo um Tag de Comunicação OPC
Drivers 196
2. Abre-se uma janela perguntando quantos Tags devem ser criados no Grupo, e qual o nome. Este nome é
autoincrementado e, se esta opção é deixada em branco, os Tags são criados com um nome padrão.
Inserindo Tags de Comunicação

OPC
Algumas das propriedades do Tag OPC podem ser configuradas através da Lista de Propriedades, sem a necessidade
de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de Propriedades e execute
os devidos ajustes. Para maiores informações, consulte o Manual de Referência e Scripts do Elipse Power.
6.3.5 Bloco de Comunicação OPC

O objeto Bloco de Comunicação OPC possibilita a leitura ou escrita de um conjunto de valores. Para executar uma
escrita, deve-se apenas atribuir um novo valor à propriedade Value. A leitura do Tag é realizada automaticamente
pelo Servidor OPC com tempo de varredura definido no Grupo OPC. A propriedade Size determina o número de
Elementos do Tag no servidor. Para utilizar este recurso, siga estes procedimentos:
1. Clique com o botão direito do mouse no Grupo OPC e selecione a opção Inserir - Bloco de Comunicação OPC.
Inserindo um Bloco de Comunicação OPC

2. Abre-se uma janela perguntando quantos Blocos devem ser criados no Grupo, e qual o nome. Este nome é
autoincrementado e, se esta opção é deixada em branco, os Blocos são criados com um nome padrão.
197 Drivers
Inserindo Blocos de
Comunicação OPC
3. É mostrada uma caixa de diálogo para determinar o número de Elementos de Bloco neste objeto. Nesta opção é
possível indicar o mapeamento de todos os Elementos de Bloco ou somente de um determinado intervalo de
Elementos.

4. Informe o tamanho do Bloco e a opção de mapeamento.
5. Clique em OK.
Algumas das propriedades do Bloco de Comunicação OPC podem ser configuradas através da Lista de Propriedades,
sem a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Elipse Power.
6.3.6 Elemento de Bloco OPC

O objeto Elemento de Bloco OPC possibilita a leitura ou escrita de um dos Elementos do Bloco OPC onde está
inserido.
O Bloco OPC lê uma tabela de dados, e este objeto está sempre associado à posição definida por sua propriedade
Index. Por exemplo, um Elemento de Bloco OPC com Index igual a cinco e inserido em um Bloco OPC com tamanho
10, cujos dados sejam lidos como na tabela a seguir teria sua propriedade Value igual a três.
Tabela 5 12 77 55 1 3 42 20 8 89
Índice 0 1 2 3 4 5 6 7 8 9
NOTA
O Elipse Power pode criar automaticamente os Elementos de Bloco OPC. Para maiores detalhes, veja a opção
Importar Tags, no tópico Configuração.
Para utilizar este recurso, siga este procedimento:

1. Clique com o botão direito do mouse no Bloco OPC e selecione a opção Inserir - Elemento de bloco OPC.
Drivers 198
Inserindo um Elemento de Bloco OPC
Algumas das propriedades do Elemento de Bloco OPC podem ser configuradas através da Lista de Propriedades, sem
a necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Elipse Power.
6.4 Driver de Comunicação OPC UA

O Driver de Comunicação OPC UA implementa a comunicação com um servidor OPC UA que implemente leituras
históricas ou de tempo real, como por exemplo o EPM. Este objeto pode ser usado como fonte de dados de um
objeto Consulta. Para inserir um Driver de Comunicação OPC UA em um projeto, clique com o botão direito do
mouse no nome do projeto no modo Explorer e selecione a opção Inserir - Driver de Comunicação OPC UA. No
modo Domínio, clique com o botão direito do mouse no item Objetos de Servidor - Drivers e OPC, selecione a
opção Inserir Driver de Comunicação OPC UA Em e logo após o nome do projeto desejado.
199 Drivers
Inserindo um Driver de Comunicação OPC UA em modo Domínio
Algumas das propriedades do Driver de Comunicação OPC UA podem ser configuradas através da Lista de
A configuração do objeto Driver de Comunicação OPC UA é semelhante à configuração do Driver de Comunicação
OPC. Para configurá-lo, clique com o botão direito do mouse no objeto e selecione o item Selecionar Servidor .
Drivers 200
Opção Selecionar servidor
A janela a seguir é mostrada, permitindo selecionar um servidor OPC UA na máquina local ou na rede.
Servidores OPC UA locais e na rede
201 Drivers
Para cada servidor OPC UA, tanto locais quanto em rede, são enumerados os pontos de conexão (endpoints), que
podem utilizar diferentes protocolos e modos de segurança. Além disto, para cada ponto de conexão o servidor
também pode suportar diferentes formas de identificação e autenticação de usuários.
Atualmente, o Elipse Power permite a conexão apenas pelo modo TCP Binário. Para este modo, o Elipse Power
suporta os modos de segurança definidos pelo padrão OPC UA, em diversas combinações de políticas de segurança.
Para a autenticação, o Elipse Power suporta apenas os modos Anônimo e Usuário e Senha.
NOTA
A janela Servidores OPC UA lista todos os protocolos e modos de segurança, para informação do usuário.
Entretanto, somente os modos compatíveis com o Elipse Power podem ser selecionados.
Ao selecionar um ponto de conexão compatível com o Elipse Power, as propriedades EndPointURL, SecurityMode e
SecurityPolicy do objeto são automaticamente preenchidas.
Se as propriedades UserName e Password do objeto são deixadas em branco, o Elipse Power utiliza uma conexão
anônima com o servidor. Caso contrário, o Elipse Power envia os valores destas propriedades para o servidor, que
deve suportar este tipo de autenticação no ponto de conexão selecionado.
Neste objeto também é possível configurar diversos limites de tempo (time-outs) da conexão OPC UA. Estes valores de
limite de tempo (propriedades TimeoutCall, TimeoutConnection e TimeoutSession) são sempre em milissegundos
e devem ser ajustados de acordo com a performance da comunicação, que pode ser limitada pelo servidor, pela
rede, pelas máquinas onde executam o cliente e o servidor e até mesmo pelas operações realizadas pelo cliente. Este
ajuste deve ser realizado caso a caso e os valores padrão destas propriedades são apenas sugestões.
No Elipse Power Studio, a comunicação com o Driver pode ser ativada ao selecionar a opção Ativar Comunicação
no menu contextual do objeto. A ativação é executada automaticamente pelos objetos Consulta ao selecionar
servidores, Tags, ou executar a visualização dos resultados de uma consulta na aba Visualizar.
NOTA
A opção Ativar ou Desativar Comunicação implica em um número suficiente de licenças para todos os Tags de
Comunicação OPC UA e Elementos de Bloco OPC UA presentes no Driver de Comunicação OPC UA. Se não há
licenças suficientes para todos os Elementos de um Bloco de Comunicação OPC UA, o Bloco de Comunicação OPC
UA inteiro não comunica. Consulte o tópico Licenças para mais informações sobre este comportamento. A opção de
ativação só está disponível se a propriedade EndPointURL está configurada.
Note que para editar as propriedades do Driver pode ser necessário desativar a comunicação. Se a comunicação
estiver ativa no Elipse Power Studio, é possível abrir uma janela de informações sobre o servidor selecionado ao
selecionar a opção Informações Sobre o Servidor no menu contextual do objeto. Caso a conexão não esteja
estabelecida, por qualquer motivo, esta janela mostra pontos de interrogação no lugar das informações.
6.4.2 Assinatura OPC UA

O objeto Assinatura OPC UA agrupa Tags OPC UA que compartilham o tempo de varredura (a propriedade Scan) e a
possibilidade de habilitar ou desabilitar a leitura de todos os itens de uma vez (a propriedade Enable). A existência de
um objeto Assinatura OPC UA é obrigatória para que se possa criar Tags OPC UA. Para inserir um objeto Assinatura
OPC UA, siga este procedimento:
1. Clique com o botão direto do mouse no Driver OPC UA e selecione a opção Inserir - Assinatura OPC UA.
Drivers 202
Inserindo uma Assinatura OPC UA
Algumas das propriedades do objeto Assinatura OPC UA podem ser configuradas através da Lista de Propriedades,
Elipse Power.
6.4.3 Pasta OPC UA

O objeto Pasta OPC UA define grupos ou subdiretórios, de forma a melhor organizar as variáveis. Cada Pasta OPC
UA pode ser renomeada conforme a necessidade, e novas Pastas podem ser inseridas dentro de outras. Em tempo
de execução, se a Pasta OPC UA é desabilitada, todo seu conteúdo é desativado. Para utilizar este recurso, siga este
procedimento:
1. Clique com o botão direito do mouse no objeto Assinatura OPC UA e selecione a opção Inserir - Pasta.
203 Drivers
Inserindo uma Pasta OPC UA
6.4.4 Tag de Comunicação OPC UA

O Tag de Comunicação OPC UA é um objeto para leitura ou escrita de valores em um equipamento. A leitura do Tag
é realizada automaticamente pelo servidor OPC UA, com tempo de varredura definido na Assinatura OPC UA na qual
está inserido. Para utilizar este recurso, siga estes procedimentos:
1. Clique com o botão direito do mouse no objeto Assinatura OPC UA e selecione a opção Inserir - Tag de
Comunicação OPC UA.
Inserindo um Tag de Comunicação OPC UA
Drivers 204
2. Abre-se uma janela perguntando quantos Tags devem ser criados na Assinatura, e qual o nome. Este nome é
autoincrementado e, se esta opção é deixada em branco, os Tags são criados com um nome padrão.
Configurando a quantidade de
Tags
Algumas das propriedades do Tag OPC UA podem ser configuradas através da Lista de Propriedades, sem a
Elipse Power.
6.4.5 Bloco de Comunicação OPC UA

O objeto Bloco de Comunicação OPC UA possibilita a leitura ou escrita de um conjunto de valores. Para executar uma
escrita, deve-se apenas atribuir um novo valor à propriedade Value. A leitura do Tag é realizada automaticamente
pelo servidor OPC UA com tempo de varredura definido na Assinatura OPC UA. A propriedade Size determina o
número de Elementos do Tag no servidor.
NOTA
Na versão atual, o Elipse Power só permite que vetores de uma dimensão (arrays) sejam mapeados para Blocos de
Comunicação, embora o padrão OPC UA suporte matrizes n-dimensionais como tipos de dados.

1. Clique com o botão direito do mouse na Assinatura OPC UA e selecione a opção Inserir - Bloco de Comunicação
OPC UA.
Inserindo um Bloco de Comunicação OPC UA
205 Drivers
2. Abre-se uma caixa de diálogo para indicar quantos Blocos devem ser criados na Assinatura, e qual o nome. Este
nome é autoincrementado e, se esta opção é deixada em branco, os Blocos são criados com um nome padrão.
Configurando a quantidade de
Blocos
3. Abre-se uma caixa de diálogo para determinar o número de Elementos de Bloco neste objeto. Nesta opção é
possível indicar o mapeamento de todos os Elementos de Bloco ou somente de um determinado intervalo de
Elementos.

OPC UA
4. Informe o tamanho do Bloco e a opção de mapeamento.
5. Clique em OK.
Algumas das propriedades do Bloco de Comunicação OPC UA podem ser configuradas através da Lista de
6.4.6 Elemento de Bloco OPC UA

O objeto Elemento de Bloco OPC UA possibilita a leitura ou escrita de um dos Elementos do Bloco OPC UA onde está
inserido. O Bloco OPC UA lê uma tabela de dados, e este objeto está sempre associado à posição definida por sua
propriedade Index. Para utilizar este recurso, siga este procedimento:
1. Clique com o botão direito do mouse no Bloco OPC UA e selecione a opção Inserir - Elemento de bloco OPC UA.
Drivers 206
Inserindo um Elemento de Bloco OPC UA
Algumas das propriedades do Elemento de Bloco OPC UA podem ser configuradas através da Lista de Propriedades,
Elipse Power.
6.4.7 Objeto Consulta

Para configurar um objeto Consulta para buscar dados em um servidor OPC UA utilizando o Driver OPC UA, siga estes
procedimentos:
1. Selecione um Driver OPC UA na janela Defina o Servidor de Banco de Dados da Consulta.
Selecionar Driver OPC UA

2. A janela a seguir é mostrada, permitindo configurar a Consulta.
207 Drivers
Aba Campos
As opções disponíveis na aba Campos estão descritas na tabela a seguir.
Opções disponíveis na aba Campos
OPÇÃO DESCRIÇÃO
Dados Brutos A Consulta retorna os dados como são armazenados no
servidor, semelhante à consulta
CompressedDataStartEndTime do objeto Storage.
Neste modo, apenas um Tag pode ser consultado por
vez, retornando também a qualidade do valor
Dados Processados A Consulta retorna dados agregados dentro de um

intervalo de tempo, semelhante às consultas
SampledData e CalculatedData do objeto Storage.
Neste modo, vários Tags podem ser consultados por
vez, mas não retornam a qualidade do valor. Diversas
funções de agregação podem ser utilizadas, como por
exemplo médias, máximos, interpolações, etc. Funções
diferentes podem ser usadas para cada Tag e um
mesmo Tag pode aparecer várias vezes na Consulta,
com funções de agregação diferentes. O Elipse Power
apenas lista as funções padrão, sem buscar funções
específicas do servidor ou filtrar funções não suportadas
pelo servidor. A Consulta pode falhar caso seja
selecionada uma função não suportada pelo servidor
OPC UA
Adicionar Campo Adiciona um ou mais Tags do servidor OPC UA
Remover Campo Remove o Tag selecionado da Consulta
Atualizar Força a atualização dos Identificadores de Nós OPC UA

(NodeIds)
Drivers 208
OPÇÃO DESCRIÇÃO
Id Tipo de Identificador de Nó OPC UA (NodeId) no
servidor
Colunas Caminho do Tag no servidor OPC UA
Título Nome do Tag no servidor OPC UA
Função Função utilizada no Tag. Esta coluna só está disponível

quando a opção Dados Processados está selecionada
Ao clicar em Adicionar Campo , a janela a seguir é mostrada, permitindo selecionar os Tags existentes no servidor.
Seleção de Tags OPC UA

As abas Variáveis e Visualizar têm o mesmo comportamento descrito no capítulo Consultas.
6.4.8 Certificados
Durante a instalação do Elipse Power, é instalado um certificado relativo à instância do cliente OPC UA do Elipse
Power. Este certificado é necessário sempre que é utilizada uma conexão com o servidor cujo modo de segurança
(propriedade SecurityMode) não seja igual a None, ou seja, uma conexão OPC UA segura.
Este certificado pode ser encontrado na pasta CertificateStore/certs da instalação do Elipse Power, em um arquivo
chamado Elipse E3 UA Client [xxx].der, onde xxx é um código gerado aleatoriamente.
Se este certificado é apagado, um novo é gerado automaticamente sempre que o Driver OPC UA tentar estabelecer
uma conexão com um servidor.
NOTAS
· Apagar o certificado pode significar ter que atualizar os servidores OPC UA com o novo certificado, ou então a
conexão segura com o cliente do Elipse Power pode ser negada.
· Este certificado corresponde à instância do cliente, e não ao cliente OPC UA do Elipse Power, ou seja, este
certificado NÃO pode ser copiado de uma máquina para outra. Cada instalação tem um certificado único.
· O cliente OPC UA do Elipse Power aceita qualquer certificado válido de servidor, ou seja, não é necessária
nenhuma configuração para que o cliente do Elipse Power aceite uma determinada instância de servidor OPC UA.
6.4.9 Limitações na Leitura de Tipos de Dados

O Driver de Comunicação OPC UA do Elipse Power suporta tipos de dados básicos e vetores de uma dimensão, bem
como alguns tipos de estruturas definidas pelo padrão OPC UA. São suportados valores escalares e vetores dos
seguintes tipos de dados:
· Tipos de dados suportados plenamente: SByte, Byte, Int16, UInt16, Int32, UInt32, Int64, UInt64, Float, Double,
Boolean, String, DateTime e ByteString
· Tipos de dados suportados com limitações: DataValue (ignora a estampa de tempo e a qualidade),
LocalizedText (ignora a configuração regional), QualifiedName (ignora o NamespaceIndex), StatusCode
209 Drivers
(convertido para SCode ou HRESULT), Guid (convertido para texto), ArrayQualifiedName, ArrayLocalizedText,
Structure, ArrayStructure, ArrayDataValue, Unknown e ArrayUnknown (não permitem a escrita na versão atual
do Elipse Power)
· Tipos de dados suportados convertidos para vetores de uma dimensão de tamanho fixo: Estes tipos de
dados são retornados como vetores de Variants, em que cada um dos campos é um item do vetor. Se o campo
é outro objeto, o Variant contém outro vetor, e assim por diante. Os tipos de dados suportados são
ServerDiagnosticsSummaryDataType, SubscriptionDiagnosticsDataType,
SessionSecurityDiagnosticsDataType, SessionDiagnosticsDataType, ApplicationDescription, Argument,
BuildInfo, ServiceCounterDataType, ExpandedNodeId, NodeId, ServerStatusDataType, EUInformation, Range,
TimeZoneDataType, StatusResult, ComplexNumberType, DoubleComplexNumberType, XVType,
RedundantServerDataType, SamplingIntervalDiagnosticsDataType, EnumValueType, NetworkGroupDataType
e EndpointUrlListDataType
NOTA
Estruturas definidas por servidores específicos, não compatíveis com o padrão OPC UA, não são lidas pelo Elipse
Power.
Nos campos da consulta, o texto dos caminhos dos Tags do servidor segue o padrão OPC UA de caminhos relativos.
Os componentes deste caminho são os seguintes:
· / (barra): Indica uma referência hierárquica qualquer
· . (ponto): Indica uma referência de agregação qualquer
· [ns:]browse-name: A String que segue uma barra ou ponto especifica o nome de browse de um item. Este nome
pode ser prefixado com seu índice de Namespace. Se é omitido, assume o índice 0 (zero)
· & (e comercial, caractere de escape): Insere um caractere reservado no local. Por exemplo, a expressão
"&/Nome" é substituída por "/Nome". Os caracteres reservados são os seguintes:
· / (barra)
· . (ponto)
· < (menor que)
· > (maior que)
· : (dois pontos)
· # (sinal numérico)
· ! (ponto de exclamação)
· & (e comercial)
A definição formal de um caminho OPC UA, em notação BNF, é a seguinte:

<caminho-relativo> ::= <tipo-referencia> <nome-browse>
<tipo-referencia> ::= '/' | '.' | '<' ['#'] ['!']
<nome-browse> '>'
<nome-browse> ::= [<indice-namespace> ':'] <nome>
<indice-namespace> ::= <digito> [<digito>]
<digito> ::= '0' | '1' | '2' | '3' | '4' | '5'
| '6' | '7' | '8' | '9'
<nome> ::= (<caractere-nome> | '&' <caractere-reservado>)
[<nome>]
<caractere-reservado> ::= '/' | '.' | '<' | '>' | ':'
| '#' | '!' | '&'
<caractere-nome> ::= Todos os caracteres válidos
para uma String, exceto caracteres reservados.
O Elipse Power não suporta Identificadores de Nós OPC UA (NodeIds) que não sejam do servidor onde é executado
o browse dos Tags (servidores Gateway). Estes Tags, portanto, não são mostrados na janela de seleção de servidores.
Além disto, os caminhos são sempre hierárquicos e apenas os tipos de referência barra (/) e ponto (.) são suportados
(o tipo <browse-name> não é suportado).
6.5 Qualidade
Os campos de qualidade representam o estado da qualidade do valor do item. É formado de uma palavra de 16 bits,
em que os primeiros oito bits são definidos na forma de três campos de bits, Qualidade, Substatus e Limite.
Drivers 210
Os outros oito bits de maior ordem estão disponíveis para uso de cada fabricante. Se estes bits são utilizados, os bits
de qualidade padrão ainda são utilizados para indicar quais interpretações pode-se realizar sobre os dados
retornados. Assim, é de responsabilidade do cliente interpretar o campo de informações específicas de qualidade,
para garantir que o servidor que está provendo esta informação usa as mesmas regras do cliente.
Opções disponíveis no campo Qualidade
QUALIDADE CAMPO QUALIDADE DESCRIÇÃO
0 - 63 Ruim O valor não é útil pelas razões
indicadas no campo Substatus
64 - 127 Incerta A qualidade do valor é incerta pelas

razões indicadas no campo
Substatus
128 - 191 (Reservado) Não é usado pelo padrão OPC
192 - 255 Boa A qualidade do valor é boa
Um servidor que não suporta informação de qualidade retorna 192 (Bom) sempre. Também é aceitável que um
servidor retorne simplesmente 0 ou 192 (Ruim ou Bom) e sempre retorne 0 (zero) para o Substatus e para o Limite.
6.5.1 Campo Substatus

O layout deste campo depende do valor do campo Qualidade.
Substatus para Qualidade RUIM
SUBSTATUS DESCRIÇÃO LIMITE
SEM LIMITE BAIXO ALTO CONSTANTE
Não específico O valor é ruim, 0 1 2 3
mas nenhuma
razão especifica é
conhecida
Erro de Há algum 4 5 6 7
Configuração problema de
configuração
específico no
servidor. Por
exemplo, o item
em questão pode
ter sido apagado
Não Conectado A entrada deveria 8 9 10 11

estar logicamente
conectada a algo,
mas não está. Esta
qualidade pode
refletir que não há
valor disponível
neste momento,
pois o valor pode
não ter sido
fornecido pela
fonte de dados
Falha de Uma falha de 12 13 14 15

Dispositivo dispositivo foi
detectada
211 Drivers
Falha de Sensor Uma falha de 16 17 18 19
sensor foi
detectada (o
campo Limite
pode conter
informação
adicional)
Último valor Comunicação em 20 21 22 23

conhecido falha. Entretanto, o
último valor
conhecido está
disponível. Note
que a idade do
valor pode ser
determinada pela
propriedade
TimeStamp
Falha de A comunicação 24 25 26 27
Comunicação falhou. Não há
último valor
conhecido
disponível
Fora de Serviço O Bloco está fora 28 29 30 31

de scan ou
trancado
N/A Não utilizado 32 - 63
Substatus para Qualidade INCERTA

Não específico Não há razão 64 65 66 67
específica
Drivers 212
Último valor O dispositivo que 68 69 70 71
utilizável estava fornecendo
o valor parou de
fornecê-lo. O valor
retornado deve
ser considerado
velho. Note que
isto difere de um
valor Ruim com o
Substatus 5
(último valor
conhecido).
Aquele estado é
associado com
uma falha
detectável de
comunicação em
um valor buscado.
Este erro é
associado com a
falha de alguma
fonte externa que
iria inserir algo no
valor dentro de
um período
aceitável. Note
que a idade do
valor pode ser
determinada na
propriedade
TimeStamp
Não utilizado Não utilizado 72 - 79
Sensor impreciso O valor está 80 81 82 83

colado em um dos
limites do sensor
(neste caso o
campo Limite
deve estar
configurado para
um ou dois) ou o
sensor está de
algum modo
conhecido fora de
calibração via
algum diagnóstico
interno (neste
caso o campo
Limite deve ser
zero)
213 Drivers
Unidade de O valor retornado 84 85 86 87
engenharia está fora dos
excedida limites definidos
para este
parâmetro. Note
que neste caso o
valor do campo
Limite indica
quais limites
foram excedidos,
mas não
necessariamente
implica que o
valor não possa ir
mais além da faixa
especificada
Subnormal O valor é derivado 88 89 90 91

de múltiplas
fontes e há um
número menor do
que o requerido
de fontes boas
NOTA
Servidores que não suportam o Substatus devem retornar 0 (zero).
Substatus para Qualidade BOA

Não específico O valor é bom. 192 193 194 195
Não há condições
especiais
Forçado Tipicamente indica 216 217 218 219

localmente que a entrada foi
desconectada e
um valor manual
foi forçado
Não específico Não utilizado 220 - 255
NOTA
Servidores que não suportam o Substatus devem retornar 0 (zero).
6.5.2 Campo Limite

O campo Limite é válido independente dos campos Qualidade e Substatus. Em alguns casos, como uma falha de
sensor, este campo pode prover informações de diagnóstico.
Campo Limite
ESPECIFICAÇÃO DESCRIÇÃO
Não Limitado O valor é livre para mover-se acima ou abaixo
Drivers 214
ESPECIFICAÇÃO DESCRIÇÃO
Limite Inferior O valor está limitado em algum valor inferior
Limite Superior O valor está limitado em algum valor superior
Constante O valor é uma constante e não pode mover-se
NOTA
Servidores que não suportam o campo Limite devem retornar 0 (zero).
215 Drivers
CAPÍTULO
Quadros
7
O objeto Quadro é utilizado para organizar e estruturar a interface do projeto, criando visualizações compostas para
o usuário dentro da janela principal do Elipse Power Viewer ou do navegador. Muitas vezes, uma aplicação requer
apenas uma Tela principal, que é a porta de entrada para a aplicação. A partir daí, o usuário pode navegar por outras
Telas, que ocupam o lugar da primeira, formando uma única visualização do processo. Porém, é possível suportar
mais de uma visualização em um mesmo documento ou projeto. Isto se torna útil no caso de uma aplicação que utilize
uma Tela que nunca muda, ou que muda pouco (como, por exemplo, um menu), e outra parte que é a navegação das
Telas propriamente ditas. Para utilizar este recurso, execute os procedimentos a seguir.
1. Clique com o botão direito do mouse no nome do projeto no modo Explorer e selecione a opção Inserir -
Quadro. No modo Domínio, clique com o botão direito do mouse no item Visualização - Viewer e Quadros,
selecione a opção Inserir Quadro em e logo após o nome do projeto desejado.
Inserindo um Quadro no modo Domínio

O Quadro possui subdivisões, chamadas de Divisores, que podem ser inseridas ou removidas do Quadro através de
um menu contextual na aba Design do Editor do objeto. A princípio, o Quadro possui um Divisor inicial, que pode ser
subdividido horizontal ou verticalmente em dois Divisores, que por sua vez também podem ser subdivididos em
outros dois Divisores, e assim sucessivamente.
A cada par de novos Divisores criados pelas opções Dividir Horizontalmente e Dividir Verticalmente, há sempre
um Divisor Principal e um Divisor Secundário. Apenas o Divisor Principal tem valores que definem explicitamente o seu
posicionamento, ficando o Divisor Secundário com o valor restante.
Assim, quando o Divisor é subdividido horizontalmente, sua propriedade SplitDockPosition recebe o valor dockTop.
Do mesmo modo, se a subdivisão for vertical, esta propriedade recebe o valor dockLeft. A propriedade do Divisor
Secundário recebe, então, o valor dockRemaining, significando que este Divisor ocupa o espaço restante.
Os ícones dos objetos no Organizer identificam exatamente o posicionamento de cada Divisor.
Opções de posicionamento do Divisor
OPÇÃO DESCRIÇÃO
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
Quadros 216
OPÇÃO DESCRIÇÃO
dockRemaining Este Divisor ocupa o espaço restante após o
posicionamento de seu Divisor Irmão
Cada Divisor corresponde à visualização 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 botão direito do mouse no Quadro aberto e selecione uma das opções: Dividir Horizontalmente
ou Dividir Verticalmente, conforme o tipo de Divisão desejada.
Inserindo um Divisor Horizontal ou

Vertical
2. Para remover um Divisor, clique com o botão direito do mouse no Quadro aberto e selecione a opção Deletar .
3. É possível inverter a seleção original dos Divisores (transformar o Divisor Principal em Divisor Secundário, e vice-
versa) através deste mesmo menu. No caso de um Divisor Principal, clique com o botão direito do mouse no
Quadro e selecione a opção Configurar como Divisor Secundário. No caso de um Divisor Secundário, selecione
a opção Configurar como Divisor Principal. A propriedade SplitDockPosition dos Divisores é automaticamente
configurada para refletir esta mudança.
4. Com a opção Selecionar Tela ou Quadro, é possível escolher a Tela ou Quadro que é associada à propriedade
SplitLink do Divisor selecionado, usando o AppBrowser.
5. Pode-se inserir vários Divisores no Quadro.
217 Quadros
Divisores do Quadro
6. Para configurar os Divisores do Quadro, clique com o botão direito do mouse no Divisor desejado no Organizer e
selecione a opção Propriedades.
Configurações do Quadro
Opções disponíveis na aba Quadro
OPÇÃO DESCRIÇÃO
Tela ou Quadro Determina o caminho da Tela ou Quadro que o Divisor
abre. Só é habilitado se o Divisor não tiver nenhum filho.
Este campo equivale à propriedade SplitLink
Posicionamento Determina a posição do Divisor no Quadro. Este campo

equivale à propriedade SplitDockPosition
Valor Determina o valor que é atribuído ao Quadro. Só tem

efeito visual se for modificada no Divisor Principal. Este
campo equivale à propriedade SplitValue
Quadros 218
NOTAS
· Todas as opções do Quadro que estão disponíveis via menu contextual (através do clique com o botão direito do
mouse) também estão disponíveis utilizando o atalho de teclado SHIFT + F10, que corresponde à tecla de
aplicação ou de menu .
· A Janela de Propriedades de um Quadro pode ser aberta utilizando os atalhos de teclado ALT + ENTER ou ALT +
Duplo-clique do mouse.
Algumas das propriedades do Quadro ou Divisor podem ser configuradas através da Lista de Propriedades, sem a
necessidade da criação de scripts para isto. Caso haja a necessidade de configurar alguma propriedade, localize-a na
Lista de Propriedades e faça os devidos ajustes. Para maiores informações, consulte o Manual de Referência e
219 Quadros
CAPÍTULO
Viewer
8
O objeto Viewer disponibiliza a visualização da aplicação. Permite visualizar Telas do projeto em modo de execução e
a operação do sistema. O Viewer pode ser executado a partir de qualquer ponto da rede que tenha acesso ao E3
Server. Não é necessário copiar o aplicativo para os outros Viewers, pois as Telas e recursos são baixados conforme
a necessidade em tempo de execução. Só pode existir um objeto Viewer em um Domínio.
Viewer no modo Domínio

Para criar um Viewer em um projeto, siga este procedimento:
1. Verifique se já existe um Viewer no Domínio, ou insira um novo clicando com o botão direito do mouse no nome
do projeto no modo Explorer e selecionando a opção Inserir - Viewer. No modo Domínio, clique com o botão
direito do mouse no item Visualização - Viewer e Quadros, selecione a opção Inserir Viewer em e logo após o
nome do projeto desejado.
NOTAS
· A qualidade gráfica das Telas pode ser modificada, em tempo de execução, utilizando-se o menu contextual do
Elipse Power Viewer e selecionando-se uma das opções do menu Qualidade (Todas as Telas). Para mais
informações, consulte a propriedade RenderQuality do Viewer no Manual de Referência e Scripts do Elipse
Power.
· O alinhamento das Telas em relação à área visível pode ser modificado, em tempo de execução, utilizando-se o
menu contextual do Elipse Power Viewer e selecionando-se uma das opções do menu Alinhamento (Todas as
Telas). Para mais informações, consulte a propriedade ScreenAlignment do Viewer no Manual de Referência e
8.1 Configuração
A Janela de Propriedades permite especificar as configurações do Viewer, erros de comunicação, criar Associações ou
scripts.
NOTA
A Janela de Propriedades do Viewer pode ser aberta utilizando os atalhos de teclado ALT + ENTER ou ALT + Duplo-
clique do mouse.
Viewer 220
8.1.1 Aba Visualizador
Através da aba Visualizador, são configuradas diversas opções do Viewer, conforme a figura a seguir.
Aba Visualizador
Opções disponíveis na aba Visualizador
OPÇÃO DESCRIÇÃO
Título Determina o título do Viewer. Esta opção equivale à
propriedade Caption do objeto Viewer
Tela ou Quadro inicial Determina a Tela ou Quadro que o Viewer inicia. Clique
em para que o Elipse Power Studio abra o
AppBrowser, onde se pode especificar a Tela inicial de
visualização. Esta opção equivale à propriedade
InitialScreen do objeto Viewer
Zoom Determina o nível de zoom para visualização no Viewer.

Através das suas opções, é possível configurar como o
Viewer é inicializado. Esta opção equivale à propriedade
InitialScreen do objeto Viewer
Alinhamento da Tela Determina o alinhamento da Tela em relação à área

visível. Esta opção equivale à propriedade
ScreenAlignment do objeto Viewer
Habilitar barra de rolagem na Tela Inicial Habilita a exibição de uma barra de rolagem na Tela
indicada na opção Tela ou Quadro inicial
Exibir o menu do Zoom ao clicar com o botão direito Habilita a exibição do menu Zoom com o botão direito
do mouse do mouse, em tempo de execução. Esta opção equivale à
propriedade AllowContextMenu do objeto Viewer.
NOTA: Em aplicações anteriores à versão 5.1, o
comportamento desta opção é configurado na
propriedade EnableZoomMenu, que foi descontinuada
221 Viewer
OPÇÃO DESCRIÇÃO
Manter Telas carregadas em memória Habilita o Viewer a manter as Telas carregadas em
memória. Esta opção equivale à propriedade
CacheEnable do objeto Viewer
Verificar inatividade (minutos) Define o tempo máximo de espera, em minutos, por um

evento de mouse ou de teclado para o período de
inatividade. Esta opção equivale à propriedade
EnableInactivity do objeto Viewer
Número de retentativas para confirmação de usuário Estabelece o número de vezes que a caixa de diálogo de
e senha login é exibida além da primeira vez. Esta opção equivale
à propriedade LoginRetries do objeto Viewer
KeyPad Especifica opções para o uso do Elipse KeyPad. Consulte

o tópico Elipse KeyPad para mais informações sobre esta
opção
NOTA
Selecionar um valor na opção Alinhamento da Tela força este alinhamento na Tela a ser aberta, independente da
configuração da propriedade ScreenAlignment da Tela, da propriedade ScreenAlignment do Viewer ou da
configuração executada no menu contextual do Viewer em tempo de execução. Neste menu contextual, nenhum dos
itens do menu Alinhamento (Esta Tela) está selecionado. Caso um dos itens deste menu contextual seja selecionado
na Tela aberta, o item selecionado se sobrepõe ao valor usado nesta opção. Neste menu contextual, nenhum dos
itens do submenu Alinhamento (Esta Tela) está selecionado. Caso um dos itens deste menu contextual seja
selecionado na Tela aberta, o item selecionado se sobrepões ao valor usado nesta opção. Já o submenu
Alinhamento (Todas as Telas) tem um de seus itens selecionados, mas este item só tem efeito caso o usuário
selecione explicitamente o item Usar Padrão do menu Alinhamento (Esta Tela).
Viewer 222
8.1.2 Aba Configuração
Através da aba Configuração, pode-se editar as opções relativas à janela, ao título e à resolução do Viewer.
Aba Configuração
Cada opção da aba Configuração possui uma propriedade correspondente. As opções disponíveis nesta aba estão
Opções disponíveis na aba Configuração
OPÇÃO DESCRIÇÃO
Iniciar maximizada, Iniciar minimizada e Iniciar Determina o estilo da janela do Viewer. Esta opção
janelada equivale à propriedade WindowStyle e possui os
seguintes valores:
· 0 - Maximized: A Tela inicia maximizada
· 1 - Windowed: A Tela inicia no modo janelado, isto é,
pode ser configurada a altura e a largura da Tela nas
opções Largura (pixels) e Altura (pixels),
respectivamente
· 2 - Minimized: A Tela inicia minimizada
Desabilita a troca de janelas Desabilita a troca de janelas. Esta opção equivale à

propriedade DisableTaskSwitching do objeto Viewer.
Esta opção pode ser modificada em tempo de execução
usando o método SetDisableTaskSwitching
Barra de título Habilita a barra de título. Esta opção equivale à

propriedade TitleBar do objeto Viewer
Botão de fechar Habilita o botão de fechar. Esta opção equivale à

propriedade CloseButton do objeto Viewer
223 Viewer
OPÇÃO DESCRIÇÃO
Botão de minimizar Habilita o botão de minimizar. Esta opção equivale à
propriedade MinimizeButton do objeto Viewer
Botão de maximizar Habilita o botão de maximizar. Esta opção equivale à

propriedade MaximizeButton do objeto Viewer
Borda Habilita uma borda na janela do Viewer. Esta opção

equivale à propriedade WindowBorder do objeto Viewer
Opção de redimensionar Indica se a janela pode ser redimensionada. Esta opção só

tem validade se a opção Borda estiver marcada. Esta
opção equivale à propriedade WindowResizable do
objeto Viewer
Opção de mover Indica se a janela pode ser movida. Esta opção equivale à
propriedade WindowMovable do objeto Viewer
Ficar sempre no topo Indica se a janela deve sempre se sobrepor às outras

janelas. Esta opção equivale à propriedade
WindowStayOnTop do objeto Viewer
Barra de título menor Habilita uma barra de títulos pequena na janela. Esta
opção só tem efeito se a opção Barra de título estiver
marcada. Esta opção equivale à propriedade
WindowSmallTitle do objeto Viewer
Resolução da Tela Seleciona a resolução da Tela. Os valores possíveis são

640 x 480, 800 x 600, 1024 x 768, 1280 x 1024, 1600 x
1200 ou Automática (baseada na resolução de tela atual)
Avançado Abre a janela para configurações avançadas, descrita a

seguir
Ao clicar em Avançado, a janela da figura a seguir é aberta.
Configurações avançadas
Viewer 224
Opções disponíveis na janela Configurações avançadas
OPÇÃO DESCRIÇÃO
Resolução da tela em pixels Permite selecionar entre a resolução atual do
computador ou uma resolução definida pelo usuário, em
pixels, nas opções Horizontal e Vertical
Desconto na resolução da tela em pixels Permite selecionar o desconto aplicado na resolução da

Tela entre a configuração atual do computador ou uma
resolução definida pelo usuário, em pixels, nas opções
Horizontal e Vertical
Resolução do monitor em pontos por polegada (DPI) Permite selecionar entre a resolução atual do
computador ou um resolução definida pelo usuário, em
pontos por polegada (DPI), nas opções Horizontal e
Vertical
8.1.3 Aba Erros de Comunicação

No Elipse Power Viewer, é possível visualizar os erros de comunicação dos Tags quando estes estiverem associados
a Displays ou Setpoints. Isto é possível configurando as informações contidas na aba Erros de Comunicação,
disponível nas propriedades do Viewer.
Aba Erros de comunicação

Opções disponíveis na aba Erros de Comunicação
OPÇÃO DESCRIÇÃO
Visualizar erros de comunicação Habilita ou desabilita a visualização dos erros de
comunicação
Texto Contém o texto que é mostrado no Setpoint, caso a

qualidade do valor seja ruim
Cor da letra Contém a cor que deve ser usada no texto do Setpoint
Cor do fundo Contém a cor que deve ser usada como fundo no
Setpoint. Equivale a uma alteração da propriedade
ForegroundColor do Setpoint, mas esta alteração não é
executada efetivamente, pois o valor da propriedade do
Setpoint não é alterado
225 Viewer
8.2 Variáveis no Viewer
No objeto Viewer é possível criar Associações com objetos a partir de Telas, bem como usá-los via scripts. Também é
possível inserir Tags Contador, Demo, Interno e Timer no Viewer, além de Pastas do Viewer e Consultas. Através do
AppBrowser, pode-se executar as seguintes ações:
· Acessar o objeto Viewer ou algum de seus filhos a partir de uma Tela ou controle de Tela (Associações ou scripts)
· Os filhos do objeto Viewer podem acessar outros filhos do Viewer ou o próprio Viewer (Associações ou scripts)
· O próprio objeto Viewer pode acessar seus filhos (Associações ou scripts)
É importante salientar que a Associação para o Viewer deve conter o nome real do Viewer, como por exemplo
"Viewer1", e não simplesmente "Application". Em scripts, ainda vale o uso de Application, que é uma propriedade de
todos os objetos que retornam o Viewer.
8.3 Objeto _top

Quando um Viewer é inserido no projeto, disponibiliza um Quadro filho. Este Quadro filho é chamado de _top. Para
utilizar este recurso, siga estes procedimentos:
1. Clique em no item Visualização - Viewer e Quadros - Viewer para mostrar o Quadro _top.
Objeto _top
2. Para configurar as propriedades do objeto _top, clique com o botão direito do mouse no objeto e selecione a
opção Propriedades.
3. Este objeto possui as mesmas funcionalidades do objeto Divisor do Quadro, e estas funcionalidades estão
descritas nos capítulos Telas e Quadros.
8.4 Pasta do Viewer

A Pasta do Viewer define grupos dentro do objeto Viewer de forma a organizar os Tags do Viewer (Contador, Demo,
Interno e Timer) e Consultas. Caso haja necessidade, novas Pastas podem ser inseridas dentro de outras. Para utilizar
este recurso, siga este procedimento:
1. Clique com o botão direito do mouse no item Visualização - Viewer e Quadros - Viewer e selecione a opção
Inserir - Panel - Pasta do Viewer.
Viewer 226
Inserindo Pasta do Viewer
227 Viewer
CAPÍTULO
PowerExplorer
9
O PowerExplorer é uma ferramenta desenvolvida para facilitar a interação entre as funcionalidades dos objetos
nativos e dos objetos gráficos, provendo informações sobre Medidas, Comandos e Proteções centralizadas em uma
única janela.
Esta janela está acessível através dos métodos GetPowerExplorer (criação e configuração) e ShowPowerExplorer
(visualização) do Elipse Power Viewer. A janela resultante pode ser vista nas figuras a seguir.
Aba Analógicas
Aba Discretas
PowerExplorer 228
Aba Comandos
O PowerExplorer lista, em forma de opções, todos os Comandos cadastrados no equipamento, utilizando a descrição
padrão e as Semânticas configuradas no objeto Configuração do Power para gerar estas opções.
É realizada uma validação na configuração de cada Comando, de forma que somente os que estiverem corretamente
configurados são mostrados ao usuário, já levando em consideração a existência de Intertravamentos nas Unidades
de Comando.
Ao clicar em Selecionar, Operar ou Cancelar na aba Comandos, é possível enviar Comandos Select, Operate ou
Cancel, respectivamente, para a Unidade de Comando selecionada.
Ao clicar em Intertravamentos, abre-se uma janela listando todos os Intertravamentos da Unidade de Comando
selecionada, mostrando informações como o estado, a condição e o valor dos Intertravamentos associados à Unidade
de Comando.
Intertravamentos
229 PowerExplorer
Aba Proteções
O PowerExplorer aponta para a estrutura de um equipamento ou para uma Proteção específica, montando uma lista
com todas as Medidas contidas em cada um dos terminais e na pasta Measurements, mostrando estas informações
de valores juntamente com a descrição, unidade e semântica da Medida.
Além disto, informa qual das Fontes cadastradas está sendo utilizada como ativa. Quando a Fonte é do tipo Operator,
há também a opção de permitir a alteração dos valores. Para isto, deve-se selecionar o valor da Medida que se
deseja alterar e pressionar a tecla F2, ou então clicar duas vezes no valor da Medida para informar o novo valor.
Edição de fonte do tipo Operator

Para que o valor seja aceito é preciso pressionar a tecla ENTER. Qualquer outra forma de encerrar a edição (tecla ESC,
perda de foco da caixa de edição ou da janela, etc.) faz com que o valor seja ignorado.
Ao clicar em Legenda, na parte de baixo da janela, é mostrada uma caixa de diálogo com as legendas das cores dos
estados das Medidas, conforme a figura a seguir.
Legenda dos estados das Medidas
PowerExplorer 230
CAPÍTULO
Telas e Objetos de Tela
10
Telas são janelas para monitoramento de processos. Em cada Tela são inseridos objetos que compõem a interface
do operador com o sistema, chamados Objetos de Tela. Cada aplicação pode ter um número ilimitado de Telas e de
objetos de Tela.
10.1 Tela
A Tela é o objeto básico de interface com o usuário, e pode conter vários tipos de objetos. Os gráficos inseridos na
Tela podem ser apagados, copiados, movidos, redimensionados, agrupados ou configurados.
Para inserir uma Tela em um projeto, clique com o botão direito do mouse no nome do projeto no modo Explorer e
selecione a opção Inserir - Tela. No modo Domínio, clique com o botão direito do mouse no item Visualização -
Telas, selecione a opção Inserir Tela em e logo após o nome do projeto desejado.
Inserindo uma Tela no modo Domínio

Quando uma nova Tela é criada, ou quando é selecionada a opção Ajustar ao Divisor em uma Tela já existente, a
janela da figura a seguir é mostrada para configuração do tamanho da Tela.
Configurando o tamanho da Tela
231 Telas e Objetos de Tela

Opções disponíveis na janela Configurando o tamanho da Tela
OPÇÃO DESCRIÇÃO
Escolha o Divisor onde a Tela será aberta Permite selecionar o Divisor onde a Tela é aberta. São
listados apenas os Divisores cuja Tela associada à
propriedade SplitLink é visível em tempo de execução
Configurar como Tela inicial do Divisor Habilita a Tela como Tela Inicial do Divisor onde é aberta
Nome Determina o nome da Tela
Largura (pixels) Determina a largura da Tela, em pixels
Altura (pixels) Determina a altura da Tela, em pixels
As opções Largura e Altura estão inicialmente preenchidas com o tamanho que a Tela deve ter para poder ser
exibida no Divisor selecionado, sem que apareça uma barra de rolagem. Se algum dos valores é negativo, isto indica
que o Divisor não está visível em tempo de execução, em função da configuração do Elipse Power Viewer e do
tamanho dos outros Divisores.
O Elipse Power Studio fornece um Editor dos objetos que podem ser inseridos em uma Tela. Estão disponíveis os
objetos Arco de Elipse, Desenho Livre, Display, Elipse, Escala, Figura (Imagem), Linha, Microsoft Forms, Polígono,
Polígono de Curvas, Retângulo, Retângulo Arredondado, SetPoint e Texto. Os objetos Microsoft Forms são discutidos
no capítulo ActiveX e os demais objetos citados são apresentados neste capítulo.
Tela
Pode-se configurar as propriedades da Tela para determinar tamanho, cor e outros aspectos do comportamento e da
aparência, além de vários tipos de eventos. Estes objetos utilizam como padrão para o tamanho e coordenadas as
unidades Himetric, dadas em 1/100 mm, e não em pixels.
Todas as propriedades da Tela podem ser configuradas através da Lista de Propriedades, sem a necessidade de se
criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de Propriedades e realize os
devidos ajustes.
Telas e Objetos de Tela 232

NOTAS
· A qualidade gráfica de uma Tela pode ser modificada, em tempo de execução, utilizando-se o menu contextual do
Elipse Power Viewer e selecionando-se uma das opções do menu Qualidade (Esta Tela). Para mais informações,
consulte a propriedade RenderQuality da Tela no Manual de Referência e Scripts do Elipse Power.
· O alinhamento de uma Tela em relação à área visível pode ser modificado, em tempo de execução, utilizando-se o
menu contextual do Elipse Power Studio e selecionando-se uma das opções do menu Alinhamento (Esta Tela).
Para mais informações, consulte a propriedade ScreenAlignment da Tela no Manual de Referência e Scripts do
Elipse Power.
10.2 Barra de Ferramentas

A Barra de Ferramentas de uma Tela contém opções que permitem a execução de determinadas tarefas rapidamente
sem utilizar os menus, como por exemplo adicionar um Botão de Comando. A tabela a seguir mostra as opções
disponíveis na barra de ferramentas da Tela.
Opções disponíveis na barra de ferramentas da Tela
OPÇÃO DESCRIÇÃO
Selecionar Habilita o modo de seleção
Mover Habilita o recurso de mover (pan) uma Tela. NOTA: Em

tempo de execução, esta opção está disponível somente
se a propriedade ScreenAlignment da Tela estiver
definida com o valor paCenter
Zoom de Área Permite aplicar um zoom a uma área específica da Tela.

Para isto, clique com o botão esquerdo do mouse no
ponto inicial e arraste o mouse até o ponto final. NOTA:
Em tempo de execução, esta opção está disponível pelo
atalho de teclado CTRL + SHIFT + Botão esquerdo do
mouse, mas somente se a propriedade
ScreenAlignment da Tela estiver definida com o valor
paCenter
Enquadrar Alterna entre redimensionar a Tela para caber na área

visível e restaurar o nível de zoom e a posição anteriores
da barra de rolagem (CTRL + 5 ou CTRL + CLEAR)
Rotacionar Habilita o modo de rotação
Ordem da Tabulação Mostra o identificador de ordem de navegação entre

objetos
Editar Pontos de Conexão Permite editar pontos de conexão entre objetos. Esta
opção somente está habilitada em objetos XControl
Enviar para a Frente Traz um objeto para a frente em um agrupamento (ALT

+ HOME)
Enviar para Trás Envia um objeto para trás em um agrupamento (ALT +

END)
Avançar Move um objeto uma posição acima no agrupamento

(ALT + PAGE UP)
Recuar Move um objeto uma posição abaixo no agrupamento

(ALT + PAGE DOWN)
Zoom Permite editar o nível de zoom de uma Tela
Camadas Permite editar as camadas de objetos em uma Tela
E3Alarm Insere um objeto do tipo E3Alarm
E3Browser Insere um objeto do tipo E3Browser
E3Chart Insere um objeto do tipo E3Chart
Playback Insere um objeto do tipo E3Playback

OPÇÃO DESCRIÇÃO
Linha Insere um objeto do tipo Linha
Conector Insere um objeto do tipo Conector
Retângulo Insere um objeto do tipo Retângulo
Retângulo Arredondado Insere um objeto do tipo Retângulo Arredondado
Elipse Insere um objeto do tipo Elipse
Arco de Elipse Insere um objeto do tipo Arco de Elipse
Desenho Livre Insere uma ferramenta de desenho livre
Polígono Insere um objeto do tipo Polígono
Polígono de Curvas Insere um objeto do tipo Polígono de Curvas
Texto Insere um objeto do tipo Texto
Display Insere um objeto do tipo Display
SetPoint Insere um objeto do tipo SetPoint
Figura Insere um objeto do tipo Figura
Escala Insere um objeto do tipo Escala
Agrupar Agrupa uma seleção de objetos
Desagrupar Desagrupa uma seleção de objetos
Animar com Translação Insere uma ferramenta para movimentos lineares
Animar com Rotação Insere uma ferramenta para rotação
Caixa de Seleção Insere um objeto do tipo Caixa de Seleção (Check Box)
Botão de Opções Insere um objeto do tipo Botão de Opção (Option

Button)
Lista de Seleção Insere um objeto do tipo Lista de Seleção (Combo Box)
Botão de Comando Insere um objeto do tipo Botão de Comando (Command

Button)
Texto Insere um objeto do tipo Texto (Label)
Lista Insere um objeto do tipo Lista (List Box)
Barra de Rolagem Insere um objeto do tipo Barra de Rolagem (Scroll Bar)
Botão de Incremento e Decremento Insere um objeto do tipo Botão de Incremento e

Decremento (Spin Button)
Editor de Texto Insere um objeto do tipo Editor de Texto (Text Box)
Botão Liga e Desliga Insere um objeto do tipo Botão Liga e Desliga (Toggle
Button)
Alinhar à Esquerda Alinha dois ou mais objetos entre si, tendo como
referência a coordenada à esquerda do último objeto
selecionado
Alinhar à Direita Alinha dois ou mais objetos entre si, tendo como
referência a coordenada à direita do último objeto
selecionado
Alinhamento Superior Alinha dois ou mais objetos entre si, tendo como
referência a coordenada superior do último objeto
selecionado

OPÇÃO DESCRIÇÃO
Alinhamento Inferior Alinha dois ou mais objetos entre si, tendo como
referência a coordenada inferior do último objeto
selecionado
Alinhamento Central Horizontal Alinha dois ou mais objetos horizontalmente pelo centro
entre si, tendo como referência o último objeto
selecionado
Alinhamento Central Vertical Alinha dois ou mais objetos verticalmente pelo centro
entre si, tendo como referência o último objeto
selecionado
Mesma Largura Aplica a largura do último objeto selecionado aos

demais objetos selecionados
Mesma Altura Aplica a altura do último objeto selecionado aos demais

objetos selecionados
Mesmo Tamanho Aplica a largura e a altura do último objeto selecionado

aos demais objetos selecionados
Centralizar Horizontalmente Centraliza um objeto na Tela, de acordo com suas

coordenadas horizontais
Centralizar Verticalmente Centraliza um objeto na Tela, de acordo com suas

coordenadas verticais
Distribuir Horizontalmente Aplica a mesma distância horizontal entre si a três ou

mais objetos
Distribuir Verticalmente Aplica a mesma distância vertical entre si a três ou mais

objetos
Espelhar Horizontalmente Aplica um efeito de reflexão horizontal aos objetos

selecionados
Espelhar Verticalmente Aplica um efeito de reflexão vertical aos objetos

selecionados
Grade Mostra ou esconde a grade
Edição da Grade Permite editar as propriedades da grade
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 selecionar o tipo de borda exibida por um

objeto de Tela a partir de uma lista com estilos pré-
estabelecidos. Os valores possíveis para esta opção são
Normal, Tracejado, Pontilhado, Traço-Ponto, Traço-
Ponto-Ponto ou Sem Borda
Espessura da Linha Permite selecionar a espessura da linha da borda de um

objeto de Tela a partir de uma lista com espessuras pré-
estabelecidas entre 0 (zero) e 2,5 milímetros
Estilo do Preenchimento Permite selecionar o tipo de preenchimento exibido por

uma Tela ou por um objeto de Tela, isto é, como é
realizada a combinação entre as cores de fundo e de
frente de um objeto

OPÇÃO DESCRIÇÃO
Sombra do Objeto Aplica uma sombra em um objeto
Sombra Acima Desloca a sombra para cima de um objeto
Sombra Abaixo Desloca a sombra para baixo de um objeto
Sombra à Esquerda Desloca a sombra para a esquerda de um objeto
Sombra à Direita Desloca a sombra para a direita de um objeto
Cor da Sombra Seleciona a cor da sombra de um objeto
Fonte Determina a fonte de um texto
Tamanho da Fonte Determina o tamanho da fonte de um texto
Cor da Fonte Determina a cor da fonte de um texto
Negrito Formata um texto em negrito
Itálico Formata um texto em itálico
Sublinhado Formata um texto com sublinhado
Texto à Esquerda Alinha um texto à margem esquerda
Texto Centralizado Centraliza um texto
Texto à Direita Alinha um texto à margem direita
Executar Viewer com a Tela Atual Executa o Elipse Power Viewer e mostra a Tela atual.
Esta opção somente está disponível se o Domínio está
em execução, ou seja, após utilizar a opção Rodar ou
Parar o Domínio da barra de ferramentas Padrão
10.3 Objetos de Tela

Os seguintes objetos podem ser inseridos em uma Tela:
· Primitivas do Editor Gráfico (Retas, Círculos, Retângulos, Polígonos, etc.)
· Controles ActiveX fornecidos pela Elipse Software (E3Alarm, E3Browser, E3Chart e E3Playback)
· Controles ActiveX fornecidos por terceiros
· Imagens não vetoriais (Arquivos BMP, JPG, GIF, etc.)
· Imagens vetoriais (Arquivos WMF, EMF, etc.)
· Controles Padrão do Windows (Lista, Editor de Texto, Lista de Seleção, etc.)
· Objetos ElipseX, compostos de qualquer dos objetos anteriores
· Pastas do Viewer, Consultas, Tags Contador, Demo, Interno e Timer
As primitivas do editor gráfico disponíveis no Elipse Power Studio são listadas nos próximos tópicos. Estas podem
ser rotacionadas ou redimensionadas livremente, exceto pelo objeto Figura. Após ter sido criado, cada objeto
permanece selecionado para facilitar a edição de suas propriedades, caso seja necessário.
10.3.1 Arco de Elipse

Permite o desenho de objetos do tipo arco, corda ou torta. Para utilizar este objeto, siga estes procedimentos:
1. Selecione a opção Arco de Elipse na barra de ferramentas da Tela.
2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o mouse diagonalmente até o desenho
atingir o tamanho e a posição desejados.
3. Nas duas extremidades do corte aparecem dois pontos, responsáveis pela posição de abertura do desenho.
Arraste-os para abrir ou fechar o desenho.
4. O formato do desenho inicial é o de torta. Para alterá-lo para arco ou corda, utilize a propriedade ArcStyle na
Lista de Propriedades.

10.3.2 Biblioteca Gráfica
Junto ao Elipse Power é fornecida uma biblioteca de objetos gráficos. Esta biblioteca contém os equipamentos que
são utilizados na montagem das Telas, e é capaz de interagir com os objetos de dados. Estes objetos conhecem a
estrutura de cada um dos objetos de dados, explorando deste modo diversas funcionalidades dos equipamentos.
10.3.2.1 Parâmetros Gerais

Cada um dos objetos de Tela possui diversas características e funcionalidades que devem ser configuradas. As
propriedades padrão estão descritas na tabela a seguir.
Propriedades padrão dos objetos de Tela
PROPRIEDADE DESCRIÇÃO
SourceObject Conexão com o objeto correspondente configurado no
servidor de dados
Orientation Altera a rotação do equipamento. As opções disponíveis

são 0: Terminal 1 apontando para a direita, 1: Terminal 1
apontando para cima, 2: Terminal 1 apontando para a
esquerda ou 3: Terminal 1 apontando para baixo. NOTA:
Alguns equipamentos podem não possuir algumas
destas opções de valores
ShortNameColor Informação de cor utilizada no nome do equipamento
ShowTerminalConnector Mostra o Conector nos terminais do equipamento
ShowShortName Mostra o valor da propriedade ShortName do

equipamento no controle de Tela
10.3.2.2 Equipamentos
Para inserir qualquer um dos equipamentos, clique com o botão direito do mouse em qualquer ponto da Tela,
selecione a opção Inserir - powercontrols e selecione o equipamento desejado.
10.3.2.2.1 Arranjo Fotovoltaico

Conecta-se a um equipamento do tipo Arranjo Fotovoltaico.
10.3.2.2.2 Barramento
Conecta-se a um equipamento do tipo Barramento e é capaz de informar se o Terminal 1 está energizado.
10.3.2.2.3 Caixa de Junção

Conecta-se a um equipamento do tipo Caixa de Junção.
10.3.2.2.4 Capacitor
Conecta-se a um equipamento do tipo Capacitor e é capaz de informar se o Terminal 1 está energizado.
10.3.2.2.5 Carga da Distribuição

Conecta-se a um equipamento do tipo Carga da Distribuição e é capaz de informar se o Terminal 1 está energizado.
Além disto, informa o carregamento da carga, levando em consideração a potência nominal e a potência aparente em
tempo real.
10.3.2.2.6 Carga da Subestação

Conecta-se a um equipamento do tipo Carga e é capaz de informar se o Terminal 1 está energizado.
10.3.2.2.7 Chave
Conecta-se a um equipamento do tipo Chave e é capaz de informar a sua posição, aberto ou fechado, através de
cores e com posição gráfica diferente. Além disto, indica o estado de energizado ou desenergizado dos Terminais.

10.3.2.2.8 Disjuntor
Conecta-se a um equipamento do tipo Disjuntor e é capaz de informar a sua posição, aberto ou fechado, através de
cores. Além disto, indica o estado de energizado ou desenergizado dos terminais.
10.3.2.2.9 Estação Meteorológica

Conecta-se a um equipamento do tipo Estação Meteorológica.
10.3.2.2.10 Gerador
Conecta-se a um equipamento do tipo Gerador e é capaz de informar se o Terminal 1 está energizado.
10.3.2.2.11 Inversor
Conecta-se a um equipamento do tipo Inversor.
10.3.2.2.12 Linha
Existem duas opções de conexão entre os equipamentos gráficos do Elipse Power:
· EquivLine: Conecta-se ao Terminal de qualquer equipamento e deste extrai o seu estado, energizado ou não, e a
potência ativa. A partir destas informações, é capaz de animar a linha e mostrar a direção do fluxo de potência.
Este controle possui um ponto amarelo que deve estar apontando para o Terminal ao qual está conectado
· Conector: Conecta-se diretamente à propriedade que fornece o estado do Terminal do equipamento, animando a
cor da linha. Além disto, tem a função de se conectar ao objeto gráfico e é movido sempre junto com o
equipamento
10.3.2.2.13 Reator
Conecta-se a um equipamento do tipo Reator e é capaz de informar se o Terminal 1 está energizado.
10.3.2.2.14 Transformador da Distribuição

Conecta-se a um objeto do tipo Transformador da Distribuição e é capaz de informar se os Terminais 1 e 2 estão
energizados. Também informa se o Transformador da Distribuição possui tap e qual a sua posição.
10.3.2.2.15 Transformador de Dois e Três Enrolamentos

Conecta-se a um equipamento do tipo Transformador de Dois Enrolamentos ou Transformador de Três
Enrolamentos e é capaz de informar se os Terminais 1, 2 ou 3 estão energizados. Também informa se o
Transformador possui tap e qual a sua posição.
10.3.2.2.16 Turbina Eólica

Conecta-se a um equipamento do tipo Turbina Eólica e é capaz de informar se o Terminal 1 está energizado.
10.3.2.3 PowerDisplay
O objeto PowerDisplay conecta-se a um medidor analógico e extrai todas as informações presentes na Medida, tais
como valor, unidade e fonte ativa, entre outras. Este objeto pode conectar-se a uma Fonte de Medida específica ou à
Medida que é utilizada como ativa no momento.
10.3.2.3.1 Configurações
O objeto PowerDisplay possui as configurações mostradas na tabela a seguir.
Propriedades do objeto PowerDisplay
Measurement Conexão com a Medida a ser monitorada
MeasurementSource Fonte de Medida a ser utilizada pelo objeto:

· 0: Fonte Ativa
· 1: SCADA
· 2: Operador
· 3: Centro de Controle

· 4: Faturamento
· 5: Calculada
· 6: Banco de Dados
· 100: Processador Topológico
· 101: Fluxo de Potência
· 102: Estimador de Estados
· 103: Descarte de Cargas
· 104: Modelagem de Cargas para Distribuição
· 105: Autorrecuperação
· 106: Leitor Externo
Format Configura o formatador usado, permitindo números com

parte inteira e fracionária
BorderStyle Determina o estilo de borda que é aplicada ao objeto:

· 0: Normal
· 1: Traço
· 2: Ponto
· 3: Traço e ponto
· 4: Traço, ponto, ponto
· 5: Nulo
BorderColor Determina a cor da borda que é aplicada ao objeto
10.3.2.3.2 Informações Visuais

O PowerDisplay mostra o valor da Medida, respeitando a formatação e a Fonte de Medida selecionadas, bem como a
unidade e prefixo configurados.
PowerDisplay
É informado graficamente à qual Fonte de Medida o PowerDisplay está conectado no momento (mostrado através de
uma dica sobre o objeto):
· SCADA
· Operador
· Centro de Controle
· Faturamento
· Calculada
· Banco de Dados
· Processador Topológico
· Fluxo de Potência
· Estimador de Estados
· Descarte de Cargas
· Modelagem de Cargas para Distribuição
· Autorrecuperação
· Leitor Externo
NOTA
Quando o ícone aparece no lado esquerdo do objeto, isto significa que este objeto não está conectado à Medida
configurada como Fonte de Medida Ativa (propriedade ActiveSource de Medidas Analógicas e Discretas) do
equipamento.

10.3.2.3.3 Operações
Este objeto permite trocar, em tempo de execução, a Fonte à qual o PowerDisplay está conectado no momento,
permitindo visualizar o valor das outras Fontes configuradas na Medida. Para isto, clique no controle para exibir o
menu contextual e selecione a opção Fontes de Medida para mostrar a lista com todas as Fontes disponíveis. A
primeira Fonte da lista é a Fonte ativa e é informado entre parênteses qual Fonte está ativa naquele momento. Note
que o controle apenas mostra as Fontes presentes no equipamento. Esta funcionalidade apenas mostra o valor de
outras Fontes de Medida, não alterando qualquer configuração nos objetos de dados.
Fontes de Medida
Selecione uma Fonte de Medida para que esta Fonte seja mostrada no objeto PowerDisplay.
Quando a Fonte de Medida configurada é do tipo Operator, a opção Entrada Manual de Valores é habilitada. Ao
selecionar esta opção, uma nova tela é aberta e é possível alterar o valor desta Fonte.
10.3.3 Conector
Este objeto é utilizado para conectar dois ou mais objetos de Tela através de uma linha. Os objetos de Tela que
podem ser conectados são o Arco de Elipse, o Desenho Livre, a Elipse, o Polígono, o Polígono de Curvas, o Retângulo
e o Retângulo Arredondado. Ao clicar na opção Conector na barra de ferramentas da Tela, os objetos
anteriormente citados mostram seus Pontos de Conexão, como na figura a seguir.
Pontos de Conexão de objetos de Tela

Para conectar dois objetos, clique em um dos Pontos de Conexão do primeiro objeto e, em seguida, clique em um
dos Pontos de Conexão do segundo objeto. Sempre que se passa o mouse sobre um Ponto de Conexão, o ícone
muda de para , indicando qual Ponto deve ser conectado.
Após a criação do Conector, também é possível desconectar os vértices. Para isto, arraste o vértice para longe do
Ponto de Conexão do objeto. Para reconectar, arraste-o para perto de um Ponto de Conexão até que o ícone mude
para .
Para criar uma conexão entre mais de dois Pontos de Conexão, mantenha pressionada a tecla CTRL enquanto
seleciona todos os Pontos desejados.
Para excluir um Conector, selecione-o e utilize a tecla DELETE. Se um objeto que possua um Conector é excluído, o
Conector não é excluído.

Para informações sobre Conectores em objetos XControl, consulte o tópico a seguir.
10.3.3.1 Conectores em XControls

Os Conectores em objetos de Tela criados dentro de XControls devem ter os Pontos de Conexão definidos
previamente, clicando-se em Editar Pontos de Conexão na barra de ferramentas da Tela. Ao selecionar esta
ferramenta e clicar em um Ponto de Conexão, a janela da figura a seguir é mostrada.
Janela de edição de Pontos de Conexão

Opções disponíveis na janela Novo Ponto de Conexão
OPÇÃO DESCRIÇÃO
Nome do Ponto de Conexão Permite definir um nome para o Ponto de Conexão
Conectado a Mostra em qual Ponto de Conexão do objeto de Tela o

Ponto de Conexão do XControl está conectado
Utilizar como "Ponto Âncora" do objeto Marca este Ponto de Conexão como o ponto âncora do
objeto. Este ponto âncora pode ser alterado quando o
XControl é inserido em uma Tela. Consulte também o
tópico Ponto Âncora para mais informações
Para excluir ou editar um Ponto criado, clique com o botão direito do mouse no Ponto e selecione a opção Excluir
Ponto de Conexão ou Editar Ponto de Conexão, conforme a figura a seguir. Um Ponto de Conexão também pode
ser excluído clicando-se no Ponto com a tecla CTRL pressionada.
Excluir ou editar um Ponto de Conexão

Caso não seja definido nenhum Ponto de Conexão para os objetos de Tela incluídos em um XControl, não é possível
conectar este XControl a nenhum outro objeto de Tela, quando é incluído em uma Tela.
10.3.4 Desenho Livre

Permite a criação de desenhos à mão livre. Para utilizar este objeto, siga estes procedimentos:
1. Selecione a opção Desenho Livre na barra de ferramentas da Tela.
2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o mouse em qualquer direção tantas vezes
quantas forem necessárias para completar o desenho desejado.
10.3.5 Display
Permite criar um objeto que é utilizado para mostrar os valores dos Tags em tempo de execução. Para utilizar este
objeto, siga estes procedimentos:

1. Selecione a opção Display na barra de ferramentas da Tela.
2. Clique na Tela para criar o vértice de origem do objeto e arraste o mouse diagonalmente até seu vértice final.
3. Clique com o botão direito do mouse no objeto para abrir a Janela de Propriedades. Na aba Item, selecione o
Tag a ser associado à propriedade Value do Display.
10.3.6 Elipse
Permite o desenho de círculos e elipses. Para utilizar este objeto, siga estes procedimentos:
1. Selecione a opção Elipse na barra de ferramentas da Tela.
2. Clique na Tela para estabelecer o ponto inicial do desenho e arraste o mouse diagonalmente até o desenho
atingir o tamanho e a posição desejados.
10.3.7 Escala
Permite a criação de um objeto que desenha réguas ou escalas de valores. Para utilizar este objeto, siga estes
procedimentos:
1. Selecione a opção Escala na barra de ferramentas da Tela.
10.3.8 Figura
Permite mostrar imagens que estejam armazenadas em arquivos, que podem ou não pertencer à aplicação. A Figura
pode ser redimensionada livremente, porém a rotação e a animação só são efetivas quando esta for um metafile
convertido para símbolo. Os seguintes formatos de arquivo são suportados: Bitmap (.bmp), Graphics Interchange
Format (.gif), Joint Photographic Experts Group (.jpg), ICO File Format (.ico), Windows Metafile (.wmf), Enhanced Metafile
(.emf), Portable Network Graphics (.png) e Tagged Image File Format (.tif). Para utilizar este objeto, siga estes
procedimentos:
1. Selecione a opção Figura na barra de ferramentas da Tela.
2. Clique na Tela para criar o vértice de origem do retângulo e arraste o mouse diagonalmente até seu vértice final.
3. O Elipse Power Studio abre uma caixa de diálogo para seleção do arquivo de imagem, conforme a figura a
seguir.
Seleção do arquivo de imagem

4. Selecione o arquivo desejado e clique em Abrir para inserir a figura na Tela.

10.3.9 Linha
Permite o desenho de retas, ligando dois pontos especificados na sua criação. Para utilizar este objeto, siga estes
procedimentos:
1. Selecione a opção Linha na barra de ferramentas da Tela.
2. Clique na Tela para criar o ponto de origem da reta e arraste o mouse até seu ponto final.
10.3.10 Polígono
Permite o desenho de polígonos com lados retos. Para utilizar este objeto, siga estes procedimentos:
1. Selecione a opção Polígono na barra de ferramentas da Tela.
2. Clique na Tela para estabelecer o vértice inicial do desenho e arraste o mouse em qualquer direção tantas vezes
3. Quando desejar trocar a direção do desenho, clique uma vez com o mouse. Quando desejar finalizá-lo, clique
duas vezes com o mouse.
10.3.11 Polígono de Curvas

Permite o desenho de polígonos com lados curvos. Para utilizar este objeto, siga estes procedimentos:
1. Selecione a opção Polígono de Curvas na barra de ferramentas da Tela.
2. Clique na Tela para estabelecer o vértice inicial do desenho e arraste o mouse em qualquer direção tantas vezes
3. Quando desejar trocar a direção do desenho, clique uma vez com o mouse. Quando desejar finalizá-lo, clique
duas vezes com o mouse.
10.3.12 Retângulo
Permite o desenho de retângulos, criados a partir de dois vértices. Para utilizar este objeto, siga estes procedimentos:
1. Selecione a opção Retângulo na barra de ferramentas da Tela.
2. Clique na Tela para criar o vértice de origem do Retângulo e arraste o mouse diagonalmente até seu vértice final,
até o desenho atingir o tamanho e a posição desejados.
10.3.13 Retângulo Arredondado

Permite o desenho de retângulos com cantos arredondados, criados a partir de dois vértices. Para utilizar este objeto,
siga estes procedimentos:
1. Selecione a opção Retângulo Arredondado na barra de ferramentas da Tela.
2. Clique na Tela para criar o vértice de origem do retângulo e arraste o mouse diagonalmente até seu vértice final,
até o desenho atingir o tamanho e a posição desejados.
3. No canto superior esquerdo do objeto, aparece o ponto responsável pelo fator de arredondamento do
retângulo. Arraste-o mais para o centro ou mais para as bordas para determinar a curva de seus vértices.
10.3.14 SetPoint
Permite criar um objeto que funciona como uma caixa de edição onde são inseridos conteúdos a serem atribuídos a
Tags associados. Para utilizar este objeto, siga estes procedimentos:
1. Selecione a opção SetPoint na barra de ferramentas da Tela.
3. Clique com o botão direito do mouse no objeto para abrir a Janela de Propriedades. Na aba Item, selecione o
Tag a ser associado à propriedade Value do SetPoint.
10.3.15 Texto
Permite a criação de um texto a ser exibido na Tela. Para utilizar este objeto, siga estes procedimentos:
1. Selecione a opção Texto na barra de ferramentas da Tela.
2. Digite o texto desejado e pressione a tecla ENTER.
3. Caso queira alterar ou digitar conteúdos neste objeto, utilize a propriedade Value.

10.4 Configurações Gerais
As configurações dos tópicos a seguir podem ser aplicadas à Tela ou aos seus objetos.
NOTA
· Todas as opções da Tela e dos objetos de Tela que estão disponíveis via menu contextual (através do clique com
o botão direito do mouse) também estão disponíveis utilizando o atalho de teclado SHIFT + F10, que corresponde
à tecla de aplicação ou de menu .
· A Janela de Propriedades da Tela e dos objetos de Tela pode ser aberta utilizando os atalhos de teclado ALT +
ENTER ou ALT + Duplo-clique do mouse.
10.4.1 Agrupar ou Desagrupar

Permite transformar mais de um objeto em apenas um, com propriedades específicas. Para utilizar este recurso, siga
estes procedimentos:
1. Selecione na Tela os objetos que devem formar o grupo.
2. Clique em Agrupar para criar um novo objeto. Esta operação pode ser realizada em cascata, e um grupo
pode conter qualquer objeto, inclusive outros grupos.
3. Para desfazer a união de um grupo de objetos, clique em Desagrupar .
4. Para editar um objeto contido em um grupo, clique com o botão direito do mouse no objeto e selecione a opção
Editar Grupo.
NOTA
· É possível ajustar os objetos dentro de um grupo ao pixel mais próximo, que é conhecido como efeito Snap to
Pixel, utilizando-se o atalho de teclado CTRL + Barra de espaço. Neste caso, o efeito é aplicado a cada um dos
objetos dentro do grupo, podendo ser desfeito utilizando-se o atalho de teclado CTRL + Z.
· Para sair do modo de edição de um grupo de objetos de Tela, clique duas vezes na área da Tela fora do grupo.
10.4.2 Alinhamento
Permite alinhar os objetos de Tela entre si ou em relação à Tela. As opções de alinhamento disponíveis estão descritas
na tabela Opções disponíveis na barra de ferramentas da Tela.
NOTAS
· As opções Espelhar Horizontalmente e Espelhar Verticalmente têm o seguinte comportamento:
· Para seleções múltiplas, cada um dos objetos é espelhado individualmente
· O estado dos botões se altera (pressionado ou não) conforme os objetos tenham sido refletidos verticalmente
ou horizontalmente, mas somente se o estado de reflexão é igual para todos os objetos selecionados
· Os botões permanecem desabilitados se a Tela estiver selecionada ou se não há nenhum objeto selecionado
· Os objetos de Tela podem ser ajustados ao pixel mais próximo, que é conhecido como efeito Snap to Pixel,
utilizando-se o atalho de teclado CTRL + Barra de espaço.
10.4.3 Animação
Recurso que aplica movimento a um objeto em tempo de execução, e que está disponível na barra de ferramentas da
Tela. Os tipos de movimentos disponíveis estão descritos a seguir.
Animação com Translação

O objeto que recebe este recurso realiza movimentos lineares de acordo com as configurações das propriedades no
objeto. Para habilitar esta opção, siga estes procedimentos:
1. Selecione um objeto na Tela e clique em Animar com Translação .
2. Com o cursor do mouse, habilite as configurações da orientação deste objeto.

Animação com Translação
Animação com Rotação
O objeto que recebe este recurso realiza movimentos circulares de acordo com o centro de rotação do objeto e seu
ângulo. Para habilitar esta opção, siga estes procedimentos:
1. Selecione um objeto na Tela e clique em Animar com Rotação .
2. Quando um objeto é criado, seu centro de rotação padrão é definido como o centro do objeto, com uma
inclinação de 0 (zero) graus de posição da horizontal em relação a este centro. Neste momento, os vértices do
objeto selecionado são indicados por pequenos círculos e seu centro por dois círculos circunscritos.
3. Ao passar o mouse sobre o centro ou vértices, é possível modificar o centro arrastando ou rotacionando o objeto
de um de seus vértices em relação ao centro.
Animação com Rotação
NOTA
Para objetos de Tela do tipo Figura que utilizem o formato de arquivo Bitmap, ou seja, arquivos com extensão .bmp,
o recurso de animação não está disponível.
10.4.4 Aplicar Estilo

Aplica o estilo configurado como padrão na opção Configurar como Padrão a objetos previamente criados. Para
1. Selecione o objeto ao qual o padrão deve ser aplicado.
2. Clique com o botão direito do mouse e selecione a opção Aplicar Estilo.
10.4.5 Camadas
O Elipse Power oferece uma arquitetura de Telas com até 32 camadas para inserção de objetos. Cada objeto pode
pertencer a uma ou mais camadas, e a Tela ativa tanto em tempo de configuração (no Elipse Power Studio) quanto
em tempo de execução (no Elipse Power Viewer) pode estar com nenhuma, uma, várias ou todas as camadas ativas.
Isto permite criar aplicações com várias formas de monitoramento, como por exemplo a visualização de um processo
apenas com o sistema elétrico, apenas o hidráulico ou ambos. É possível também controlar o aparecimento de
camadas de acordo com um determinado nível de zoom. A configuração das camadas é realizada clicando-se em
Camadas na barra de ferramentas da Tela. As opções disponíveis estão descritas na tabela a seguir.
Opções disponíveis para a configuração de Camadas
OPÇÃO DESCRIÇÃO
Camada Habilita a visualização da camada configurada na
propriedade Layer da Tela

OPÇÃO DESCRIÇÃO
Todas as camadas Mostra todas as camadas disponíveis no projeto
Nenhuma camada Nenhuma camada é mostrada
Editar camadas Através desta opção pode-se configurar camadas

individuais. Esta opção abre uma caixa de diálogo para
configuração das camadas
Quando a opção Editar camadas é selecionada, a janela da figura a seguir é mostrada.
Janela Edição de Camadas

Opções disponíveis na janela Edição de Camadas
OPÇÃO DESCRIÇÃO
Adicionar Camada Adiciona uma nova camada
Remover Camada Remove a camada selecionada
Camada Indica o bit configurado, de 1 (um) a 32, para a camada

selecionada
Nome Determina o nome da camada
Visível? Indica se esta camada é visível na Tela
Zoom Baixo (%) Define a porcentagem inicial de zoom na camada
Zoom Alto (%) Define a porcentagem final de zoom na camada
Fonte Estabelece uma Associação ou uma propriedade que,

uma vez ativa (diferente de zero), também exibe a
camada. As opções de Zoom e Fonte não são
exclusivas, isto é, podem ativar a camada estando uma
ou outra condição ativa
Máscara Representa uma máscara, em hexadecimal, do bit

configurado em Camada
Ao clicar no menu da propriedade Layer na Lista de Propriedades de uma Tela, é possível configurar as camadas
mostradas naquela Tela. Este menu mostra as camadas configuradas na janela Edição de Camadas e também as
opções Todas as Camadas, equivalente ao valor &hFFFFFFFF em hexadecimal, ou Nenhuma Camada, equivalente ao
valor &h0 em hexadecimal, conforme a figura a seguir.

Opções para a propriedade Layer de uma Tela
Para mais informações, consulte o Manual de Referência e Scripts do Elipse Power.
10.4.6 Configurar como Padrão

Configura as opções editadas nas opções de sombra e desenho da barra de ferramentas da Tela como padrão para
os demais objetos de Tela criados. Para utilizar este recurso, siga estes procedimentos:
1. Selecione um objeto que vai servir como modelo para os demais.
2. Clique com o botão direito do mouse e selecione a opção Configurar como Padrão.
3. Ao criar um novo objeto de Tela, as configurações de sombra e desenho deste objeto são utilizadas como
configurações iniciais dos próximos objetos.
10.4.7 Desenho
Permite aplicar ou editar informações relativas às cores de fundo e frente da Tela e objetos de Tela e à borda dos
objetos de Tela. 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 opções disponíveis na barra de ferramentas da Tela.
As opções disponíveis estão descritas na tabela Opções disponíveis na barra de ferramentas da Tela. Ao selecionar
a opção Estilo do Preenchimento, a janela da figura a seguir é aberta.

Janela Preenchimento
Opções disponíveis na janela Preenchimento
OPÇÃO DESCRIÇÃO
Estilos Mostra todos os estilos de preenchimento disponíveis
para o objeto selecionado
Cor da frente Mostra a cor da frente previamente selecionada para um

objeto. Permite também a seleção de uma nova cor de
frente, equivalente a clicar em
Cor do fundo Mostra a cor de fundo previamente selecionada para um

objeto. Permite também a seleção de uma nova cor de
fundo, equivalente a clicar em
Amostra Mostra como o efeito selecionado é aplicado com as

cores de fundo e de frente de um objeto
Opaco ou Transparente Ao selecionar a opção Transparente, os preenchimentos

com efeito hachurado não mostram a cor de fundo do
objeto selecionado, somente a cor de frente, criando um
efeito de transparência neste objeto. Ao selecionar a
opção Opaco, este efeito não acontece. NOTA: A opção
Transparente está desabilitada para Telas
10.4.8 Enquadrar
A opção de Enquadrar permite alternar entre dois comandos. Um primeiro comando redimensiona a Tela para
caber na área visível e um segundo comando restaura o nível de zoom e a posição anteriores da barra de rolagem.
NOTA
Esta alternância entre comandos é perdida nos seguintes casos:
· Ao mover a barra de rolagem da Tela
· Ao alterar o modo de zoom da Tela
· Ao alterar o modo de alinhamento da Tela em tempo de execução
· Ao alterar a área útil visível da Tela
Para manter o enquadramento de uma Tela na área visível, utilize a opção Toda Tela do menu Zoom.

10.4.9 Grade
Conjunto de linhas horizontais e verticais que servem como referência de posicionamento para objetos na Tela. A
grade é visualizada somente no Elipse Power Studio, e não em tempo de execução.
No Elipse Power Studio, é possível mostrar ou esconder a grade através do menu Arranjar - Grade ou clicando em
Grade na barra de ferramentas da Tela.
As propriedades da grade podem ser configuradas através do menu Arranjar - Edição da Grade ou clicando na
opção Edição da Grade na barra de ferramentas da Tela. Ao selecionar esta opção, a janela da figura a seguir é
mostrada.
Janela Propriedades da Grade

Opções disponíveis na janela Propriedades da Grade
OPÇÃO DESCRIÇÃO
Pontilhada Mostra pontos apenas nas intersecções das linhas de
grade
Linhas pontilhadas Mostra a linha de grade inteira pontilhada
Alinhar mouse automaticamente Alinha o ponteiro do mouse à linha de grade

automaticamente
Comprimento Determina a distância entre as linhas de grade

horizontais, em unidades Himetric
Largura Determina a distância entre as linhas de grade verticais,

em unidades Himetric
Cor Determina a cor das linhas de grade
10.4.10 Mover
Permite mover o conteúdo de uma Tela que contenha barras de rolagem no Elipse Power Studio ou no Elipse Power
Viewer, em tempo de execução. Para utilizar este recurso no Elipse Power Studio, siga estes procedimentos:
1. Selecione a opção Mover na barra de ferramentas da Tela.
2. Clique na Tela desejada para arrastá-la. O ponteiro do mouse muda para o ícone .
Para utilizar este recurso no Elipse Power Viewer, siga este procedimento:
1. Clique com o botão direito do mouse no Elipse Power Viewer e selecione a opção Mover no menu contextual.

NOTAS
· Tanto no Elipse Power Studio quanto no Elipse Power Viewer, a opção Mover está sempre disponível ao utilizar
o botão do meio do mouse.
· No Elipse Power Viewer, ou seja, em tempo de execução, clicar em objetos de Tela como Botões, Displays e
SetPoints, entre outros, impede o uso da opção Mover, visto que os objetos de Tela capturam o comportamento
do cursor do mouse. Nestes casos, deve-se utilizar as opções disponíveis para a opção Mover (botão do meio do
mouse ou menu contextual) somente nas áreas de Tela.
10.4.11 Ordem de Navegação entre os Objetos

Estabelece a ordem de navegação, através da tecla TAB, entre dois ou mais objetos em tempo de execução, isto é, a
ordem em que os objetos ganham foco. Para habilitar esta opção, siga estes procedimentos:
1. Selecione a Tela e clique em Ordem da Tabulação na barra de ferramentas da Tela.
2. Clique nos objetos conforme a ordenação desejada. O número com a ordem de navegação aparece no canto
superior esquerdo do objeto.
3. Quando o Domínio é executado, a navegação entre estes objetos é realizada conforme a ordem especificada.
Ordem da tabulação
Para manter a ordem inicial dos objetos, é necessário seguir estes procedimentos:
1. Após ter criado um objeto em uma Tela, clique em Ordem da Tabulação .
2. Com a tecla CTRL pressionada, clique no penúltimo objeto.
3. Solte a tecla CTRL e clique no último objeto, ou seja, no objeto criado anteriormente.
NOTA
A ordem de tabulação é equivalente à ordem de sobreposição dos objetos, descrita no tópico Sobreposição de
Objetos.
10.4.12 Ponto Âncora

Um Ponto Âncora é definido como as coordenadas que marcam o ponto inicial de um objeto. Inicialmente, o ponto
âncora está atrelado às coordenadas iniciais do objeto.
Para habilitar esta opção, clique com o botão direito do mouse em um objeto e selecione a opção Definir Ponto
Âncora. O objeto aparece com o símbolo , de onde pode ser movido para qualquer lugar da Tela. Ao arrastar o
objeto com a nova âncora, o ponto que foi definido é o que permanece fixado nos pontos da grade e o objeto
permanece deslocado nas mesmas proporções em relação à âncora. Isto só é visualizado se a opção Alinhar Mouse
Automaticamente (propriedade da Grade) está habilitada.

Objeto com ponto âncora
NOTA
Ao utilizar o atalho de teclado CTRL + Barra de espaço (efeito Snap to Pixel) em um objeto com a opção Definir
Ponto Âncora habilitada, o objeto é movido para o pixel mais próximo, sem respeitar a posição do ponto âncora.
Caso seja utilizado o mouse para mover o objeto, o ponto âncora é posicionado exatamente em cima de um pixel.
Para corrigir eventuais discrepâncias no posicionamento do objeto, pode-se utilizar o atalho de teclado CTRL + Barra
de espaço após soltar o botão do mouse.
10.4.13 Rotacionar
Permite rotacionar um objeto de Tela tendo como origem seu centro ou qualquer outro ponto na Tela. Para utilizar
este recurso, siga estes procedimentos:
1. Selecione um objeto na Tela e clique em Rotacionar na barra de ferramentas da Tela.
2. Clique em um de seus vértices de rotação, em verde, e arraste o objeto até a posição desejada.
3. Caso seja necessário, altere o centro de rotação do objeto, marcado por um círculo verde.
NOTA
· Para objetos de Tela do tipo Figura que utilizem o formato de arquivo Bitmap (arquivos com extensão .bmp), o
recurso de rotação não está disponível.
· No caso de alteração no centro de rotação de um objeto de Tela, o menu contextual do objeto passa a exibir a
opção Redefinir Centro de Rotação, que permite desfazer a alteração e retornar o centro de rotação do objeto
ao seu padrão.
10.4.14 Sobreposição de Objetos

Permite editar o modo como dois ou mais objetos estão sobrepostos. As opções disponíveis para esta configuração
estão descritas na tabela Opções disponíveis na barra de ferramentas da Tela.
10.4.15 Sombreamento
Permite aplicar ou editar o efeito de sombra em um objeto de Tela. Para utilizar este recurso, siga estes
procedimentos:
1. Insira ou selecione o objeto ao qual deseja aplicar a sombra.
2. Altere suas propriedades através da barra de ferramentas da Tela, de acordo com as opções mostradas na tabela
Opções disponíveis na barra de ferramentas da Tela.
10.4.16 Travar
Ao selecionar esta opção, o Elipse Power Studio não 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.
1. Para habilitar esta opção, clique com o botão direito do mouse no objeto desejado e selecione a opção Travar .

Objeto travado
2. Para desabilitar esta opção, clique novamente com o botão direito do mouse no objeto e selecione a opção
Destravar .
10.4.17 Zoom
Na edição da Tela, pode-se selecionar livremente o nível de zoom desejado e mais confortável para a edição. O nível
de zoom está disponível na barra de ferramentas da Tela e possui diversos níveis, além das opções Toda Largura ,
Toda Altura , Toda Tela e Preencher , conforme a figura a seguir.
Menu Zoom
Além do menu Zoom , pode-se modificar o nível de zoom através do teclado e mouse. Para isto, consulte o tópico
Atalhos de Teclado para uma lista de todos os atalhos disponíveis.
NOTA
· Ao utilizar as opções de CTRL + Roda do mouse (para cima ou para baixo), que respectivamente aumentam ou
diminuem o zoom, o foco deste zoom é sempre relativo à posição do ponteiro do mouse.
· Para simplesmente alternar entre um modo de zoom qualquer e o modo Toda Tela , use a opção Enquadrar.
10.5 Formatação de Cores

Em propriedades do tipo Cor, a alteração de valor pode ser realizada por meio de caixas de diálogo, como mostrado
na figura a seguir, disponíveis na Lista de Propriedades ao clicar em . Para selecionar uma cor, selecione uma cor
pré-definida na aba Padrão ou informe uma cor através de seus componentes na aba Personalizado.

Cores
A opção Outra permite que o usuário selecione uma cor de qualquer parte da tela, dentro ou fora do Elipse Power
Studio. Clique em e após na cor desejada para que seja capturada para a janela de cores.
Para personalizar uma cor, pode-se combinar as metodologias RGB (componentes de vermelho, verde e azul) ou HSL
(componentes de matiz, saturação e luminosidade).
Cor personalizada
A escala RGB descreve uma cor através da mistura de três cores básicas, a saber:
· Red (vermelho): Indica a quantidade do componente primário vermelho na composição da cor
· Green (verde): Indica a quantidade do componente primário verde na composição da cor
· Blue (azul): Indica a quantidade do componente primário azul na composição da cor
Cada um destes elementos de cor podem ter um grau de intensidade que varia entre 0 (zero) e 255.
A escala HSL descreve uma cor através da mistura de três componentes básicos, a saber:
· Hue (matiz): Especifica a gradação da cor dentro do espectro de luz visível

· Saturation (saturação): Indica a intensidade de um determinado matiz. Um matiz com alta saturação tem uma cor
mais intensa, enquanto um matiz com baixa saturação produz uma cor mais acinzentada
· Lightness (luminosidade): Indica a quantidade de luz aplicada à cor. Quanto maior a luminosidade, mais clara a
cor. Do mesmo modo, quanto menor a luminosidade, mais escura a cor
Estes elementos também podem ter seu grau de intensidade configurado entre 0 (zero) e 255. Assim, especifique o
valor para cada um dos itens conforme a tonalidade da cor desejada ou selecione a cor desejada diretamente com o
ponteiro do mouse sobre as escalas da janela.
O valor numérico de cada cor é obtido através da fórmula a seguir.
Red * 256 ^ 0 + Green * 256 ^ 1 + Blue * 256 ^ 2
Que é equivalente a:
Red * 1 + Green * 256 + Blue * 65536
As variáveis Red, Green e Blue podem assumir valores entre 0 (zero) e 255, conforme os exemplos a seguir.
· 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 são os valores numéricos, calculados
através da fórmula descrita anteriormente. A ferramenta Procurar e Substituir utiliza este valor armazenado no
processo de pesquisa, e não os valores formatados como RGB mostrados na Lista de Propriedades.
10.6 Formatação de Valores

O uso de formatadores permite mudar a forma como os dados são apresentados sem precisar mudar o valor que
existe por trás destes dados. O formato é um texto que pode ser editado manualmente ou configurado através da
janela de formatação. Seu uso é semelhante aos formatadores usados nas planilhas eletrônicas, seguindo a mesma
sintaxe básica, mas com algumas extensões. São suportados os seguintes tipos de dados:
· Numérico (saída decimal, científica, hexadecimal, binária e octal)
· Texto
· Booleano
· Data e Hora (calendário Gregoriano)
Os objetos que suportam formatação devem ter o tipo de dados na propriedade Value alterado de acordo com o
tipo de formatação desejada.

Janela de Formatação de Valores
As seguintes formatações estão disponíveis:
· Geral: Não há formatação específica. É realizada automaticamente, dependendo do tipo de dados
· Número: Apresenta números com parte inteira e fracionária, permitindo definir o número de casas decimais e uso
de separador de milhares. Para números muito grandes ou muito pequenos, utilize o formato Científico. Os
símbolos de casa decimal e separador de milhares são aqueles definidos no Painel de Controle - Configurações
Regionais
· Data e Hora: Apresentam valores numéricos (formato Gregoriano) como datas e horas, quando válidos
· Porcentagem: Multiplica o número por 100 e adiciona o símbolo de percentual, definindo também o número de
casas decimais
· Científico: Este formato apresenta o número em notação de mantissa e expoente. Ideal para números de
magnitude variada, permitindo selecionar também o número de casas decimais e formatos
· Especial: Permite formatar números inteiros em bases não decimais (hexadecimal, octal ou binária)
10.6.1 Outros Formatos

Na opção Outro, pode-se criar um formato de dados qualquer, mesmo um dos já citados, a partir da digitação de
um código (texto) de formato.
O texto do formatador é composto de até quatro campos separados por um ponto e vírgula. O primeiro campo é
sempre aplicado quando não existir um outro campo mais apropriado para o valor ou tipo de dados. O segundo
campo é utilizado para valores numéricos negativos. O terceiro campo é utilizado quando o valor numérico é igual a 0
(zero). Finalmente, o quarto campo é utilizado quando o dado é do tipo Texto.
Sempre que mais de um campo é definido, o campo anterior é considerado, mesmo que esteja vazio. No caso de um
formatador de campo vazio, o valor formatado é sempre um texto vazio. Note que isto difere do formato Geral, que
é apenas um formato vazio, sem o uso dos separadores de campo (ponto e vírgula).
Para inserir caracteres que são mostrados pelo formatador, pode-se colocá-los entre aspas duplas ou após uma
barra invertida. A tabela a seguir contém exemplos de entradas de texto, válidos para todos os tipos de
formatadores.
Entrada de Texto
FORMATADOR SAÍDA FORMATADA
"0#?" 0#?
\m\d\y mdy
Também é possível criar formatadores que contenham apenas texto, que podem ser combinados com o uso de
diferentes campos, como na tabela a seguir.

Formatador e Saída Formatada
VALOR FORMATADOR SAÍDA FORMATADA
1 "Positivo";"Negativo";"Zero","Texto" Positivo
-1 "Positivo";"Negativo";"Zero","Texto" Negativo
0 "Positivo";"Negativo";"Zero","Texto" Zero
"Abcd" "Positivo";"Negativo";"Zero","Texto" Texto
Além disto, os caracteres que podem ser mostrados diretamente sem o uso de aspas ou barra são $ (cifrão), - (traço),
+ (sinal de mais), / (barra), () (parênteses), : (dois pontos), ! (ponto de exclamação), ^ (acento circunflexo), & (e
comercial), ' (aspas simples à esquerda), ' (aspas simples à direita), ~ (til), {} (chaves), = (sinal de igual), < (menor que)
e > (maior que).
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 numéricos aceitam os tipos básicos de caracteres mostrados na tabela a seguir para definir o
número de dígitos apresentados.
Formatadores Numéricos
OPÇÃO DESCRIÇÃO
0 (zero) Coloca o dígito significativo ou 0 (zero) quando não
houver
# Coloca o dígito significativo
? Coloca o dígito significativo ou um espaço quando não

houver
O ponto decimal define que se deseja apresentar também a parte fracionária de um número. A vírgula tem como
função indicar que o valor deve ser dividido por mil, para cada vírgula, após os dígitos do formatador.
Independente da configuração local do Windows, o ponto e a vírgula sempre devem ser utilizados no texto do
formatador para indicar o separador de milhar e de decimal, mas a saída formatada é de acordo com a configuração
regional do sistema. A tabela a seguir descreve as opções disponíveis.
Opções disponíveis
DADO FORMATADOR SAÍDA FORMATADA
12000 #, 12
1234567 #,#.0 1,234,567.0
10.6.1.1 Formato Científico

Um número pode ser apresentado em notação científica (mantissa e expoente) quando após algum dígito existir E+,
E-, e- ou e+, seguido de dígitos para formatar o expoente. Quando se usa E+ ou e+ o expoente é sempre mostrado
com sinal, e quando se usa E- ou e-, o sinal aparece apenas para expoente negativos. O expoente sempre mostra um
dígito, mesmo que este seja 0 (zero). O número de dígitos à direita do ponto decimal afeta o expoente mostrado. A
tabela a seguir contém exemplos de valores formatados usando o formato científico.
Formatador Científico
1000 #E+00 1E+03
1000 ##e-00 10e02

10.6.1.2 Formato de Base Não Decimal
Os formatadores para bases não decimais sempre apresentam apenas a parte inteira do valor numérico formatado, e
também não são sensíveis ao sinal. Da mesma forma que na base decimal, caso o número possua mais dígitos do
que o requisitado no formatador, estes dígitos são apresentados de qualquer forma.
Atualmente, estes formatadores estão limitados a números de 32 bits. Caso a parte inteira do valor exceda este limite,
a formatação retorna erro. A tabela a seguir contém exemplos de valores formatados usando um formato de base
não decimal.
Formatadores para bases não decimais
255 "0x"XXX 0x0FF
12345 oooo\o 30071o
987 B 1111011011
12 BBBB - BBBB 0000 - 1100
10.6.1.3 Formato de Data e Hora

A sintaxe da formatação de datas e horas difere um pouco do sistema usado por planilhas eletrônicas, seguindo o
modo usado pela configuração regional do Windows. As datas são valores numéricos em que a parte inteira é uma
contagem de dias desde 31 de dezembro de 1899 e a parte fracionária representa a hora em frações de dia.
O ano mínimo suportado é 100 e o ano máximo é 9999, garantindo uma resolução de pelo menos um milissegundo
em todo o intervalo. Os nomes de meses e dias da semana, a ordem padrão de dia, mês e ano e o separador de
datas e horas são todos utilizados de acordo com a configuração regional do Windows. A tabela a seguir contém
exemplos de valores formatados usando o formato de data e hora.
Formatadores para Datas e Horas
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 296h17m46.667s
NOTA
Os valores armazenados nas propriedades dos objetos que se referem a datas são os valores numéricos, calculados
através da fórmula anterior. A ferramenta Procurar e Substituir utiliza este valor armazenado no processo de
pesquisa, e não os valores formatados como data e hora mostrados na Lista de Propriedades.
10.6.1.4 Formato Texto

O caractere @ copia o valor do dado na posição onde aparecer. Este formatador deve aparecer no quarto campo
(por exemplo, ;;;@) ou diretamente quando há apenas um campo. A tabela a seguir contém exemplos de valores
formatados usando o formato texto.
Formatador para Texto
Abc @@ Abc Abc
xyZ "Nome: " \ " @ \ " Nome: "xyZ"

CAPÍTULO
Associações
11
Associações (ou conexões) são ligações realizadas entre propriedades e objetos ou outras propriedades. As
Associações trazem grande facilidade ao criar animações e outros tipos de lógicas comuns, minimizando a utilização
de scripts.
Pode-se acessar a aba Associações clicando-se com o botão direito do mouse no objeto e selecionando a opção
Propriedades. Nesta aba, são mostradas as propriedades do objeto que podem ser associadas, bem como os tipos
de Associações existentes e suas fontes.
Aba Associações
As opções disponíveis na aba Associações estão descritas na tabela a seguir.
Opções disponíveis na aba Associações
OPÇÃO DESCRIÇÃO
Propriedades Lista as propriedades do objeto que podem ser
associadas
Conexão Indica o tipo de Associação que a propriedade possui.

Para propriedades comuns, as Associações disponíveis
são Simples, Bidirecional, Analógica, Digital, Por
Tabela, Reversa e Múltipla. Existe ainda a ligação entre
propriedades de ElipseX e objetos, que ainda não pode
ter seu tipo modificado. Para maiores detalhes, consulte o
capítulo Bibliotecas
Fonte No caso mais simples, especifica o caminho para um

objeto ou propriedade. Este caminho pode ser
preenchido pelo AppBrowser, clicando-se em , à direita
do campo. No caso geral, é uma expressão que permite
aplicar operações lógicas, aritméticas e avaliações de
funções à propriedades, objetos e constantes
Ao especificar a fonte da Associação, o seu texto aparece em azul, caso esta corresponda a uma expressão válida. Se
a expressão contiver erros, como no caso de caminhos de objetos que não existam (ou pertençam a projetos que não
estejam carregados), o texto aparece em vermelho. Nestes casos, a opção de Verificação de Domínio informa os
locais que necessitam de correção ou revisão. Os tipos de Associações disponíveis são explicados nos tópicos a
seguir.
O campo Fonte pode conter uma referência a um objeto de contexto existente na hierarquia superior do objeto onde
se está criando a Associação. O formato de uma referência deste tipo é @(Contexto)[.Caminho], onde Contexto é o
nome do contexto (os valores possíveis podem ser vistos na descrição do método Context, no Manual de Referência
Associações 258
e Scripts do Elipse Power) e Caminho pode ser o caminho de um objeto existente na hierarquia inferior do objeto de
contexto, ou uma propriedade deste mesmo objeto. Os nomes dos contextos não são sensíveis a maiúsculas e
minúsculas.
NOTA
Ao especificar o caminho de um objeto no campo Fonte, este caminho deve estar delimitado por colchetes nos
seguintes casos:
· Contenha qualquer caractere que não seja uma letra (a-z | A-Z) quando usado como primeiro caractere do
caminho.
· Contenha qualquer caractere que não seja uma letra (a-z | A-Z), um número (0-9) ou um sublinhado (_) quando
usado após o primeiro caractere do caminho.
11.1 Simples
Na Associação Simples, o valor da opção Fonte é copiado para a propriedade toda vez que a primeira é modificada.
Associação Simples
1. Selecione o objeto para a Associação.
2. Clique com o botão direito do mouse no objeto e selecione a opção Propriedades.
3. Clique na aba Associações e selecione a propriedade para criar a Associação. O Elipse Power Studio indica
vários tipos de Associações.
4. Na opção Fonte, selecione a Associação e clique em para indicar a propriedade a referenciar, ou escreva a
expressão nesta opção.
11.2 Bidirecional
A Associação Bidirecional é semelhante à Associação Simples. Porém, caso haja uma variação na propriedade, seu
valor é copiado para a fonte, gerando assim uma Associação de duas direções.
259 Associações
Associação Bidirecional
11.3 Digital
Já na Associação Digital pode-se estabelecer que, caso a variável ou expressão da opção Fonte represente um valor
digital (Booleano), seus estados Verdadeiro e Falso são mapeados para certos valores no destino, incluindo a opção
Pisca (alternância de valores).
Associação Digital
As opções disponíveis nesta Associação estão descritas na tabela a seguir.
Opções disponíveis para a Associação Digital
OPÇÃO DESCRIÇÃO
Ligado Especifica o valor assumido pela propriedade quando a
expressão da fonte é Verdadeira
Associações 260
OPÇÃO DESCRIÇÃO
Desligado Especifica o valor assumido pela propriedade quando a
expressão da fonte é Falsa
Pisca Quando este campo estiver habilitado, a propriedade

conectada alterna entre os valores da opção Para valor,
caso a fonte retorne Verdadeiro. Caso contrário, a
propriedade retornada alterna entre os valores das
opções Valor e Para valor caso a fonte retorne Falso
Para valor <Campo Ligado> Especifica o valor alternativo a ser assumido

periodicamente pela propriedade quando a expressão
ou Associação da fonte resultar em Verdadeiro e a
opção Pisca estiver habilitada
Para valor <Campo Desligado> Especifica o valor alternativo a ser assumido

periodicamente pela propriedade quando a expressão
da fonte resultar em Falso e a opção Pisca estiver
desabilitada

11.4 Analógica
A Associação Analógica permite estabelecer uma escala de conversões entre a variável fonte e destino. Através dos
valores especificados, é realizada uma escala linear entre os valores da propriedade e os valores da fonte.
Associação Analógica
Opções disponíveis para a Associação Analógica
OPÇÃO DESCRIÇÃO
Valor na Fonte Determina os valores mínimo e máximo atingidos na
fonte
Valor na Propriedade Determina os valores mínimo e máximo atingidos na

propriedade
261 Associações
2. Clique com o botão direito do mouse no objeto, selecione o item Propriedades e clique na aba Associações.
Selecione a propriedade para criar a Associação. O Elipse Power Studio indica vários tipos de Associações.
11.5 Por Tabela

Na Associação por Tabela, é possível especificar um conjunto de intervalos em função de valores máximo e mínimo
da fonte e, para cada um destes intervalos, o valor a ser assumido pela propriedade. Além disto, assim como na
Associação Digital, é possível especificar a opção de Pisca e o valor alternativo. Para utilizar este recurso, siga estes
procedimentos:
1. Abra a janela de propriedades do objeto e selecione a aba Associações.
2. Selecione a propriedade para criar a Associação e clique no item Conexão por Tabela.
Associação por Tabela

Opções disponíveis para a Associação por Tabela
OPÇÃO DESCRIÇÃO
Inserir Insere uma nova linha na tabela
Remover Remove a linha selecionada da tabela
Mín Especifica o valor mínimo da fonte para uma linha da

tabela
Máx Especifica o valor máximo da fonte para uma linha da

tabela
Valor Especifica o valor da propriedade a ser assumido

quando a fonte estiver no intervalo especificado na linha
Pisca Determina que quando a fonte estiver no intervalo desta

linha, a propriedade alterna periodicamente entre os
valores especificados nas opções Valor e Valor (com o
Pisca habilitado)
Valor <Pisca Habilitado> Especifica o valor alternativo da propriedade a ser

assumido quando a fonte estiver no intervalo
especificado na linha, isto é, quando a opção Pisca
estiver habilitada
Associações 262
1. Na aba Associações, selecione a propriedade e associe a opção Conexão por tabela.
2. Crie as linhas na tabela e configure as colunas Mín, Máx e Valor.
3. Caso seja necessário alternar periodicamente entre os valores, habilite a coluna Pisca e configure as opções
restantes.
11.6 Reversa
Na Associação Reversa, toda vez que o valor da propriedade é modificado, este é copiado para a fonte, funcionando
assim de maneira inversa à Associação Simples. Para utilizar este recurso, siga estes procedimentos:
1. Abra a janela de propriedades do objeto e selecione a opção Associações.
2. Selecione a propriedade para criar a Associação e clique no item Conexão Reversa.
Associação Reversa
11.7 Múltipla
Na Associação Múltipla, cada linha da Associação permite buscar o valor de uma fonte diferente. A fonte ativa é
selecionada de acordo com o valor da fonte principal da Associação.
Cada linha possui o intervalo (propriedades Min e Max) e a fonte para aquele intervalo (propriedade Source, que é
uma Associação normal). Para utilizar este recurso, siga estes procedimentos:
1. Abra a janela de propriedades do objeto e selecione a aba Associações.
2. Selecione a propriedade para criar a Associação e clique no item Conexão Múltipla.
3. Defina a fonte principal da Associação na coluna Fonte.
263 Associações
Associação Múltipla
Opções disponíveis para a Associação Múltipla
OPÇÃO DESCRIÇÃO
Inserir Insere uma nova linha na tabela
Remover Remove a linha selecionada da tabela
Mín Especifica o valor mínimo da fonte para uma linha da

tabela
Máx Especifica o valor máximo da fonte para uma linha da

tabela
Fonte Especifica a fonte que é associada com a propriedade

quando o valor da fonte principal estiver entre os limites
Mín e Máx
Manter todas associações ativas Mantém todas as Associações da tabela em modo

Advise (ativas). Esta opção corresponde à propriedade
AdviseAll
11.8 Edição de Associações

O Elipse Power possui uma ferramenta para editar Associações, chamada Edição de Associações. Assim, é possível
mudar uma ou mais Associações criadas na aplicação de forma mais rápida do que pela janela tradicional.
Para acessar esta ferramenta, clique com o botão direito do mouse em um ou mais objetos e selecione a opção
Editar Associações.
Associações 264
Opção Editar Associações
A caixa de diálogo da figura a seguir é mostrada.
Edição de Associações
A caixa de diálogo anterior mostra uma lista das Associações, propriedades do tipo Link e eventos do usuário
relacionados aos objetos selecionados e seus filhos. De acordo com o tipo de linha, as informações mostradas nas
colunas estão descritas na tabela a seguir.
Opções disponíveis na janela Editar Associações
OPÇÃO DESCRIÇÃO
Nome do Objeto Determina o nome do objeto
Propriedade / Evento Determina a propriedade do objeto que possui a

Associação
Conexão Determina o tipo de Associação, Simples, Bidirecional,

Digital, Analógica, Por Tabela, Reversa ou Múltipla
Fonte Determina a fonte da Associação
Opções para Propriedades do tipo Link

OPÇÃO DESCRIÇÃO
Nome do Objeto Determina o nome do objeto que possui a propriedade
Propriedade / Evento Determina o nome da propriedade
Conexão É sempre a mesma, Link
265 Associações
OPÇÃO DESCRIÇÃO
Fonte Determina o valor da propriedade
Opções para Eventos do usuário

OPÇÃO DESCRIÇÃO
Nome do Objeto Determina o nome do objeto que possui o evento
Propriedade / Evento Determina o nome do evento do usuário
Conexão Determina o tipo do evento, OnEvent, WhileEvent ou

OnValueChangeEvent
Fonte Expressão relacionada ao evento
Na caixa de diálogo Editar Associações, é permitido modificar as seguintes opções:

· Associações: Podem ser modificadas, exceto o nome do objeto
· Propriedades do tipo Link: Podem ser modificadas, exceto o nome do objeto
· Eventos do usuário: Podem ser modificados, exceto o nome do objeto e o nome do evento
Clicar em Remover permite a remoção da Associação selecionada. A opção Mostrar janela de propriedades das
associações determina se os minidialogs das Associações são mostrados quando a linha estiver selecionada. Se esta
janela estiver visível, é permitida a edição das propriedades das Associações. Seu valor padrão é habilitado.
NOTA
Na janela Editar Associações, o usuário pode manter a Associação com a fonte vazia. Para isto, selecione a coluna
Fonte e pressione a tecla DELETE.
Edição das propriedades da Associação selecionada

Para editar as propriedades dos eventos do usuário, é necessário selecionar a linha que contém o evento e, na coluna
Conexão, clicar na opção Editar.
Associações 266
Edição das propriedades dos eventos do usuário
Ao clicar na opção Editar, a caixa de diálogo a seguir é mostrada, permitindo assim que seja editado o evento do
usuário selecionado.
Janela Editar Eventos

Opções disponíveis na janela Editar Eventos
OPÇÃO DESCRIÇÃO
Propriedade ou expressão Propriedade ou expressão geradora do evento
Sempre que a propriedade for uma condição Indica que o evento é do tipo etOnEvent ou
verdadeira etWhileEvent
Repetir o evento Indica o ciclo de repetição do evento em milissegundos,

isto é, de quanto em quanto tempo o evento ocorre
enquanto a expressão geradora é verdadeira
Intervalo de repetição (ms) Valor para o intervalo de repetição, em milissegundos
Sempre que a propriedade alterar o seu valor Indica que o evento é do tipo etOnValueChangeEvent,
isto é, o evento ocorre sempre que a expressão
geradora muda o valor
Tratar a desconexão como mudança de valor Se houver alguma desconexão, esta é tratada como uma
mudança de valor
A janela de edição de Associações permite utilizar o recurso de copiar e colar entre as Associações das propriedades.
A opção Copiar Associação copia a Associação da linha selecionada e a opção Colar Associação cola a Associação
na linha selecionada, substituindo a Associação anterior.
267 Associações
Opção de copiar ou colar uma Associação
11.9 Propriedades do Tipo Texto com Associações

Algumas propriedades de tipo Texto permitem o uso de expressões quando utilizadas em Associações, da
seguinte forma:
· A expressão deve estar entre chaves. Caso haja necessidade de mostrar o caractere de chaves, este deve ser
duplicado no texto ("{{" na abertura e "}}" no fechamento). O texto que estiver fora das chaves é considerado
literalmente.
· O texto da propriedade pode ter quantas expressões sejam necessárias, desde que os caracteres de chaves de
abertura de cada expressão tenham o seu correspondente no fechamento da expressão.
· Caso a expressão seja inválida, em tempo de execução é mostrado o texto "NULL" na Associação. Se a expressão
contiver também texto literal, este texto é mostrado e a parte relativa à expressão inválida contém o texto "NULL".
· A expressão também suporta o formato @(Contexto), onde Contexto é uma String com o nome de um contexto
implementado por um objeto na hierarquia superior do objeto atual. Para uma listagem com os nomes de
contexto disponíveis, veja o método Context no Manual de Referência e Scripts do Elipse Power.
Exemplos de Expressões Válidas

Mostra o texto "Modo de Proteção: ", seguido do conteúdo da propriedade DocString.
Modo de Proteção: {DocString}
Mostra o conteúdo da propriedade Name, seguido do texto " - " e o conteúdo da propriedade ShortName entre
chaves.
{Name} - {{ShortName}}
Mostra o texto "Área: ", seguido do conteúdo da propriedade PathName do primeiro objeto na hierarquia superior
do objeto atual que implementa o contexto Area.
Área: {@(Area).PathName}
Exemplos de Expressões Inválidas

Mostra o texto "Modo de Proteção: NULL", pois o nome da propriedade DocString está incorreto.
Modo de Proteção: {DocStrin}
Mostra o conteúdo da propriedade Name, seguido do texto " - NULL", pois há um caractere de chaves a mais na
expressão da propriedade ShortName.
{Name} - {{ShortName}}}
Mostra o texto "Área: NULL", pois o nome do contexto está incorreto.

Área: {@(Arrea).PathName}
Associações 268
CAPÍTULO
Bibliotecas
12
O Elipse Power possui ferramentas que permitem transformar qualquer objeto ou conjunto de objetos da aplicação
em uma Biblioteca do usuário. As Bibliotecas podem ser formadas por objetos frequentemente utilizados e
subsequentemente reaproveitados em outra aplicação.
O Elipse Power fornece dois tipos de Bibliotecas para o usuário: a Galeria, uma Biblioteca de símbolos gráficos
vetoriais que podem ser livremente utilizados nas aplicações; e uma ferramenta de Bibliotecas do usuário chamada de
ElipseX. O uso de Bibliotecas no Elipse Power é altamente recomendável na maioria dos casos, devido ao ganho de
produtividade que trazem às aplicações. Algumas das vantagens dos ElipseX são as seguintes:
· Reutilização de códigos
· Minimização de testes durante o desenvolvimento
· Criação de interfaces padrão para os objetos desenvolvidos
· Diminuição do tempo de desenvolvimento de novos projetos
· Proteção do conteúdo do projeto
· Hierarquização de objetos
Bibliotecas no Organizer
12.1 Galeria
A Galeria pode ser acessada clicando-se em Galeria na barra de ferramentas Padrão. Este item contém uma série
de elementos gráficos vetoriais divididos em categorias, que podem ser arrastados para as Telas ou então para os
ElipseX. Estão disponíveis os seguintes tipos de símbolos: Botões 3-D, Símbolos 3-D ISA, Ar Condicionado, Arquitetura,
Setas, Controles e Equipamentos ASHRAE, Dutos ASHRAE, Canos ASHRAE, Formas Básicas, Ventiladores, Aquecedores,
Prédios, Processos Químicos, Computadores, Teclas de Computadores, Contêineres, Controladores, Esteiras, Dutos,
Elétrica, Acabamentos, Tubos Flexíveis, Medidores de Vazão, Alimentos, Aquecimento, HVAC, Ícones e Bitmaps,
Miscelânea Industrial, Símbolos Internacionais, Símbolos ISA, Laboratório, Maquinaria, Mapas e Bandeiras, Manuseio
de Materiais, Mineração, Canos, Símbolos 1, Símbolos 2, Misturadores, Motores, Natureza, Interface de Operação,
Painéis, Canos, Acessórios Industriais, Energia, Resfriamento de Processos, Aquecimento de Processos, Papel e
Celulose, Bombas, Segurança, Balanças, Canos Segmentados, Sensores, Cortes em Tanques, Tanques, Texturas,
Válvulas, Veículos, Água e Resíduos e Fios e Cabos.
1. Clique em Galeria na barra de ferramentas Padrão.
2. Ao selecionar esta janela, tem-se acesso aos conjuntos de símbolos, que estão agrupados em categorias.
Selecione a categoria através da lista na parte superior da janela.
3. Para inserir um objeto da Biblioteca de símbolos em uma Tela, clique no objeto desejado e arraste-o para a Tela.
4. Depois de inserido, o objeto pode ser livremente editado e trabalhado de acordo com as características descritas
para os objetos de imagem. Por exemplo, pode-se mudar a cor de preenchimento diretamente através das
propriedades OverrideFillMode, OverrideFillColor e OverrideLineColor, sem a necessidade de transformar o
objeto em um objeto gráfico do Elipse Power.
269 Bibliotecas
Galeria
12.2 Biblioteca do Usuário (ElipseX)

Os ElipseX são as Bibliotecas de objetos do Elipse Power. Podem conter, além de um desenho, variáveis internas
passíveis de serem exportadas para a aplicação, além de lógicas de programação (scripts) presentes em todas as
cópias do objeto criado, diminuindo a necessidade de repetição de código em diversas partes do aplicativo.
Os ElipseX permanecem encapsulados em um arquivo com extensão .lib. Pode-se criar todos os ElipseX que são
utilizados em um determinado projeto no mesmo arquivo de Biblioteca (.lib) ou então dividir entre vários arquivos.
Para criar uma nova Biblioteca no Elipse Power, siga estes procedimentos:
1. Selecione o menu Arquivo - Novo Projeto e clique em Próximo.
2. Na opção Tipo de Aplicação, selecione a opção Biblioteca de componentes do E3.
Criação de uma biblioteca do usuário (ElipseX)

3. Digite um nome para a Biblioteca e clique em Avançar.
4. Configure as especificações referentes ao Domínio.
5. Clique em Concluir.
Dentro de uma Biblioteca ElipseX, pode-se inserir três tipos de objetos: os XControls, os XFolders e os XObjects.
Bibliotecas 270
Os seguintes itens podem ser inseridos em um XControl: primitivas de desenho (Retas, Retângulos, Círculos, etc.),
objetos gráficos vetoriais, incluindo objetos da Biblioteca de símbolos (WMF, EMF, etc.), objetos gráficos não vetoriais
(BMP, JPEG, GIF, etc.), controles ActiveX do Elipse Power (E3Alarms, E3Browsers, E3Charts e E3Playbacks), controles
ActiveX de terceiros, Consultas, Filtros de Alarmes, Impressoras de Linha e outros XControls.
Um XFolder é um objeto que permite inserir objetos filhos em suas instâncias. Desta forma é possível organizar ou
criar hierarquias de objetos em uma aplicação. Pode-se inserir em instâncias de XFolders itens como Pastas de Dados,
Tags de Comunicação, Consultas, Filtros de Alarmes e instâncias de XFolders e XObjects.
Já os XObjects podem conter quaisquer tipos de objetos não gráficos executados no E3 Server, como Bancos de
Dados, Configurações de Alarmes, Fórmulas, Históricos, Storages, Alimentadores, Linhas de Transmissão, Parques
Eólicos, Plantas Fotovoltaicas, Subestações, Servidores de Dados, Drivers de Comunicação e Alarmes.
NOTA
A Janela de Propriedades dos ElipseX no Editor de objetos pode ser aberta utilizando os atalhos de teclado ALT +
ENTER ou ALT + Duplo-clique do mouse.
Dentro de um mesmo arquivo .lib pode existir qualquer número de componentes ElipseX, sejam eles XControls,
XFolders ou XObjects. Pode-se também ter várias Bibliotecas diferentes dentro do mesmo Domínio.
Note que para cada ElipseX criado em uma Biblioteca são criadas internamente duas interfaces, uma para declarar as
propriedades do objeto e outra para declarar os eventos do objeto. Estas interfaces têm seus nomes gerados
automaticamente, acrescentando o prefixo "D" a este nome (a interface de eventos adiciona o sufixo "Events" ao nome
automático). Se, por exemplo, o objeto se chama "XObject1", sua interface de propriedades tem o nome "DXObject1"
e a interface de eventos, "DXObject1Events". Uma tentativa de usar estes nomes em outras classes na mesma
Biblioteca gera um código de erro 8002802D, que corresponde a Name already exists in the library.
12.2.1 XControls
O XControl define uma interface gráfica com o usuário, que pode ser composta de quaisquer objetos do Elipse
Power e tem o propósito de ser multiplicada facilmente por um projeto. Pode-se criar um XControl clicando com o
botão direito do mouse no item Bibliotecas de Objetos - XControls no modo Domínio, selecione a opção Inserir
XControl em e logo após o nome da Biblioteca.
271 Bibliotecas
Aba Design de um XControl
Aba Propriedades de um XControl

Ao inserir um XControl é aberto o Editor deste objeto, composto por três abas. Além da aba Scripts, presente em
todos os objetos, existe a aba Design, que equivale a uma Tela onde podem ser inseridos os objetos gráficos
descritos anteriormente, e a aba Propriedades, onde podem ser inseridas variáveis, que são as Propriedades do
XControl. Estas Propriedades são exportadas pelo objeto e podem ser associadas a um Tag ou outra propriedade
qualquer quando o objeto estiver em uso na aplicação.
As variáveis a serem exportadas podem ser inseridas pressionando-se a tecla INSERT do teclado ou clicando em
Adicionar e excluídas através da tecla DELETE do teclado ou clicando em Remover . As opções disponíveis na
aba Propriedades estão descritas na tabela a seguir.
OPÇÃO DESCRIÇÃO
Nome Determina o nome da variável do XControl
Bibliotecas 272
OPÇÃO DESCRIÇÃO
Tipo Determina o tipo de dados suportado pela variável. Note
que outros objetos de dados (XFolders e XObjects)
podem ser declarados como tipos de dados. 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 estrutura
ou classe, como utilizado na linguagem de programação
C/C++. Quando é especificado um tipo de objeto, como
por exemplo DemoTag, IOTag ou XObject, esta
Propriedade tem o seguinte comportamento:
· Caso o ElipseX esteja inativo: A Propriedade funciona
como uma String, que especifica o caminho da
instância de um objeto do tipo de dados configurado
· Caso o ElipseX esteja ativo: Na escrita, a Propriedade
funciona como o caso anterior, porém na leitura a
Propriedade retorna o objeto especificado, caso exista.
Se o caminho não aponta para um objeto existente no
momento, a Propriedade retorna Nothing
Esta opção corresponde à propriedade Type de um
objeto Definição de Propriedade
Pública Habilita ou desabilita a visibilidade da variável fora da

Biblioteca, isto é, determina se a variável é ou não
pública. Esta opção corresponde à propriedade Public
de um objeto Definição de Propriedade
Gravável Determina se a variável é salva no projeto ou não. Esta

opção corresponde à propriedade Persistable de um
Retentiva Determina se a Propriedade é retentiva ou não. No caso

de XControls, as Propriedades não podem ser retentivas.
Esta opção corresponde à propriedade Retentive de um
Valor inicial Determina o valor inicial da variável. Esta opção

corresponde à propriedade DefaultValue de um objeto
Definição de Propriedade
Texto de ajuda Texto de declaração e documentação da variável. Esta

opção corresponde à propriedade HelpString de um
NOTA
É interessante observar que XFolders e XObjects podem ser declarados como tipos de dados.
A edição do objeto gráfico pode ser realizada da mesma forma como é a edição de uma Tela, possuindo os mesmos
recursos gráficos e opções.
Pode-se inserir os XControls em qualquer Tela, ou ainda dentro de outro XControl clicando com o botão direito do
mouse na Tela ou XControl de destino e selecionando a opção Inserir, como mostrado a seguir. A partir de um
XControl em desenvolvimento (dentro da Biblioteca), é possível inserir outro XControl dentro dele, clicando com o
botão direito do mouse no XControl de destino e selecionando a opção Inserir.
273 Bibliotecas
Inserindo um XControl na Tela
A partir deste momento, o XControl tem um nome dentro da Tela, e é entendido como uma cópia da definição
original. Assim, deve-se definir (se necessário) os valores ou as Associações que esta cópia específica tem no contexto
que é utilizada. Se o tamanho deste objeto é alterado na aba Design do Editor da Biblioteca e registrado novamente,
é necessário usar a opção Tamanho Original no seu menu contextual da Tela para que a alteração apareça.
Ao criar um objeto Bomba, por exemplo, com uma Propriedade Estado que receba uma informação externa
revelando se a bomba está ligada ou desligada mudando sua cor, ao inserir este objeto na Tela o Elipse Power
automaticamente renomeia o objeto para "Bomba1".
Pode-se manter este nome ou renomeá-lo para outro que se desejar. Depois, deve ser informada qual variável vai ser
associada à Propriedade Estado. Suponha que certo Tag de Comunicação representa o estado desta bomba. Logo,
deve ser criada uma Associação entre a Propriedade Estado e o referido Tag. O mesmo trabalho deve ser executado
para outras instâncias ou cópias do objeto Bomba que sejam necessárias no projeto.
12.2.2 XFolders
Um XFolder é um objeto de servidor que permite organizar ou criar uma hierarquia de objetos nas instâncias criadas.
Os objetos que podem ser inseridos em uma instância de XFolder são os seguintes:
· Pastas de Dados
· Tags de Comunicação
· Consultas
· Filtros de Alarmes
· Instâncias de XFolders e XObjects
· Alarmes
NOTA
Não é permitido inserir objetos na definição de um XFolder, somente em suas instâncias.
Para criar um XFolder, clique com o botão direito do mouse no item Bibliotecas de Objetos - XFolders no modo
Domínio, selecione a opção Inserir XFolder em e logo após o nome da Biblioteca desejada.
Bibliotecas 274
Aba Propriedades de um XFolder
Ao inserir um XFolder, é aberto o Editor deste objeto, onde podem ser inseridas variáveis. Estas variáveis são as
Propriedades a serem exportadas pelo objeto, que podem ser associadas a um Tag ou outra propriedade qualquer
de uma aplicação quando o objeto estiver em uso em uma aplicação.
Adicionar e excluídas através da tecla DELETE ou clicando em Remover . As opções disponíveis na aba
Propriedades estão descritas na tabela a seguir.
OPÇÃO DESCRIÇÃO
Nome Determina o nome da variável do XFolder

funciona da mesma maneira de quando o objeto está
desativado. Porém, na leitura a Propriedade retorna o
objeto especificado, caso exista. Se o caminho não
aponta para um objeto existente no momento, a
Propriedade retorna Nothing


Retentiva Determina se a Propriedade é retentiva ou não. Esta

opção corresponde à propriedade Retentive de um

275 Bibliotecas
OPÇÃO DESCRIÇÃO
Pode-se inserir XFolders em qualquer Servidor de Dados, clicando com o botão direito do mouse no Servidor de
Dados no modo Domínio, selecionado a opção Inserir e logo após o nome do XFolder desejado, conforme
mostrado na figura a seguir. No modo Explorer, clique com o botão direito do mouse no Servidor de Dados do
projeto, selecione a opção Inserir e logo após o nome do XFolder desejado.
Inserindo um XFolder no modo Domínio
12.2.3 XObjects
Além dos XControls e XFolders, pode-se criar uma Biblioteca de dados denominada XObject. Com esta Biblioteca
pode-se definir uma estrutura de dados que é executada no servidor. Tal estrutura pode realizar cálculos,
Associações, comunicações, verificação de alarmes, registros históricos, etc., que independam de que alguma interface
gráfica (Elipse Power Viewer) esteja aberta ou em execução naquele momento. Para criar um XObject, clique com o
botão direito do mouse no item Bibliotecas de Objetos - XObjects no modo Domínio, selecione a opção Inserir
XObject em e logo após o nome da Biblioteca desejada.
Bibliotecas 276
XObjects
Ao inserir um XObject, é aberto o Editor deste objeto, onde podem ser inseridas variáveis. Estas variáveis são as
Propriedades a serem exportadas pelo objeto, que podem ser associadas a um Tag ou outra propriedade qualquer
de uma aplicação quando o objeto estiver em uso em uma aplicação.
Adicionar e excluídas através da tecla DELETE ou clicando em Remover . As opções disponíveis na aba
Propriedades estão descritas na tabela a seguir.
OPÇÃO DESCRIÇÃO
Nome Determina o nome da variável do XObject

funciona da mesma maneira de quando o objeto está
desativado. Porém, na leitura a Propriedade retorna o
objeto especificado, caso exista. Se o caminho não
aponta para um objeto existente no momento, a
Propriedade retorna Nothing


Retentiva Determina se a Propriedade é retentiva ou não. Esta

opção corresponde à propriedade Retentive de um

277 Bibliotecas
OPÇÃO DESCRIÇÃO
Apenas Propriedades de tipos de dados simples (Variant, String, Date, Double, etc.) podem ser retentivas (o Editor
do objeto desmarca automaticamente a coluna Retentiva se o tipo de dados de uma Propriedade é alterado para
um objeto), e apenas Propriedades de XFolders e de XObjects podem ser retentivas.
NOTA
O uso de Propriedades retentivas nos ElipseX pode aumentar o tempo de início do aplicativo e também aumentar o
consumo de memória pelo processo E3Run. Os tempos variam dependendo do número de instâncias de XFolders e
de XObjects, do número de Propriedades retentivas em cada XFolder ou XObject e da quantidade destas
Propriedades que possuem o seu valor alterado. Se a Propriedade nunca é alterada, o seu valor retentivo
permanece zerado.
Podem ser inseridos em um XObject quaisquer módulos do Elipse Power que sejam executados no servidor, como
Bancos de Dados, Configurações de Alarmes, Fórmulas, Históricos, Storages, Alimentadores, Linhas de Transmissão,
Parques Eólicos, Plantas Fotovoltaicas, Subestações, Servidores de Dados, Tags de Comunicação, Drivers de
Comunicação e Alarmes.
Isto permite que se possa definir como uma Biblioteca um sistema complexo de gerenciamento, que pode ser
facilmente replicado quantas vezes forem necessárias em um aplicativo.
IMPORTANTE
· XControls, XFolders e XObjects só podem se relacionar com o mundo externo através de Propriedades (ou através
do mouse e teclado no caso dos XControls). Isto significa que não se pode acessar dados internos de um
XControl, XFolder ou XObject senão de dentro do próprio objeto.
· A partir da versão 5.0 não é mais permitido inserir Servidores de Alarmes e Configurações do Power em um
XObject, o que era permitido em versões anteriores. Portanto, ao abrir aplicações criadas em versões anteriores
que contenham XObjects com estes objetos, a Verificação de Domínio reporta esta situação como um erro e não
permite a execução destes objetos.
Pode-se inserir XObjects em qualquer Servidor de Dados clicando com o botão direito do mouse no Servidor de
Dados no modo Domínio, selecionado a opção Inserir e logo após o nome do XObject desejado, conforme
mostrado na figura a seguir. No modo Explorer, clique com o botão direito do mouse no Servidor de Dados do
projeto, selecione a opção Inserir e logo após o nome do XObject desejado.
Bibliotecas 278
Inserindo um XObject no modo Domínio
Note que mesmo se os arquivos de Biblioteca possuírem vários XControls, XFolders e XObjects, ao tentar inserir uma
instância (cópia), o Elipse Power Studio exibe para as Telas somente os XControls e para os Servidores de Dados
somente os XFolders e XObjects disponíveis.
NOTA
Deve-se cuidar para não apagar uma Propriedade de um XControl, XFolder ou XObject que possua uma Associação.
Estas Propriedades, uma vez apagadas, não aparecem mais na Lista de Propriedades do objeto, e por isto não
podem ser editadas. Quando se seleciona a opção Verificação de Domínio, é executada uma procura por estas
Propriedades e o usuário é consultado se deseja remover esta Associação ou não.
Propriedade inválida
279 Bibliotecas
Pode-se optar por não remover e então criar novamente o objeto que foi apagado com a Propriedade que se deseja
editar, remover apenas a Propriedade mostrada, remover todas as Propriedades ou não remover nenhuma
Propriedade.
12.3 Quando Criar um ElipseX

O uso de Bibliotecas é altamente recomendável devido ao ganho de produtividade que trazem. Algumas das
vantagens dos ElipseX são as seguintes:
· Reutilização de código
· Minimização de testes durante o desenvolvimento
· Criação de interface padrão para os objetos desenvolvidos
· Diminuição do tempo de desenvolvimento de novos projetos
· Proteção do conteúdo do projeto
· Hierarquização de objetos
Logo, o uso de Bibliotecas é recomendado para a maioria das aplicações. Entretanto, existem alguns critérios para
indicar a necessidade da construção de objetos no Elipse Power:
· Repetição no uso: Se um mesmo equipamento ou processo é usado mais de uma vez no mesmo projeto
· Procedimentos do conhecimento do usuário: Frequentemente, um processo criado por determinada empresa
deve ser protegido de cópia ou alteração. Isto é comum no caso de integradores de serviços ou fabricantes de
máquinas
· Uso de controladores: Um controlador de processo, cujo mapeamento de memória é fixo, pode ser
implementado com todas as funcionalidades disponíveis. A flexibilidade disponível para a construção e uso dos
objetos no Elipse Power permite que sejam utilizadas posteriormente apenas as variáveis de interesse,
desprezando-se as demais
NOTA
Para exemplos de criação de ElipseX e maiores informações sobre estes objetos, consulte o Manual de Referência e
Bibliotecas 280
CAPÍTULO
Importação para Telas
13
Para facilitar a criação de Telas de operação dos objetos do modelo elétrico, o Elipse Power possui uma ferramenta
capaz de importar objetos do modelo elétrico para Telas, o Importador de Objetos para Telas, que associa estes
objetos aos respectivos objetos de dados. Esta ferramenta utiliza um conjunto de bibliotecas gráficas, distribuído
juntamente com o Elipse Power, capaz de interagir com o objeto de dados.
A principal função do Importador de Objetos para Telas é gerar a primeira versão da Tela, pois pequenos ajustes
talvez sejam necessários. Esta ferramenta não implementa funções de sincronização de Telas, portanto uma segunda
importação utilizando uma Tela que já possua objetos pode resultar em dados duplicados.
O acesso a esta ferramenta se dá através do clique com o botão direito do mouse no objeto Configuração do Power,
na opção Modelo Elétrico - Importar para Tela(s). O Assistente de Importação para Telas da figura a seguir é
aberto.
Janela Importação para Telas

Esta janela mostra uma lista de todos os objetos presentes no Modelo Elétrico. É possível selecionar um ou mais itens.
A coluna Tela mostra as Telas que já estão associadas aos objetos de dados listados. Não é possível associar uma
Tela a uma Visualização Esquemática, pois não existe um objeto de dados associado a uma Visualização.
Caso mais de um item seja selecionado para importação, apenas a opção Usar Tela associada ao Objeto de Dados
ou criar automaticamente, se necessário é habilitada. Neste caso, a Tela associada é usada para a importação do
objeto do modelo elétrico, caso ela exista em algum projeto pertencente ao Domínio. Se não existir no Domínio, ou
não haja uma Tela associada, uma nova Tela é criada.
Se apenas um objeto é selecionado para ser importado, é possível especificar uma Tela já existente na aplicação ou
criar uma Tela manualmente, selecionando a opção Especificar Tela e clicando em . A janela da figura a seguir é
aberta.
281 Importação para Telas

Janela Seleção de Tela
Existem ainda outras configurações que podem ser realizadas para a importação para Telas, clicando em
Preferências na janela Importação para Telas. A janela da figura a seguir é aberta.
Janela Preferências de Importação para Telas

Quando a importação é realizada, calcula-se um fator de ajuste para o tamanho dos objetos de Tela, a fim de que
todos caibam na área visível da Tela. Desta forma, se houver uma Subestação muito grande e com muitos objetos que
seja importada para uma Tela pequena, por exemplo, os objetos todos são criados na área visível, porém têm
provavelmente um tamanho bem reduzido em relação ao que se pode ver na definição da biblioteca gráfica. Para esta
situação, as opções da aba Geral descritas a seguir são usadas.
· Não redimensionar a Tela e ajustar o tamanho dos objetos: Não redimensiona a Tela e o tamanho dos objetos
de Tela é ajustado para caber na área da Tela. Esta opção é selecionada por padrão para manter a
compatibilidade com versões anteriores à versão 4.8
Importação para Telas 282

· Permitir aumentar a Tela para manter os objetos com tamanho original: Permite que o objeto seja criado na
Tela com o tamanho original configurado na biblioteca e, para que todos os objetos criados na importação
permaneçam visíveis, a Tela tem o seu tamanho aumentado se necessário, mantendo a sua proporção original
· Permitir aumentar ou diminuir a Tela para manter os objetos com tamanho original: Redimensiona a área da
Tela, mantendo o tamanho original dos objetos de Tela. Caso esta opção seja selecionada e a opção Remover
automaticamente todos os objetos existentes na aba Telas Existentes da janela de preferências não esteja
selecionada, a caixa de diálogo a seguir é mostrada. Caso o usuário clique em Sim, todos os objetos da Tela são
removidos e a importação prossegue. Caso o usuário clique em Não, a importação é interrompida para que o
usuário execute a configuração adequada
Erro na configuração da importação para Telas
NOTAS
· Caso o usuário clique em Sim na caixa de diálogo mostrada na figura anterior, esta opção é usada somente neste
momento e não é guardada na configuração do objeto Configuração do Power, valendo a configuração realizada
pelo usuário na janela Importação para Telas.
· O Elipse Power tem um limite no tamanho da Tela de 524288 unidades Himetric. Se o objeto é muito grande e o
cálculo do tamanho de Tela ultrapassar este limite, a Tela é ajustada até o limite e os objetos ficam menores do
que o tamanho na biblioteca. Este ajuste no tamanho da Tela segue sempre respeitando a proporção entre
largura e altura que a Tela possui.
A opção Sincronizar o objeto de dados correspondente força a sincronização dos objetos de dados selecionados,
garantindo que os objetos de Tela tenham um objeto de dados correspondente. Se a importação é de um objeto do
tipo Contêiner ou Agrupador (Alimentadores, Linhas de Transmissão, Parques Eólicos, Plantas Fotovoltaicas ou
Subestações), esta sincronização é realizada a partir do objeto selecionado e também de todos os seus filhos antes
do início da importação para as Telas. No caso de Visualizações Esquemáticas, a sincronização é parcial, ou seja,
apenas do objeto que está sendo importado no momento (um Disjuntor ou uma Chave especificamente, além do
objeto pai). Neste caso, a sincronização é realizada ao longo da importação para a Tela da Visualização Esquemática.
Em ambos os casos, antes de iniciar o processo de importação, é realizada uma sincronização dos objetos de dados
existentes na aplicação, para garantir que todos os objetos de dados da aplicação ainda possuam um
correspondente válido no modelo elétrico. Aqueles objetos que não possuam um correspondente têm seus IDs
zerados. Para mais informações sobre a opção de sincronização de objetos existentes, veja o tópico Sincronização de
Objetos de Dados Existentes.
NOTA
Se os objetos de dados já tiverem sido importados, aconselha-se selecionar esta opção.
A opção Criar objetos dentro do Grupo permite que todos os objetos de Tela sejam criados dentro de um único
grupo de controles, cujo sufixo é informado nesta opção. Selecionar esta opção desabilita as opções Avisar que a
Tela já possui objetos, Remover automaticamente todos os objetos existentes e Manter os objetos existentes e
renomear os novos, além de habilitar a opção Remover automaticamente objetos do grupo configurado na aba
Telas Existentes, descrita a seguir. Este comportamento permite que, em caso de importações sucessivas, apenas os
objetos criados dentro do grupo indicado sejam removidos automaticamente.
NOTA
A opção Criar objetos dentro do Grupo está desmarcada por padrão para aplicações criadas em versões
anteriores à versão 5.0 e é selecionada por padrão para aplicações criadas na versão 5.0 ou mais recentes.

A opção Trecho transferido deve piscar permite configurar se o Trecho transferido deve piscar ou apenas sinalizar
com a cor deste Trecho transferido em Visualizações Esquemáticas.
A aba Novas Telas permite configurações com relação à criação de novas Telas.
Aba Novas Telas

Nesta aba é possível configurar os seguintes aspectos:
· Prefixo do nome da Tela: Permite selecionar qual o prefixo usado para compor o nome das Telas criadas. Os
nomes das Telas são gerados concatenando o prefixo, que não pode ser vazio, com o nome do objeto
· Ajustar Tela ao Divisor: Permite selecionar um Divisor dentre os existentes na aplicação para que as novas Telas
tenham seu tamanho ajustado em relação a este Divisor
· Cor de fundo da Tela: Permite selecionar o valor da propriedade BackgroundColor das Telas que são criadas
· Destino das Telas de Subestações, Alimentadores e Parques Eólicos/Solares e Destino das Telas de
Visualizações Esquemáticas: Permite selecionar o projeto e a pasta onde as Telas são criadas. Caso a
importação seja de Subestações, Alimentadores, Parques Eólicos ou Solares, é permitido apenas selecionar entre
o projeto do objeto de dados ou o projeto do objeto Configuração do Power. Se a sincronização dos objetos de
dados não foi habilitada, não é permitido fechar esta janela com a opção de criar as Telas no projeto do objeto
de dados selecionado. No caso da importação de Visualizações Esquemáticas, pode-se selecionar entre o projeto
do objeto Configuração do Power ou um projeto específico, que deve pertencer ao Domínio. Em ambos os casos,
se uma pasta é informada, ou um caminho de pastas, elas são criadas caso não existam, sempre a partir da raiz
do projeto selecionado
Caso a Tela utilizada na importação já exista e possua objetos, a importação pode gerar sobreposição. Selecione a
aba Telas Existentes para realizar as configurações relativas à importação para Telas já existentes.

Aba Telas Existentes
Nesta aba é possível configurar os seguintes aspectos:
· Avisar que a Tela já possui objetos: Neste caso é informado através de uma caixa de diálogo de que a Tela
possui objetos e que a importação pode gerar sobreposição de objetos. Os objetos duplicados podem ser
quaisquer objetos inseridos em uma Tela, e não apenas objetos relacionados à importação para Telas do Elipse
Power. Portanto, caso seja selecionada a opção Remover, por exemplo, todos os objetos existentes na Tela são
removidos, independente do tipo de objeto
Aviso de sobreposição de objetos

· Remover automaticamente todos os objetos existentes: Neste caso os objetos são apagados sem qualquer
pedido de confirmação do usuário
· Manter os objetos existentes e renomear os novos: Os objetos são mantidos e, caso seus nomes sejam iguais
aos nomes dos objetos que estão sendo criados, este novos objetos têm seus nomes incrementados
automaticamente
· Remover automaticamente objetos do grupo configurado: Remove automaticamente todos os objetos criados
no grupo indicado na opção Criar objetos dentro do Grupo na aba Geral
Estas configurações são salvas no objeto Configuração do Power. No caso de inconsistências, como por exemplo se o
Divisor selecionado não existe mais ou se o projeto selecionado não pertencer mais ao Domínio, mensagens de erro
são mostradas para informar o usuário. Após concluir as configurações, clique em OK para iniciar a importação.

Caso a opção Sincronizar o objeto de dados correspondente tenha sido selecionada na aba Geral, são verificados
os dados do objeto selecionado. Caso estes dados já tenham sido importados previamente, é apenas executada a
sincronização no objeto. Caso contrário, abre-se a janela de configuração da importação de dados, sendo necessário
executar esta configuração antes de prosseguir com a importação para Telas. Para mais informações sobre as
possíveis configurações do importador de dados, veja o tópico Sincronização de Objetos de Dados.
A aba Bibliotecas permite configurações com relação ao uso da biblioteca gráfica disponível. O padrão é que seja
usada a biblioteca PowerControls.lib da Elipse Software. Porém, caso o usuário deseje, é possível utilizar uma
biblioteca de objetos gráficos personalizados.
Janela Preferências de Importação para Telas

Desmarcando a opção Usar classes padrão da biblioteca PowerControls.lib, é possível editar a lista de objetos e
classes e selecionar individualmente outros XControls para serem utilizados na importação. Todas as configurações
são salvas no objeto Configuração do Power, mesmo aquelas não visíveis.
Para configurar as classes para os objetos, selecione o objeto desejado e clique em . A janela da figura a seguir é
mostrada para a seleção de um novo XControl.
Janela Classes de objetos

Conforme o objeto selecionado, é realizada uma verificação para se ter certeza que o novo XControl selecionado
atende os requisitos mínimos para ser utilizado pela ferramenta de Importação de Objetos para Telas. Para mais
informações, consulte o tópico Personalização de Bibliotecas a seguir.

Todo objeto encontrado no Modelo Elétrico é mapeado para um objeto gráfico correspondente e associado ao
objeto de dados, estando assim pronto para uso. As exceções são o objeto Bay, que não possui representação
gráfica, e o objeto Conector quando representa um jumper, que por ser apenas uma conexão com resistividade
desprezível entre equipamentos, não possui correspondente nos objetos de dados. Desta forma, este objeto de Tela
é associado a um dos terminais do objeto ao qual está conectado, permitindo que possa receber as informações
provenientes dos módulos de Fluxo de Potência e do Processador Topológico.
Também é possível importar objetos diretamente para uma Tela específica, caso necessário. Para isto, clique com o
botão direito do mouse na Tela desejada e selecione a opção Importar do Modelo Elétrico, conforme mostra a
figura a seguir.
Opção Importar do Modelo Elétrico

A Tela deve pertencer ao Domínio, caso contrário esta opção aparece desabilitada. Se não existir o objeto
Configuração do Power no Domínio, se existir mais de um objeto deste tipo ou se o objeto encontrado não possuir
modelo elétrico configurado, o usuário é informado através de mensagens de erro e a importação dos objetos para
Telas é cancelada.
Janela de erro na importação para Telas

Caso se encontre um objeto Configuração do Power que possua um modelo elétrico corretamente configurado, a
janela da figura a seguir é mostrada, permitindo selecionar o objeto a importar.
Janela Importação de Objetos para uma Tela

NOTA
É permitida a seleção de apenas um objeto, que é importado para a Tela de onde a janela foi aberta, não
importando se esta Tela já foi usada para importação de outro objeto e está associada a este objeto. A associação
ao objeto antigo não é desfeita.
Na janela Preferências de Importação para Telas, as configurações relacionadas à biblioteca gráfica podem ser
ajustadas normalmente. Quando esta ferramenta é aberta a partir de uma Tela, a aba Novas Telas não está
disponível.

Preferências de Importação para Telas a partir de uma Tela
Após a configuração do Assistente de Importação de Telas, clique em OK para iniciar a importação. A janela da figura
a seguir mostra o progresso do processo de importação dos objetos.
Janela de progresso da importação de objetos para Telas
13.1 Personalização de Bibliotecas

O Elipse Power disponibiliza objetos gráficos que representam os equipamentos de campo, porém uma
personalização nos objetos existentes, ou até mesmo a criação de novos padrões, também é permitida.
Para isto, é importante conhecer as propriedades que devem fazer parte deste XControl, bem como seu
comportamento. Ao instanciar este objeto em Tela, estas propriedades são responsáveis pelo seu funcionamento
básico, salientando que o Importador de Objetos para Telas já é capaz de criar o objeto e configurar estas
propriedades.
Propriedades de um XControl
PROPRIEDADE TIPO DE DADOS DESCRIÇÃO
SourceObject Tipo de objeto que está sendo Recebe uma Associação para o objeto
criado. Por exemplo, para a criação de dados. Através desta propriedade
de um novo XControl para o XControl tem acesso aos dados,
representar um Disjuntor, o tipo do permitindo executar animações nos
objeto deve ser PowerBreaker terminais e estados, além de acessar
informações de Medidas e Comandos

PROPRIEDADE TIPO DE DADOS DESCRIÇÃO
ShowTerminals Booleano O XControl deve ser programado para
mostrar o número de terminais sempre
que esta propriedade estiver
configurada para Verdadeiro. O objeto
PowerExplorer configura esta
propriedade para Verdadeiro quando
é aberto
Orientation Inteiro O XControl deve ser programado para

ter os seguintes valores:
· 0: Terminal 1 apontando para a
direita
· 1: Terminal 1 apontando para cima
· 2: Terminal 1 apontando para a
esquerda
· 3: Terminal 1 apontando para baixo
ColorMode Inteiro O XControl deve ser programado para

ter os seguintes valores:
· 0: A cor do objeto é definida pela
sua propriedade VoltageColor
· 1: A cor do objeto é definida pela
sua propriedade StrokeColor, que
por sua vez herda o valor da
propriedade StrokeColor da
Subestação ou Alimentador ao qual
pertence
ObjectColor Cor Recebe a cor que o objeto deve ter no

Elipse Power Studio e também uma
Associação que define a cor do objeto
em tempo de execução. Esta cor em
tempo de execução pode aparecer
normal, caso o objeto esteja
energizado, ou mais escura, caso o
objeto não esteja energizado
Além desta configuração, é necessário criar os pontos de conexão (Terminais) com o equipamento. Isto é realizado
com o auxílio da ferramenta Editar Pontos de Conexão. Os pontos de conexão devem ser nomeados como
"TerminalN", onde N é um sufixo iniciando em 1 (um) e que deve ser incrementado até o total de terminais. Esta
configuração é importante para o uso da ferramenta de importação de objetos para Telas do Elipse Power.
Os objetos com apenas um terminal, ou seja, Carga, Carga de Distribuição, Capacitor, Gerador, Reator e
Transformador da Distribuição necessitam das propriedades SourceObject, Orientation e ColorMode, além do ponto
de conexão Terminal1.
Já os objetos Disjuntor, Chave, Chave Fusível, Regulador de Tensão, Religador, Transformador de 2 Enrolamentos e
Transformador de 3 Enrolamentos necessitam das propriedades SourceObject, Orientation, ShowTerminals e
ColorMode, além dos pontos de conexão variando de 2 a 3, conforme o objeto.
O objeto Barra necessita apenas das propriedades SourceObject e ColorMode, não sendo necessário configurar
pontos de conexão.
Na importação de objetos para Telas do Elipse Power, o XControl definido para os objetos Nó e Terminal da Barra é
o mesmo. Este objeto necessita da propriedade ObjectColor e deve-se também criar um terminal de nome
"Terminal1".
O objeto Nó Externo necessita das propriedades SourceObject e ObjectColor, além de criar um terminal de nome
"Terminal1" neste objeto.
Quando a classe selecionada para determinado objeto durante as configurações da ferramenta de importação de
objetos para Telas do Elipse Power não cumpre uma ou mais exigências críticas de propriedades ou terminais, o
processo de importação é interrompido e a mensagem da figura a seguir é mostrada.

Mensagem de erro na seleção de classes inadequadas para importação
No caso de classes selecionadas que não cumprem uma ou mais exigências não críticas de propriedades ou
terminais, o processo de importação não é interrompido, mas a mensagem de aviso da figura a seguir é mostrada.
Mensagem de aviso na seleção de classes inadequadas para importação
NOTA
Selecionar uma classe personalizada que não cumpre uma ou mais exigências não críticas para um equipamento,
quando este equipamento não é utilizado no modelo elétrico atual, não impede o processo de importação.
Em ambos os casos, a janela Preferências de Importação para Telas destaca estas classes, de forma a mostrar quais
classes são inadequadas, conforme a figura a seguir.

Exemplos de classes personalizadas
No exemplo da figura anterior, a classe Breaker tem o mesmo nome da classe padrão para o Disjuntor, mas não tem
as propriedades exigidas, portanto o nome da classe aparece em vermelho. A classe DistributionLoad1 não tem uma
ou mais propriedades exigidas para a Carga de Distribuição, portanto o nome da classe aparece em vermelho e
negrito. Já a classe Cap1 tem todas as propriedades exigidas para o Capacitor, portanto aparece em negrito para
indicar que é uma classe personalizada.

CAPÍTULO
ActiveX
14
Os objetos ActiveX são componentes de software baseados na tecnologia COM (Component Object Model) que
podem ser inseridos em uma aplicação para realizar diversas tarefas. Estes objetos são desenvolvidos em ambientes
de programação tais como C/C++, Delphi e Visual Basic, entre outros.
Alguns objetos ActiveX são automaticamente registrados quando o Elipse Power é instalado: E3Alarm, E3Browser e
E3Chart (desenvolvidos pela Elipse Software), Microsoft Forms (desenvolvidos pela Microsoft) e Relatório
(ActiveReports, desenvolvido pela Data Dynamics). Os objetos E3Alarm, E3Browser, E3Chart e Relatório possuem
capítulos específicos mais adiante neste Manual. Os objetos Microsoft Forms são descritos em outro tópico deste
capítulo.
NOTA
Para objetos ActiveX não instalados previamente pelo Elipse Power, é necessário que estes objetos sejam instalados
em todos os computadores onde a aplicação vai executar, especialmente em Elipse Power Viewers remotos.
Além destes, pode-se inserir qualquer outro objeto ActiveX. Para registrar um objeto ActiveX no Elipse Power, siga
1. Selecione o menu Ferramentas - Gerenciar ActiveX. A janela da figura a seguir é mostrada.
Janela Gerenciar Controles ActiveX

As opções da janela Gerenciar Controles ActiveX estão descritas na tabela a seguir.
Opções da janela Gerenciar Controles ActiveX
OPÇÃO DESCRIÇÃO
Controles registrados no Windows Listagem com todos os controles ActiveX registrados no
Windows e que podem ser adicionados ao Elipse Power
Controles registrados no Elipse Power Listagem com todos os controles ActiveX já registrados
no Elipse Power
Registrar Registra o controle selecionado no Elipse Power. Caso o

controle seja incompatível com o Elipse Power, uma caixa
de diálogo é mostrada avisando o usuário a respeito da
incompatibilidade
293 ActiveX
OPÇÃO DESCRIÇÃO
Remover Remove o controle selecionado da lista Controles
registrados no Elipse Power, movendo-o de volta para a
lista Controles registrados no Windows. Os controles
com o ícone não podem ser removidos, somente os
que tiverem o ícone
Procurar Abre uma caixa de diálogo para localizar um arquivo

ActiveX
Atualizar Permite atualizar os controles ActiveX na listagem

Controles registrados no Windows que tenham sido
registrados após a abertura da janela de gerenciamento
Fechar Fecha a janela de gerenciamento dos ActiveX
2. Clique em Procurar para abrir uma caixa de diálogo e localizar o arquivo que contém o ActiveX.
Localização do arquivo ActiveX

3. Selecione o arquivo desejado e clique em Abrir.
Os objetos ActiveX podem ser de dois tipos: Gráficos (utilizados nas Telas da aplicação) e Não-Gráficos (realizam
algum tipo de manipulação de dados).
Os objetos gráficos podem ser inseridos em uma aplicação das seguintes formas:
· Através da barra de ferramentas da Tela, selecionando o objeto desejado
· Através do clique com o botão direito do mouse no objeto Tela, no Organizer, selecionando a opção Inserir
· Através do clique com o botão direito do mouse em uma Tela, selecionando a opção Inserir
ActiveX 294
Inserindo um objeto gráfico em uma Tela
Os objetos não-gráficos podem ser usados na aplicação através de scripts e são criados pelo método CreateObject,
padrão do VBScript.
14.1 Objetos Microsoft Forms

Para inserir um dos objetos Microsoft Forms previamente registrados no Elipse Power na aplicação, existem duas
opções:
1. Clique com o botão direito do mouse na Tela e selecione a opção Inserir - MSForms.
2. Selecione o objeto desejado na barra de ferramentas da Tela e clique na Tela para estabelecer o ponto inicial do
desenho do objeto, arrastando o mouse diagonalmente até o objeto atingir o tamanho e a posição desejados.
Os objetos da biblioteca Microsoft Forms disponíveis no Elipse Power são descritos nos tópicos seguintes.
14.1.1 Barra de Rolagem

Facilita a navegação através de uma longa lista de itens ou de uma grande quantidade de informação tanto
horizontalmente quanto verticalmente. É inserido na Tela ao selecionar o ícone .
14.1.2 Botão de Comando

Usado para executar ações específicas quando pressionado, tais como abrir uma janela, imprimir um relatório, etc. É
inserido na Tela ao selecionar o ícone .
14.1.3 Botão de Incremento e Decremento

Usado para incrementar ou decrementar valores através de seu par de setas. É inserido na Tela ao selecionar o ícone
.
14.1.4 Botão de Opção

Indica se uma opção está selecionada ou não. Ao contrário da Caixa de Seleção, no entanto, apenas um destes
objetos pode ser selecionado em um grupo; no Elipse Power, este controle deve ser feito manualmente, através de
scripts que configurem a propriedade Value dos demais Botões de Opção para 0 (zero) quando um deles for clicado.
É inserido na Tela ao selecionar o ícone .
14.1.5 Botão Liga e Desliga

Permite atribuir um de dois estados a um outro objeto de Tela. É inserido na Tela ao selecionar o ícone .
295 ActiveX
14.1.6 Caixa de Seleção
Indica se uma determinada opção está selecionada ou não, ou ainda se está parcialmente selecionada. Permite
seleções múltiplas em um grupo. É inserido na Tela ao selecionar o ícone .
14.1.7 Editor de Texto

Possibilita ao usuário inserir e editar textos. É inserido na Tela ao selecionar o ícone .
14.1.8 Lista
Exibe uma lista de itens dentre os quais o usuário pode escolher um ou mais. É inserido na Tela ao selecionar o ícone
.
14.1.9 Lista de Seleção

Combina as funcionalidades de uma Lista e de um Editor de Texto. Neste objeto, pode-se tanto digitar um valor
diretamente ou selecionar um item de uma lista pré-estabelecida. É inserido na Tela ao selecionar o ícone .
14.1.10 Texto
Exibe mensagens de texto que não podem ser editadas pelo usuário, como descrições de controles ou legendas. É
inserido na Tela ao selecionar o ícone .
14.2 Elipse KeyPad

O Elipse KeyPad é um controle ActiveX desenvolvido pela Elipse Software, que permite utilizar um teclado virtual
flutuante em aplicações desenvolvidas com o Elipse Power.
Este controle pode ser ativado no Elipse Power Viewer utilizando a aba Visualizador das propriedades do objeto
Viewer.
Aba Visualizador do Viewer

Opções disponíveis para o Elipse KeyPad na aba Visualizador
OPÇÃO DESCRIÇÃO
Mostrar quando um SetPoint recebe o foco Esta opção mostra o Elipse KeyPad sempre que um
objeto do tipo SetPoint recebe o foco
ActiveX 296
OPÇÃO DESCRIÇÃO
Esconder ao pressionar ENTER Habilita ocultar o Elipse KeyPad ao pressionar a tecla
ENTER. Esta opção equivale à propriedade
AutoHideOnEnter do controle
Esconder ao pressionar ESC Habilita ocultar o Elipse KeyPad ao pressionar a tecla

ESC. Esta opção equivale à propriedade AutoHideOnEsc
do controle
Em scripts, o KeyPad pode ser acionado utilizando-se o método GetKeyPad do objeto Application. Demais
informações sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de
Referência e Scripts do Elipse Power, em seu capítulo respectivo.
297 ActiveX
CAPÍTULO
Servidor de Dados
15
Os Servidores de Dados são os objetos responsáveis por abrigar a execução das variáveis do sistema como Tags
Internos, Tags Demo, Tags Timer, e instâncias de XFolders e XObjects. Para utilizar este recurso, siga este
procedimento:
1. Clique com o botão direito do mouse no projeto no Organizer e selecione a opção Inserir - Servidor de Dados
Em.
Inserindo um Servidor de Dados
NOTA
· Os objetos do Servidor de Dados (Pasta de Dados, Tag Contador, Tag Demo, Tag Interno e Tag Timer) podem ser
configurados para funcionarem como Áreas de Alarme.
· Todas as opções do editor de objetos do Servidor de Dados que estão disponíveis via menu contextual (através
do clique com o botão direito do mouse) também estão disponíveis utilizando o atalho de teclado SHIFT + F10,
que corresponde à tecla de aplicação ou de menu .
· A Janela de Propriedades dos objetos do Servidor de Dados no editor de objetos pode ser aberta utilizando os
atalhos de teclado ALT + ENTER ou ALT + Duplo-clique do mouse.
15.1 Impressora de Linha

A Impressora de Linha é um objeto que permite imprimir diretamente para uma impressora matricial. Para utilizar
este recurso, siga estes procedimentos:
1. Clique com o botão direito do mouse no objeto Servidor de Dados e selecione a opção Inserir - Standard -
Impressora de Linha.
Servidor de Dados 298

Inserindo uma Impressora de Linha
2. Para configurar a Impressora de Linha, clique com o botão direito do mouse no objeto e selecione a opção
Propriedades. A janela da figura a seguir é mostrada.
Aba Geral
299 Servidor de Dados

OPÇÃO DESCRIÇÃO
Usar impressora padrão do Windows Utiliza a impressora padrão do Windows como saída do
objeto Impressora de Linha. Esta opção corresponde à
propriedade UseDefaultPrinter
Escolher uma impressora disponível Permite selecionar uma impressora dentre as

impressoras instaladas no sistema operacional como
saída do objeto Impressora de Linha. A propriedade
PrinterName é configurada com o nome da impressora
selecionada nesta opção
NOTAS
· Caso seja selecionada a opção Escolher uma impressora disponível, mas não seja selecionada nenhuma
impressora na Lista de Seleção correspondente, o objeto Impressora de Linha não permite a impressão e sua
propriedade PrinterStatus é configurada com o valor 0 (zero, psUnknown).
· A impressora padrão do Windows para o usuário atualmente logado pode ser diferente da impressora padrão
utilizada pelo E3 Server. Veja o tópico Impressora para maiores informações.
· O objeto Impressora de Linha pode ser inserido em uma Tela, no Viewer, em uma Pasta do Viewer ou em uma
Pasta de Dados.
Para a impressão, utilize o método Write, passando como argumento a String desejada. Este objeto possui a
propriedade MaxPendingLines, que controla o número máximo de linhas pendentes para impressão. Caso a
chamada do método Write ultrapasse o valor configurado nesta propriedade, este método retorna um erro de script
e a String excedente é descartada.
15.2 Pasta de Dados

A Pasta de Dados define grupos, de forma a organizar as variáveis. Caso haja necessidade, novas Pastas podem ser
inseridas dentro de outras. Para utilizar este recurso, siga este procedimento:
1. Clique com o botão direito do mouse no Servidor de Dados e selecione a opção Inserir - Panel - Pasta de
Dados.

Inserindo uma Pasta de Dados
15.3 Tag Contador

O Tag Contador é um objeto que realiza a contagem de tempo (em segundos) até atingir um valor predeterminado,
ou que realiza uma certa contagem indefinidamente. Para utilizar este recurso, siga estes procedimentos:
1. Clique com o botão direito do mouse no Servidor de Dados e selecione a opção Inserir - Panel - Tag Contador.

Inserindo um Tag Contador
2. O Elipse Power Studio abre uma janela perguntando quantos Tags devem ser criados no servidor, e qual seu
nome. Este nome é autoincrementado e, se a opção é deixada em branco, os Tags são criados com o nome
padrão.
Inserindo Tags Contador

As propriedades do Tag Contador podem ser configuradas através da Lista de Propriedades, sem a necessidade de
devidos ajustes.
15.4 Tag Demo

O Tag Demo é um objeto que gera valores de acordo com a forma de onda, e é utilizado para simulação de valores.
Permite gerar ondas definidas ou valores aleatórios. Para utilizar este recurso, siga estes procedimentos:
1. Clique com o botão direito do mouse no Servidor de Dados e selecione a opção Inserir - Panel - Tag Demo.

Inserindo um Tag Demo
padrão.
Inserindo Tags Demo

As propriedades do Tag Demo podem ser configuradas através da Lista de Propriedades, sem a necessidade de criar
scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de Propriedades e realize os
devidos ajustes.
15.5 Tag Interno

O Tag Interno é um objeto de propósito genérico, utilizado para guardar valores de qualquer tipo, incluindo
números, textos e até outros objetos. Para utilizar este objeto, siga estes procedimentos:
1. Clique com o botão direito do mouse no Servidor de Dados e selecione a opção Inserir - Panel - Tag Interno.

Inserindo um Tag Interno
padrão.
Inserindo Tags Internos

As propriedades do Tag Interno podem ser configuradas através da Lista de Propriedades, sem a necessidade de
devidos ajustes.
15.6 Tag Timer

O Tag Timer é um objeto para contagem de tempo e agendamento de atividades que estabelece horários, com
repetições, para executar ações. Para utilizar este objeto, siga estes procedimentos:
1. Clique com o botão direito do mouse no Servidor de Dados e selecione a opção Inserir - Panel - Tag Timer.

Inserindo um Tag Timer
padrão.
Inserindo Tags Timer

As propriedades do Tag Timer podem ser configuradas através da Lista de Propriedades, sem a necessidade de criar
scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de Propriedades e realize os
devidos ajustes.

CAPÍTULO
Banco de Dados
16
O Banco de Dados do Elipse Power é utilizado para armazenar as informações do projeto referentes a Históricos,
Fórmulas, Alarmes e Storage. Suporta os formatos Access (.mdb), Oracle e Microsoft SQL Server.
Para utilizar este recurso, clique com o botão direito do mouse no nome do projeto no Explorer e selecione a opção
Inserir - Banco de Dados. No modo Domínio, clique com o botão direito do mouse no item Objetos de Servidor -
Banco de Dados, selecione a opção Inserir - Banco de Dados Em e logo após o nome do projeto desejado.
Inserindo um Banco de Dados no modo Domínio

Ao inserir o Banco de Dados na aplicação, são habilitadas as opções referentes ao tipo de Servidor de Banco de
Dados, através da aba Configuração na Janela de Propriedades, ou da propriedade SourceType, na Lista de
Propriedades.
Algumas das propriedades deste objeto podem ser configuradas através da Lista de Propriedades, sem a
necessidade da criação de scripts para isto. Para isto, localize-as e efetue os devidos ajustes. Demais informações
sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referência e Scripts
do Elipse Power, no capítulo respectivo.
NOTA
O objeto Banco de Dados pode ser configurado para funcionar como Área de Alarme.
16.1 Access
Gera uma base de dados no formato MDB (Microsoft Access Database), padrão para banco de dados no Elipse Power.
1. Clique com o botão direito do mouse no nome do projeto no Explorer e selecione a opção Inserir - Banco de
Dados. No modo Domínio, clique com o botão direito do mouse no item Objetos de Servidor - Banco de
Dados, selecione a opção Inserir Banco de Dados Em e logo após o nome do projeto desejado. O objeto é
criado no projeto, e sua janela de edição de scripts é aberta.
2. Para configurá-lo, selecione a aba Configurações da Janela de Propriedades.
Banco de Dados 306

Configurações para Banco de Dados Access
OPÇÃO DESCRIÇÃO
Banco de Dados Seleciona o tipo de Banco de Dados em uso no projeto.
Os valores possíveis para esta opção são 0: stAccess, 1:
stOracle ou 2: stSqlServer
Arquivo MDB Nome do arquivo .mdb utilizado no projeto. NOTA: Este

campo aceita tanto um caminho absoluto quanto um
caminho relativo à pasta do Domínio atual. O caminho
completo deve existir para que o arquivo .mdb seja
criado ou encontrado corretamente
Senha do BD Senha do Banco de Dados Access
Usuário Usuário do Banco de Dados conectado pelo Elipse

Power
Senha Senha do usuário que realiza o logon
Testar Conexão Testa a conexão com o Banco de Dados
3. No campo Banco de Dados, selecione o item 0 - stAccess.

4. Insira o nome do arquivo desejado, existente ou não, no campo Arquivo MDB, conforme a figura anterior.
5. Caso seja necessário, configure as opções Usuário, Senha e Senha do BD de acordo com as definições do
Access. Tais itens podem ser deixados em branco e, neste caso, a aplicação assume as configurações padrão do
Elipse Power.
6. Clique em OK para finalizar as configurações.
307 Banco de Dados

16.2 Oracle
A utilização do Oracle como servidor de Banco de Dados do Elipse Power só é possível através da instalação de um
servidor ou cliente Oracle na máquina onde é executado o E3 Server. Nesta instalação devem estar presentes,
obrigatoriamente, o suporte a OCI (Oracle Call Interface) e o OLEDB Provider para Oracle, necessários para a
comunicação do Elipse Power com o Oracle. Para instalar o Oracle, consulte a documentação própria do produto.
O acesso ao banco de dados Oracle pode ser realizado de duas maneiras, acessando o Banco de Dados Oracle de
dentro do Elipse Power ou via scripts. A seguir são explicados cada um destes procedimentos.
16.2.1 Acessando o Oracle via Elipse Power

Para inserir um novo Banco de Dados Oracle, siga estes procedimentos:
Dados, selecione a opção Inserir Banco de Dados Em e logo após o nome do projeto desejado. O objeto é
criado no projeto e a janela de edição de scripts é aberta.
2. Para configurá-lo, selecione a aba Configuração na Janela de Propriedades.
Configurações para Banco de Dados Oracle

OPÇÃO DESCRIÇÃO
Conexão Permite selecionar uma conexão local, se disponível, ou

digitar o nome de uma conexão fornecido pelo
administrador do banco de dados
Banco de Dados 308

OPÇÃO DESCRIÇÃO
Usar drivers ADO Oracle Permite usar as interfaces ADO (ActiveX Data Objects) do
Oracle para que o objeto Consulta do Elipse Power
reconheça o tipo de dados TIMESTAMP, habilitado na
opção Usar tipo TIMESTAMP. Assim é possível ler
registros de tabelas do Oracle que possuam precisão de
milissegundos. Consulte a nota a seguir para mais
informações sobre esta opção
Usar tipo TIMESTAMP Permite utilizar o tipo de dados TIMESTAMP do Oracle,

com precisão de milissegundos e disponível a partir da
versão 9.0. Caso esta opção esteja desabilitada, usa-se o
tipo de dados DATE, com precisão de segundos.
Consulte a nota a seguir para mais informações sobre
esta opção
Usuário Usuário do Banco de Dados conectado pelo Elipse

Power
NOTAS
· Desmarcar a opção Usar drivers ADO Oracle automaticamente desmarca a opção Usar tipo TIMESTAMP.
· Aplicações criadas em versões anteriores à versão 5.0, quando executadas na versão 5.0 ou superior ou ao
carregar um objeto Banco de Dados no Elipse Power Studio, automaticamente selecionam a opção Usar drivers
ADO Oracle se a opção Usar tipo TIMESTAMP estiver selecionada.
· No caso do Elipse Power Studio, o usuário é perguntado se deseja salvar esta alteração.
· No caso da execução da aplicação, a alteração persiste apenas durante a execução, retornando ao estado anterior
até que o usuário salve esta alteração.
3. No campo Banco de Dados, selecione o item 1 - stOracle.

4. Se o servidor Oracle é local, o campo Conexão pode permanecer em branco, pois o Elipse Power recupera os
dados automaticamente. Do contrário, a conexão é criada usando o cliente Oracle instalado na máquina.
5. Caso seja necessário, configure as opções Usuário e Senha de acordo com as definições do Oracle. Tais itens
podem permanecer em branco e, neste caso, a aplicação assume as configurações padrão do Elipse Power.
Ao inserir o Banco de Dados na aplicação, são habilitadas as opções referentes ao tipo de Servidor de Banco de
Dados. O Servidor de Banco de Dados é o responsável pelo gerenciamento e armazenamento das informações dos
objetos que utilizam este serviço.
16.2.2 Acessando o Oracle via Scripts

Scripts são módulos de linguagem de programação onde se pode criar linhas de código, que permitem maior
flexibilidade para a associação de ações a eventos específicos. Cada item de um projeto do Elipse Power possui uma
lista de eventos previamente associados. Assim, o usuário pode criar programas que são executados na ocorrência de
um evento.
O Elipse Power utiliza o VBScript (Visual Basic Script) em seus scripts, e assim é possível instanciar qualquer objeto
ActiveX registrado no sistema operacional. Para o acesso ao Banco de Dados, o ActiveX mais utilizado é o ADO, que
pode ser facilmente manipulado nos scripts do Elipse Power.
1. Primeiro é preciso criar uma conexão ADO, que pode ser realizada com o script a seguir.
Set DBConnection = CreateObject("ADODB.Connection")
DBConnection.Open "Provider=MSDAORA;_
DataSource=conexaoOracle;User_
ID=UserID;Password=passwd"
2. Depois de criada a conexão, é possível executar um comando SQL diretamente na conexão, como mostrado a
seguir.
309 Banco de Dados

DBConnection.Execute _
"UPDATE Tabela SET nome = 'João' WHERE id = 10"
3. É possível também a visualização de todos os registros desejados, retornados na forma de um Recordset

(consulta), como mostrado a seguir.
Set Recordset = CreateObject("ADODB.Recordset")
Recordset.Source = "Tabela"
Recordset.ActiveConnection = DbConnection
Recordset.CursorType = 1 ' adOpenKeyset
Recordset.LockType = 3 ' adLockOptimistic
Recordset.Open
4. A partir deste momento, é possível navegar pela tabela utilizando-se os comandos MoveNext e MovePrevious, bem
como uma série de outros comandos fornecidos pelo ADO. É possível também utilizar uma consulta SQL para
manipular partes específicas da tabela, através da propriedade Source.
16.2.3 Tecnologias Utilizadas pelo Elipse Power para Acessar o Oracle

O Elipse Power utiliza basicamente duas tecnologias para acessar o Banco de Dados Oracle, ADO (ActiveX Data
Object) e OCI (Oracle Call Interface).
ADO é a tecnologia utilizada pelo E3Browser e E3Chart para recuperação dos dados armazenados no Banco de
Dados. O ADO também é amplamente utilizado nos scripts do Elipse Power para todo tipo de operação junto a um
Banco de Dados. Esta tecnologia é um conjunto de objetos COM (Component Object Model) criado para acessar
informações de SGBDs (Sistemas Gerenciadores de Bancos de Dados) usando OLE DB (Object Linking and Embedding), está
disponível quando se instala o OLE DB Provider para Oracle (MSDAORA) e permite o acesso à interface nativa do
Oracle, a OCI.
A OCI é utilizada pelo Servidor de Banco de Dados do Elipse Power para implementar os serviços de Banco de Dados
utilizados pelos Históricos, Fórmulas, Alarmes e Storage. Através da OCI se acessa diretamente as funções do Oracle,
tornando este processo o mais otimizado possível. Esta tecnologia fornece uma biblioteca padrão de acesso ao
Banco de Dados e funções de recuperação de dados na forma de uma DLL ou LIB, que pode ser conectada a uma
aplicação em tempo de execução.
16.2.4 Acessando o Oracle via Servidor BD

O Servidor de Banco de Dados do Elipse Power utiliza a OCI (Oracle Call Interface) para se comunicar com o servidor
Oracle, ou seja, utiliza a forma nativa do Banco de Dados para ganhar em performance na comunicação com o Banco
de Dados.
Um bom exemplo de como funciona a comunicação do Servidor de Banco de Dados do Elipse Power com o Oracle é
o Histórico. Inicialmente é realizada a aquisição dos dados pelo Histórico que, de posse destes dados, imediatamente
os envia em forma de requisições para o Banco de Dados. Estas requisições podem ser para criação de uma tabela,
criação de índices e chaves, adição de dados, etc. O Servidor de Banco de Dados do Elipse Power possui um
processo separado especialmente para recebê-las. Dependendo do tipo de operação a ser realizada, os dados são
formatados e armazenados em arquivos temporários ou em memória.
Ao mesmo tempo, o Banco de Dados possui mais um outro processo, responsável pela recuperação das aquisições e
posterior envio para o banco de dados em forma de comandos SQL, utilizando a OCI.
Banco de Dados 310

Comunicação do Elipse Power com o Oracle
16.3 SQL Server

Através desta opção é possível armazenar dados no Banco de Dados SQL Server.
16.3.1 Acessando o SQL Server via Elipse Power

Para inserir um novo Banco de Dados SQL Server, siga estes procedimentos:
Dados, selecione a opção Inserir Banco de Dados Em e selecione o nome do projeto. O objeto é criado no
projeto e a janela de edição de scripts é aberta.
2. Para configurá-lo, selecione a aba Configuração na Janela de Propriedades.
311 Banco de Dados

Configurações para o Banco de Dados SQL Server
OPÇÃO DESCRIÇÃO
Servidor Nome do servidor
Banco de Dados Nome do Banco de Dados
Biblioteca de Rede Biblioteca de rede utilizada pelo ADO. Os valores possíveis

para esta opção são 0: Padrão, 1: Named Pipes, 2:
Winsock TCP/IP, 3: SPX/IPX, 4: Banyan Vines ou 5: Multi-
Protocol (RCP)
Provedor Seleciona um provedor de dados OLE DB para acesso ao

servidor SQL Server. Os valores possíveis para esta opção
são 1: SQLOLEDB ou 2: MSOLEDBSQL (padrão). Consulte a
nota a seguir para mais informações sobre esta opção
Alterar string de conexão Esta caixa de seleção permite modificar a String de

conexão a um banco de dados SQL Server. As seguintes
restrições se aplicam a esta opção:
· As alterações realizadas NÃO SÃO validadas pelo
Elipse Power. Portanto, é de inteira responsabilidade
do usuário a correta configuração da String
personalizada
· Se esta caixa de seleção está desmarcada, o Elipse
Power utiliza o formato padrão para realizar a conexão
Banco de Dados 312

OPÇÃO DESCRIÇÃO
· A String de conexão aceita as macros {SERVER}, que é
substituída pelo nome do servidor configurado na
opção Servidor, e {DB}, que é substituída pelo nome do
banco de dados configurado na opção Banco de
Dados
Usuário Usuário do Banco de Dados conectado pelo Elipse Power.

Dependendo do tipo de objeto a ser utilizado no projeto,
deve ter diferentes tipos de permissão
NOTA
A opção de provedor de dados SQLOLEDB foi descontinuada pela Microsoft e não deve ser utilizada. Entretanto,
aplicações criadas em versões anteriores à versão 6.0 continuam funcionando normalmente. No caso de uma
atualização destas aplicações para a versão 6.0, o Elipse Power adiciona automaticamente à String de conexão o
parâmetro de compatibilidade "DataTypeCompatibility=80".
3. No campo Banco de Dados, selecione o item 2 - stSqlServer.

4. Caso seja necessário, configure as opções Usuário e Senha de acordo com as definições do SQL Server. Tais itens
podem permanecer em branco e, neste caso, a aplicação assume as configurações padrão do Elipse Power.
16.3.2 Exemplo de Utilização do SQL Server

Para ilustrar o acesso ao SQL Server, criaremos um Histórico registrando dados por tempo de varredura de um
segundo. Os procedimentos são mostrados a seguir.
1. Crie um Tag Demo. As configurações deste Tag não necessitam ser alteradas.
2. Clique duas vezes no Servidor de Banco de Dados para abrir a janela de configuração do servidor SQL. Os
parâmetros devem ser alterados para se adequarem às configurações disponíveis na instalação do SQL Server.
3. Execute as configurações necessárias nesta janela, tais como nome do servidor, usuário, senha e banco de dados.
4. Após executar a configuração do banco de dados, configure o Histórico que acessa este banco de dados. Para
isto, crie um Campo no Histórico e insira o Tag Demo criado anteriormente, que é utilizado para o envio de
diferentes valores ao banco de dados.
Um objeto Histórico e suas configurações

5. Abra a Janela de Propriedades do Histórico e determine o servidor de banco de dados e o nome da tabela. As
demais configurações devem permanecer inalteradas. A tabela serve para a busca de dados no Elipse Power e
também para visualizar o uso do SQL Server Management Studio, que é o cliente usado para consultas no SQL
Server.
6. Finalizada a configuração do Histórico, é necessária a criação da estrutura de tabelas no servidor de banco de
dados. Para isto, clique em Gerar estrutura no BD . Uma mensagem de confirmação da criação da estrutura de
tabelas é mostrada na tela. Caso haja algum erro, deve-se localizar o problema.
7. Para visualizar o Histórico em ação, salvando dados no servidor SQL Server, crie uma Tela, insira um E3Browser e
configure-o para acessar o servidor de banco de dados, como explicado anteriormente no Histórico, e configure
o E3Browser para ser atualizado automaticamente a cada 10 segundos, por exemplo.
313 Banco de Dados

8. Após as configurações, execute o projeto. Depois de algum tempo, o E3Browser passa a exibir os dados que
estão sendo enviados ao servidor.
9. É possível consolidar os dados que são mostrados no Elipse Power e os que estão salvos no servidor utilizando
o objeto Consulta do E3Browser e o SQL Server Management Studio. Para isto, crie diferentes consultas no
banco de dados e edite-as na Consulta e também no SQL Server Management Studio. Os resultados devem ser
os mesmos se o Domínio estiver parado, ou semelhantes se o Domínio estiver executando. Esta diferença deve-se
à atualização constante do banco de dados quando o Domínio está em execução. Para a edição de consultas no
objeto Consulta, habilite a opção Habilita edição direta do SQL na aba SQL.
16.3.3 Uso de ADODB para Acesso via Script

Para acesso ao SQL Server através de scripts, usa-se uma conexão ADODB. A String de conexão a este tipo de Banco
de Dados deve ser configurada conforme o modelo a seguir.
DRIVER={SQL Server};SERVER=server;UID=login_id;PWD=password;
O uso deste tipo de acesso deve ser restrito a casos onde não exista outra solução. O Elipse Power disponibiliza
recursos que visam minimizar o uso destes acessos via script. Entretanto, eventualmente o uso deste recurso pode ser
necessário.
16.4 Objetos do Elipse Power e Permissões

É necessário configurar as permissões no Banco de Dados para a utilização dos objetos do Elipse Power em um
projeto. Estas permissões estão listadas na tabela a seguir.
Opções disponíveis para permissões
OBJETO PERMISSÃO
Fórmulas Permissão completa
Histórico de usuário Escrita e consulta às tabelas existentes
Histórico Permissão completa
Storage Permissão completa
Servidor de Alarmes Permissão completa
Nas permissões, a expressão Permissão completa significa que o usuário tem permissões para:
· Criar ou remover tabelas existentes
· Criar índices e chaves
· Criar e executar procedimentos armazenados (stored procedures) e funções
· Inserir e excluir dados nas tabelas criadas
· Realizar consultas sobre as tabelas resultantes
O usuário não precisa ser um Administrador para possuir Permissão completa em qualquer objeto.
Banco de Dados 314

CAPÍTULO
Consultas
17
O objeto Consulta (ou Query) auxilia no processo de definição de consultas no Banco de Dados de uma aplicação.
Toda vez que os objetos E3Browser ou Relatório buscam dados de um Banco de Dados, é necessário enviar um
comando, de forma que se saiba quais os dados desejados para aquele objeto. Logo, toda vez que uma aplicação
precisa gravar ou buscar dados armazenados em um Banco de Dados, são enviados comandos no formato SQL
(Structured Query Language). A Consulta apresenta uma interface amigável, que permite a construção das consultas de
forma gráfica 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 é responsável por criar o texto que executa o filtro ou a consulta, não sendo necessário para
o usuário saber detalhes, tais como a data. Para utilizar este recurso, siga estes procedimentos:
1. Clique com o botão direito do mouse em uma Tela do projeto e selecione a opção Inserir - Standard - Consulta.
NOTA
Quando é criado um objeto Relatório ou E3Browser, o objeto Consulta é adicionado automaticamente a estes
objetos. No entanto, também pode-se inserir este objeto em uma Pasta de Dados, em uma Tela, em um Viewer ou
em uma Pasta do Viewer. Para mais detalhes, consulte os capítulos correspondentes.
2. Antes de definir a Consulta, deve-se informar em qual Servidor de Banco de Dados esta Consulta busca os dados.
Para isto, selecione o servidor na caixa de listagem Nome do Servidor.
Definição do Servidor Banco de Dados

A configuração da Consulta depende do objeto ao qual ela está relacionada.
315 Consultas
Configurações da Consulta
Para verificar quais as configurações necessárias da Consulta, veja os capítulos Relatórios e E3Browser.
Algumas das propriedades da Consulta podem ser configuradas através da Lista de Propriedades, sem a necessidade
de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de Propriedades e faça os
devidos ajustes. Para maiores informações, consulte o Manual de Referência e Scripts do Elipse Power.
17.1 Criando uma Consulta

Quando um E3Browser ou um Relatório é criado no projeto, uma Consulta é automaticamente inserida como objeto
filho, com o nome "Consulta1". Para utilizar este recurso, siga estes procedimentos:
1. Ao clicar com o botão direito do mouse na Consulta e selecionar o item Configurar, a janela da figura a seguir é
mostrada solicitando a identificação do Servidor de Banco de Dados da aplicação.
Definição do Servidor Banco de Dados na Consulta

2. Após ser definido o servidor Banco de Dados, uma nova janela é mostrada com tabelas que foram encontradas
no Banco de Dados, permitindo a seleção.
Consultas 316
Adição de tabela
3. Selecione as tabelas que fazem parte da consulta e clique em OK.
4. Depois de definidas as tabelas, a janela de definição da Consulta é mostrada, contendo as abas Campos,
Variáveis, Visualizar e SQL, conforme a figura a seguir.
Configuração da Consulta
Estas abas estão descritas nos tópicos a seguir.
17.1.1 Aba Campos

Esta aba mostra todos os campos das tabelas usadas na Consulta. Ao clicar em , é possível selecionar outras
tabelas para a Consulta.
317 Consultas
Inserindo uma tabela
Para selecionar todos os campos da tabela para uma Consulta, selecione o primeiro item da lista de seleção,
correspondente ao caractere de asterisco (*). Para adicionar um campo específico, selecione a caixa de seleção
correspondente.
Selecionando campos
de uma tabela
Devido à questões de performance, é importante adicionar à Consulta somente campos que realmente interessam
para a análise.
Na área de colunas, os campos escolhidos são mostrados conforme a figura a seguir.
Consultas 318
Área de colunas
Cada coluna mostra propriedades para cada campo da tabela ou tabelas selecionadas, conforme a tabela a seguir.
Opções disponíveis para a configuração de colunas
OPÇÃO DESCRIÇÃO
Colunas Mostra o nome das colunas selecionadas. Ao clicar na
caixa de combinação de cada linha, pode-se redefinir a
coluna desejada
Título Permite que um novo nome seja definido para a coluna,

também conhecido como alias
Tabela Mostra o nome da tabela de origem do campo
Mostrar Habilita ou desabilita o campo
Ordenação Permite ordenar os valores. Os valores possíveis são

Sem ordenação, Ascendente (valores menores primeiro)
ou Descendente (valores maiores primeiro)
Ordem Define a prioridade quando mais de um campo possui

ordenação
Agrupado por Permite que os dados sejam agrupados a cada novo

valor do campo
Função Permite definir a execução de uma função para o campo
Filtro Define um critério de consulta, como por exemplo

intervalos de data
Ao definir um filtro, a janela da figura a seguir é mostrada, permitindo que se defina o tipo de comparação e o valor a
ser comparado.
319 Consultas
Janela Definição de Filtro
O tipo de dados de comparação pode ser definido ao clicar na caixa de seleção correspondente e selecionar um dos
tipos de dados na lista de opções.
Configurações para o tipo de dados

O valor de comparação pode ser uma constante, como por exemplo 123, 45, ou "ABCD", ou ainda uma variável
definida pelo usuário. Para criar uma variável, informe um nome de variável qualquer usando um dos formatos a
seguir.
· <% %> se o valor é numérico
· '<% %>' se o valor é uma String
· #<% %># se o valor é uma data
O valor de uma variável pode ser definido na aba Variáveis ou através de um script usando o método
SetVariableValue.
17.1.2 Aba Variáveis

Esta aba permite definir valores padrão para variáveis definidas pelo usuário. Estas variáveis também podem ter o
valor alterado em tempo de execução utilizando o método SetVariableValue.
Consultas 320
Aba Variáveis
As colunas desta aba são descritas na tabela a seguir.
Opções disponíveis na aba Variáveis
OPÇÃO DESCRIÇÃO
Nome O nome da variável definida pelo usuário
Valor Uma caixa de seleção onde o valor do tipo de dados

pode ser selecionado. As opções disponíveis são Empty,
NULL, Boolean, Char, Byte, Integer, Word, Long,
Dword, Currency, Single, Double, Date, Decimal ou
String
17.1.3 Aba Visualizar

Esta aba mostra uma prévia dos resultados da Consulta ao clicar em . Também é possível limitar o número máximo
de registros retornados, permitindo agilizar a consulta.
321 Consultas
Aba Visualizar
17.1.4 Aba SQL

Nesta aba é exibida a sintaxe SQL resultante da configuração realizada nas abas Campos e Variáveis. Pode-se editar
diretamente a consulta, selecionando a opção Habilita edição direta do SQL.
Aba SQL
Ao desmarcar a opção Habilita edição direta do SQL, todas as alterações são perdidas e a Consulta retorna às
opções selecionadas nas abas Campos, Variáveis e Visualizar.
Consultas 322
Aviso ao desabilitar a edição direta do SQL
17.2 Uso dos Filtros da Consulta através de Scripts

Configurar e confirmar se uma Consulta está correta é apenas um dos passos para usá-la. O uso em tempo de
execução e as modificações de valores dos filtros definidos para a Consulta podem ser vistos no script a seguir. O
método SetVariableValue é o responsável pela configuração da Consulta, conforme os valores passados via script.
Set consulta = Screen.Item("E3Browser1").Item("Consulta1")
Consulta.SetVariableValue "DataIni", _
Application.GetObject("DadosFH.TagInterno1").Value
Consulta.SetVariableValue "DataFim", _
Application.GetObject("DadosFH.TagInterno2").Value
Screen.Item("E3Browser1").Requery()
O método Requery possibilita que os novos parâmetros de Consulta sejam realmente utilizados, visto que uma nova
Consulta é executada respeitando estes novos valores.
17.3 Uso de Recordsets de uma Consulta através de Scripts

Um outro uso interessante da Consulta é trabalhar com Recordsets. Depois de executada uma Consulta, é possível
capturar o Recordset correspondente e trabalhar com registros linha a linha ou executar novas Consultas, por
exemplo. Na linha de comando a seguir:
RS = TelaInicial.E3Browser1.Consulta1.GetADORecordset()
A variável RS assume todas as características de um Recordset. A vantagem do uso deste recurso é que ao modificar
as propriedades do banco de dados, não é necessário ajustar cada um dos scripts que acessam este banco de
dados.
323 Consultas
CAPÍTULO
Alarmes
18
O Elipse Power dispõe de um conjunto de objetos que permite ao usuário monitorar alarmes em uma aplicação. Com
estes objetos é possível especificar e gerenciar alarmes e eventos de variáveis de um processo. As condições de
alarme podem ser gerenciadas em diversas fontes. O sistema é composto de um objeto centralizador de alarmes,
chamado Servidor de Alarmes, e de um ou mais objetos de configuração, chamado Configuração de Alarmes. Os
tópicos a seguir detalham estes objetos.
18.1 Configuração de Alarmes

O objeto Configuração de Alarmes é o local onde as Áreas são inseridas e organizadas. Para inserir este objeto em
um projeto, siga este procedimento:
Configuração de Alarmes Em. No modo Domínio, clique com o botão direito do mouse no item Objetos de
Servidor - Alarmes, selecione a opção Inserir Configuração de Alarmes Em e logo após o nome do projeto.
Inserindo um objeto Configuração de Alarmes
NOTAS
· Todas as opções do editor de objetos da Configuração de Alarmes e das Áreas de Alarme que estão disponíveis
via menu contextual, através do clique com o botão direito do mouse, também estão disponíveis utilizando o
atalho de teclado SHIFT + F10, que corresponde à tecla de aplicação ou de menu .
· A Janela de Propriedades dos objetos da Configuração de Alarmes e das Áreas de Alarme no editor de objetos
pode ser aberta utilizando os atalhos de teclado ALT + ENTER ou ALT + Duplo-clique do mouse.
18.1.1 Áreas de Alarme

As Áreas de Alarme permitem agrupar um conjunto de Fontes de Alarmes, bem como outras Áreas. Isto facilita o
gerenciamento, a operação e o monitoramento de um conjunto de Fontes de Alarme relacionadas, como por
exemplo:
· Filtrar o conjunto de alarmes visíveis no sumário
· Habilitar ou desabilitar um conjunto de Fontes de Alarmes
Alarmes 324
· Reconhecer um conjunto de Fontes de Alarmes
· Verificar o total de alarmes ativos ou não reconhecidos de um conjunto de Fontes de Alarmes
Caso haja necessidade, novas Áreas podem ser inseridas dentro de outras. Para inserir este objeto, siga este
procedimento:
1. Clique com o botão direito do mouse no objeto Configuração de Alarmes ou no objeto Área do projeto no modo
Explorer e selecione a opção Inserir - Área. No modo Domínio, clique com o botão direito do mouse no objeto
Configuração de Alarmes e selecione o item Inserir - Área.
Inserindo uma Área de Alarme

Propriedades e execute os devidos ajustes. Demais informações sobre as funcionalidades das propriedades deste
objeto podem ser encontradas no Manual de Referência e Scripts do Elipse Power, em seu capítulo respectivo.
18.1.1.1 Objetos de Servidor como Áreas de Alarme

Objetos de Servidor têm a possibilidade de se comportarem como Áreas de Alarme. Estes objetos possuem uma aba
adicional, Área de Alarmes, onde este comportamento pode ser habilitado e configurado. A figura a seguir mostra
esta aba em um Driver de Comunicação.
325 Alarmes
Aba Área de Alarmes
Opções disponíveis na aba Área de Alarmes
OPÇÃO DESCRIÇÃO
Funcionar como área de alarmes Habilita ou desabilita o comportamento de Área de
Alarme para o objeto de Servidor. Esta opção
corresponde à propriedade IsAlarmArea
Verificar alarmes Habilita ou desabilita a verificação de alarmes no objeto.

Esta opção corresponde à propriedade AlarmVerify
Campos do usuário Consulte o tópico Configurações dos Campos do

Usuário para mais informações
Demais informações sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de
Referência e Scripts do Elipse Power, em seu capítulo respectivo.
18.2 Filtro de Alarmes

O objeto Filtro de Alarmes permite especificar filtros de alarmes da mesma forma que o E3Alarm, exceto que não
possui uma representação gráfica que possa ser mostrada em Tela. Ao invés disto, o resultado da filtragem pode ser
consumido através dos diversos contadores de alarmes ou da coleção de eventos.
NOTAS
· O objeto Filtro de Alarmes pode ser inserido em uma Tela, no Viewer, em uma Pasta do Viewer ou em uma Pasta
de Dados.
· Não é possível reconhecer alarmes utilizando o objeto Filtro de Alarmes.
Para inserir este objeto em uma Tela, por exemplo, siga este procedimento:
1. Clique com o botão direito do mouse em uma Tela e selecione a opção Inserir - Standard - Filtro de Alarmes.
Alarmes 326
Opção Inserir - Standard - Filtro de Alarmes
Propriedades e execute os devidos ajustes.
Para configurar um Filtro de Alarmes, clique com o botão direito do mouse no objeto e selecione a opção
Propriedades.
327 Alarmes
18.2.1.1 Aba Conexões
A aba Conexões permite gerenciar as conexões do Filtro de Alarmes com Servidores de Alarmes locais ou remotos.
Aba Conexões
Opções disponíveis na aba Conexões
OPÇÃO DESCRIÇÃO
Adicionar Conexão Adiciona uma nova Conexão ao Filtro de Alarmes. Esta
opção corresponde ao método Add da Coleção de
Conexões
Remover Conexão Remove a Conexão selecionada. Esta opção corresponde

ao método Remove da Coleção de Conexões. NOTA: A
Conexão criada automaticamente com o objeto não pode
ser removida
Nome conexão Nome desta Conexão. Pressione a tecla F2 para editar

este nome. Esta opção corresponde à propriedade
ConnectionName do objeto Conexão na Coleção de
Conexões
Nome servidor Nome amigável para identificar o Domínio do Servidor

de Alarmes selecionado. Esta opção corresponde à
propriedade DomainName do objeto Conexão na
Coleção de Conexões
Servidor de Alarmes Nome do Servidor de Alarmes, que tanto pode estar em

um Domínio local quanto em um Domínio Remoto. Esta
opção corresponde à propriedade AlarmServer do
objeto Conexão na Coleção de Conexões. Clique em
para selecionar um Servidor de Alarmes utilizando o
AppBrowser
Filtro conexão Nome de um Filtro que contém a configuração do filtro

de alarmes, definido na aba Filtros. Esta opção
corresponde à propriedade FilterConnection do objeto
Conexão na Coleção de Conexões
Alarmes 328
18.2.1.2 Aba Filtros
A aba Filtros permite gerenciar os filtros do Filtro de Alarmes.
Aba Filtros
OPÇÃO DESCRIÇÃO
Filtros Caixa de seleção com os Filtros atualmente disponíveis
Configurar Abre a janela de configuração do Filtro selecionado,

descrita a seguir
Adicionar Adiciona um novo Filtro à Coleção de Filtros. Esta opção

corresponde ao método Add da Coleção de Filtros
Remover Remove o Filtro selecionado. Esta opção corresponde ao

método Remove da Coleção de Filtros. NOTA: O Filtro
criado automaticamente com o objeto não pode ser
removido
Ao clicar em Configurar, a janela da figura a seguir é aberta para configuração do Filtro selecionado.
329 Alarmes
Propriedades do Filtro selecionado
Opções disponíveis na janela de propriedades de um Filtro
OPÇÃO DESCRIÇÃO
Nome Nome deste Filtro. Esta opção corresponde à
propriedade FilterName do objeto Filtro da Coleção de
Filtros
Filtrar por Área de Alarme Determina o filtro por Área de Alarme. Caso deseje
utilizar algum filtro, especifique-o nesta opção, senão
deixe-a em branco. Esta opção equivale à propriedade
AreaFilter do objeto Filtro da Coleção de Filtros
Filtro de Área Simples Se a opção Filtrar por Área de Alarme não estiver em
branco, esta opção é habilitada e, se estiver selecionada,
a filtragem por Área é baseada apenas na coincidência
da parte inicial do nome. Caso contrário, considera o
nome completo da Área. Esta opção equivale à
propriedade SimpleAreaFilter do objeto Filtro da
Coleção de Filtros
Utilizar filtro customizado Permite informar um filtro personalizado para os

alarmes. Esta opção corresponde à propriedade
CustomFilter do objeto Filtro da Coleção de Filtros
Filtro não sensível à acentuação Se a opção Utilizar filtro customizado não estiver em
branco, esta opção é habilitada e, se estiver selecionada,
ignora caracteres acentuados na expressão daquele filtro
personalizado, Caso contrário, os caracteres acentuados
são considerados na busca. Esta opção corresponde à
propriedade IgnoreDiacritics do objeto Filtro da
Coleção de Filtros
Filtrar por tipo Habilita o tipo de filtro que é aplicado no alarme. As

opções disponíveis são Apenas alarmes, Apenas
eventos ou Alarmes e Eventos. Esta opção equivale à
propriedade FilterType do objeto Filtro da Coleção de
Filtros
Alarmes 330
OPÇÃO DESCRIÇÃO
Filtrar por severidade Habilita ou desabilita a visualização do grau da
severidade. As opções disponíveis são Crítica, Alta,
Média ou Baixa. Esta opção equivale, respectivamente,
às propriedades ShowCriticalPriority,
ShowHighPriority, ShowMediumPriority e
ShowLowPriority do objeto Filtro da Coleção de Filtros
18.2.1.3 Aba Ordenação

A aba Ordenação permite configurar a ordenação padrão dos alarmes. Quando mais de um campo de ordenação é
usado, os campos subsequentes permitem a ordenação entre alarmes que tenham o mesmo valor ou valores para o
campo anterior ou anteriores.
Aba Ordenação
Opções disponíveis na aba Ordenação
OPÇÃO DESCRIÇÃO
Pelo campo Ordena os alarmes conforme o campo especificado. Esta
opção equivale à propriedade PrimarySortField do
objeto Filtro de Alarmes. A ordenação padrão é realizada
através do campo InTime, de maneira descendente
Depois por Ordena os alarmes a partir do item especificado na

opção Pelo campo. O próximo item é ordenado a partir
da especificação indicada nos campos Depois por. Estas
opções equivalem às propriedades SecondarySortField,
ThirdSortField e FourthSortField do objeto Filtro de
Alarmes, respectivamente
Ascendente Ordena os campos do alarme de forma ascendente.

Estas opções equivalem às propriedades
PrimarySortAscending, SecondarySortAscending,
ThirdSortAscending e FourthSortAscending do objeto
Filtro de Alarmes em Verdadeiro, respectivamente
Descendente Ordena os campos do alarme de forma descendente.

Estas opções equivalem às propriedades
Filtro de Alarmes em Falso, respectivamente
331 Alarmes
18.3 Fontes de Alarme
Todas as informações relativas às condições de alarme são definidas nas Fontes de Alarmes, bem como os tipos de
eventos que devem ser gerados em cada condição. As Fontes de Alarme sempre contêm uma expressão de alarme ou
fonte de dados, cujo valor pode ser verificado de acordo com as diversas condições disponíveis. As fontes disponíveis
são Alarme Analógico, Alarme de Banda Morta, Alarme de Taxa de Variação, Alarme Digital e Alarme Discreto.
NOTA
O objeto Fonte de Alarme pode ser criado dentro de qualquer objeto do Servidor.
Para inserir este objeto, siga este procedimento:

1. Clique com o botão direito do mouse no objeto de Servidor no modo Explorer e selecione a opção Inserir -
Alarme (Analógico, Banda Morta, Taxa de Variação, Digital ou Discreto). No modo Domínio, selecione o
objeto no item Objetos de Servidor e selecione a opção Inserir - Alarme (Analógico, Banda Morta, Taxa de
Variação, Digital ou Discreto).
Inserindo uma Fonte de Alarme

Propriedades e execute os devidos ajustes. Demais informações sobre as funcionalidades das propriedades deste
objeto podem ser encontradas no Manual de Referência e Scripts do Elipse Power, em seu capítulo respectivo.
Em cada subcondição de alarme são configurados os limites, a mensagem relativa ao evento, a severidade e a
necessidade ou não de reconhecimento deste evento.
Alarmes 332
Fontes de Alarmes
Na Janela de Propriedades de qualquer Fonte de Alarme, selecione a aba Fonte para mostrar a janela da figura a
seguir.
Aba Fonte
Opções disponíveis na aba Fonte
OPÇÃO DESCRIÇÃO
Fonte dos dados Uma expressão que deve ser avaliada para determinar
se este alarme pode ocorrer ou não. Esta opção
corresponde à propriedade Source de todos os objetos
Fonte de Alarme
Tratar este alarme como um evento Indica que este é um alarme do tipo Evento, ou seja,
quando ativado, é reconhecido pelo usuário "System".
Esta opção corresponde à propriedade Event de todos
os objetos Fonte de Alarme
Duplo reconhecimento Indica que este alarme pode ser reconhecido tanto ativo
quanto inativo. Esta opção corresponde à propriedade
DoubleAckRequired de todos os objetos Fonte de
Alarme
Excluir alarmes suprimidos dos contadores de alarmes Ignora alarmes suprimidos de uma Área de Alarme nos
contadores gerais de alarmes. Esta opção corresponde à
propriedade ExcludeSuppressedOnAreaCounters de
todos os objetos Fonte de Alarme
Todas as Fontes de Alarme têm as propriedades gerais descritas na tabela a seguir.

333 Alarmes
Propriedades gerais das Fontes de Alarme
Texto da Mensagem Esta mensagem é armazenada no campo Mensagem do
evento de alarme enquanto estiver ativo, ou seja, pode
ser visualizada em um E3Alarm ou armazenada em um
banco de dados. O limite de texto desta mensagem é de
200 caracteres
Severidade Indica a gravidade de um alarme, ou seja, Crítica, Baixa,

Média ou Alta. O campo Severidade é usado para criar
filtros e ordenar mensagens
Pede Ack Indica se este alarme deve ser reconhecido por um

operador para ser removido da lista de alarmes em um
E3Alarm, ou se é reconhecido automaticamente quando a
variável deixa uma condição de alarme
Volta ao normal Esta mensagem é armazenada no campo Mensagem do

evento de alarme enquanto este estiver ativo, ou seja,
pode ser visualizada em um E3Alarm ou armazenada em
um banco de dados
Há vários tipos de Fontes de Alarme que podem ser inseridas em objetos do Servidor. As opções disponíveis estão
descritas nos próximos tópicos.
18.3.1 Alarme Analógico

Permite monitorar uma variável analógica pela especificação de até quatro níveis de alarme, que são LoLo (Muito
Baixo), Lo (Baixo), Hi (Alto) e HiHi (Muito Alto).
Aba Analógico
Opções disponíveis na aba Analógico
OPÇÃO DESCRIÇÃO
Subcondição Nome da subcondição do alarme. As opções disponíveis
são LoLo, Lo, Hi ou HiHi
Habilitado? Habilita a verificação da subcondição de alarme

selecionada
Limite Indica o nível em que esta subcondição de alarme é

disparada
Alarmes 334
OPÇÃO DESCRIÇÃO
Texto da Mensagem Permite especificar o texto que é mostrado para o
usuário quando esta subcondição do alarme está ativa
Severidade Determina a severidade desta subcondição de alarme. As

opções disponíveis são Crítica, Alta, Média ou Baixa
Pede Ack? Habilita ou desabilita o reconhecimento desta

subcondição de alarme
Evento? Habilita ou desabilita o tratamento desta subcondição de

alarme como um evento
Permite arquivar? Habilita ou desabilita o arquivamento desta subcondição

de alarme
Limite duração arquivamento Tempo máximo, em minutos, que esta subcondição de

alarme deve permanecer arquivada. O valor padrão
desta opção é 60, ou seja, uma hora
Limite arquivamentos Número máximo de vezes que esta subcondição de

alarme pode ser arquivada. O valor padrão desta opção
é 0 (zero), ou seja, sem limite
Espera (ms) Especifica um tempo de espera, em milissegundos.

Quando este valor é igual a 0 (zero, padrão), não é
aplicada nenhuma espera
Banda morta Habilita a banda morta, que é um recurso utilizado para

evitar que uma variável, ao manter uma pequena
oscilação em torno de um limite de alarme, gere uma
quantidade desnecessária de mensagens
Volta ao normal Permite especificar um texto a ser mostrado para o

usuário quando este alarme não está em condição ativa
18.3.2 Alarme de Banda Morta

Permite monitorar uma variável analógica pela especificação de um limite máximo de diferença ou valor de banda
morta, em relação a um valor de referência ou setpoint.
Banda morta
335 Alarmes
Este tipo de alarme é interessante quando a referência ou setpoint é variável, e também quando se deseja evitar uma
quantidade desnecessária de alarmes para pequenas oscilações da variável monitorada.
Aba Banda Morta

Opções disponíveis na aba Banda Morta
OPÇÃO DESCRIÇÃO
Habilitar Habilita a banda morta
Setpoint Associação para a variável de referência, para que seja

monitorada uma diferença em relação à variável de
monitoramento
Valor Indica a diferença entre a variável monitorada e o

setpoint, a partir da qual deve ser indicado o alarme.
Deve ser informado em unidades de engenharia da
variável monitorada
Texto da mensagem Permite especificar um texto que é mostrado para o

usuário quando este alarme está em condição ativa
Severidade Determina a severidade do nível de alarme. As opções

disponíveis são Crítica, Alta, Média ou Baixa
Pede Ack Habilita ou desabilita o reconhecimento deste alarme


Permite arquivar Habilita ou desabilita o arquivamento deste alarme
Tempo limite de arquivamento Tempo máximo, em minutos, que este alarme deve
permanecer arquivado. O valor padrão desta
propriedade é 60, ou seja, uma hora
Limite de arquivamentos Número máximo de vezes que este alarme pode ser
arquivado. O valor padrão desta opção é 0 (zero), ou
seja, sem limite
Alarmes 336
18.3.3 Alarme de Taxa de Variação
Usada para monitorar variações muito rápidas em uma variável do processo. A Fonte de Alarme Taxa de Variação
usa os valores especificados em unidades da variável por segundo.
Aba Taxa de Variação

Opções disponíveis na aba Taxa de Variação
OPÇÃO DESCRIÇÃO
Habilitar Habilita a verificação do alarme Taxa de Variação
Variação/segundo Indica a porcentagem da variável monitorada que pode

variar por segundo. Este valor é calculado tomando
como base cada intervalo de leitura da variável, pela
fórmula TDV = (Valor Atual - Valor Anterior) /
(Instante Atual - Instante Anterior). Se a taxa de
variação é maior que a taxa especificada, considera-se
em estado de alarme



Volta ao normal Determina a mensagem de texto que é mostrada ao

usuário quando este alarme volta ao estado normal
seja, sem limite
337 Alarmes
18.3.4 Alarme Digital
Permite monitorar uma variável digital pela especificação de alarme na borda de subida, em -1 (menos um) ou
Verdadeiro, ou na borda de descida, em 0 (zero) ou Falso.
Aba Digital
Opções disponíveis na aba Digital
OPÇÃO DESCRIÇÃO
Habilitar Habilita o alarme digital
Valor Determina o valor Booleano do alarme, ou seja,

Verdadeiro ou Falso




seja, sem limite
Alarmes 338
18.3.5 Alarme Discreto
Permite monitorar uma variável pela especificação de múltiplas subcondições.
Aba Discreto
Opções disponíveis na aba Discreto
OPÇÃO DESCRIÇÃO
Adicionar Subcondição Adiciona uma nova Subcondição neste alarme
Excluir Subcondição Remove a Subcondição selecionada
Mapear todas as subcondições Permite mapear e sincronizar as Subcondições deste

Alarme a partir de semânticas presentes no objeto fonte.
Este recurso atualmente só é suportado pelos objetos
de servidor do Elipse Power, portanto esta opção
permanece desabilitada por padrão no E3
Nome Nome desta Subcondição
Habilitado Habilita ou desabilita esta Subcondição
Descrição Descrição desta Subcondição
Valor Valor avaliado para determinar se este alarme ocorre ou

não
Texto da mensagem Mensagem mostrada quando esta Subcondição está

ativa
Tipo Comportamento desta Subcondição. As opções

disponíveis são 0: Alarme, 1: Evento ou 2: Retorno
Severidade O tipo de severidade desta Subcondição. As opções

disponíveis são -2: Crítica, 0: Alta, 1: Média ou 2: Baixa
Pede Ack? Indica se esta Subcondição exige reconhecimento
Permite arquivar? Habilita ou desabilita o arquivamento desta Subcondição

de alarme
Limite duração arquivamento Tempo máximo, em minutos, que esta Subcondição de

alarme deve permanecer arquivada. O valor padrão
desta opção é 60, ou seja, uma hora
Limite arquivamentos Número máximo de vezes que esta Subcondição de

alarme pode ser arquivada. O valor padrão desta opção
é 0 (zero), ou seja, sem limite
339 Alarmes
OPÇÃO DESCRIÇÃO

18.4 Servidor de Alarmes

O objeto Servidor de Alarmes centraliza todos os alarmes de um projeto. Neste objeto podem ser encontrados
todos os alarmes ativos de uma aplicação, reconhecidos ou não. Este objeto também é responsável por reportar os
eventos de alarme para todos os Elipse Power Viewers conectados, bem como enviar estes eventos para um banco
de dados, se necessário.
Uma aplicação só pode ter um objeto deste tipo, e a presença é obrigatória para que a verificação de alarmes
ocorra. Para inserir um Servidor de Alarmes, siga este procedimento:
1. Clique com o botão direito do mouse no projeto no modo Explorer e selecione a opção Inserir - Servidor de
Alarmes Em. No modo Domínio, clique com o botão direito do mouse no item Objetos de Servidor - Alarmes,
selecione a opção Inserir Servidor de Alarmes Em e logo após o nome do projeto desejado.
Inserindo um Servidor de Alarmes no modo Domínio
18.4.1 Configurações para Geração da Tabela de Alarmes

Para especificar as configurações de um Servidor de Alarmes, clique com o botão direito do mouse no objeto e
selecione a opção Propriedades.
Na aba Configuração, pode-se especificar as configurações de Banco de Dados e determinar campos para a geração
da tabela de alarmes.
Alarmes 340
Aba Configuração
OPÇÃO DESCRIÇÃO
Armazenar alarmes em banco de dados Habilita ou desabilita o armazenamento dos dados dos
alarmes em um banco de dados. Esta opção equivale à
propriedade Logging do objeto Servidor de Alarmes
Servidor de Banco de Dados Define o servidor de Banco de Dados que armazena os

dados do alarme. Esta opção equivale à propriedade
DataSource do objeto Servidor de Alarmes
Nome da tabela Define o nome da tabela de alarmes. Esta opção equivale

à propriedade TableName do objeto Servidor de
Alarmes
Descartar dados da tabela principal Habilita ou desabilita o descarte de dados da tabela

principal. Um dado é considerado antigo de acordo com
o que é definido na opção Descartar dados mais
antigos que. Esta opção equivale à propriedade
EnableDiscard do objeto Servidor de Alarmes
Esta opção equivale à propriedade DiscardInterval do
objeto Servidor de Alarmes e a opção de seleção da
unidade de tempo do intervalo equivale à propriedade
DiscardTimeUnit do objeto Servidor de Alarmes
341 Alarmes
OPÇÃO DESCRIÇÃO
Realizar o descarte a cada Executa a verificação dos alarmes, conforme o período
especificado, em minutos, horas, dias ou meses. Esta
opção equivale à propriedade VerificationInterval do
VerificationUnit do objeto Servidor de Alarmes
descartados na tabela secundária, ou tabela de backup.
Esta opção equivale à propriedade EnableBackupTable
do objeto Servidor de Alarmes
sempre maior que o configurado na opção Descartar
dados mais antigos que da tabela principal. Esta opção
equivale à propriedade BackupDiscardInterval do
BackupDiscardTimeUnit do objeto Servidor de Alarmes
Campos Determina quais campos dos eventos de alarme são

adicionados à tabela de alarmes, e qual a ordem em que
estas colunas aparecem
Gerar tabela Gera a tabela dos alarmes no Banco de Dados

especificado
Excluir alarmes suprimidos dos contadores de alarmes Habilita ou desabilita a exclusão de alarmes suprimidos
dos contadores de alarmes. Esta opção é equivalente à
propriedade ExcludeSuppressedAlarmsOnCounters do
objeto Servidor de Alarmes
Os campos disponíveis no Servidor de Alarmes para geração da tabela de alarmes estão descritos na tabela a seguir.
Campos disponíveis para tabelas dos Campos dos alarmes
CAMPO DESCRIÇÃO
Acked Informa se um alarme foi reconhecido ou não. Os valores
possíveis para este campo são 0: Não reconhecido ou 1:
Reconhecido
AckRequired Determina o reconhecimento automático de um alarme.

Os valores possíveis para este campo são 0:
Reconhecimento automático ou 1: Reconhecimento manual
AckTime Registra a data e hora do Elipse Power no momento em

que um alarme é reconhecido, ou zero (30/12/1899)
enquanto um alarme não é reconhecido. No caso de
alarmes que não pedem reconhecimento, este campo
assume a data e hora do Elipse Power no momento em
que um alarme se torna ativo
AckTimeDbl Corresponde ao campo AckTime como um número em

formato Double. Este campo é usado para facilitar a
gravação de dados de data e hora em bancos de dados
Oracle ou SQL Server
Alarmes 342
CAMPO DESCRIÇÃO
AckTimeMS Corresponde ao campo AckTime como um valor em
milissegundos. Este campo é usado para facilitar a
Oracle
ActiveSource Fonte de Medida ativa de um objeto. Para o E3 este valor

é sempre igual a -1 (menos um). Para o Elipse Power,
consulte a propriedade CustomFilter do E3Alarm para os
valores possíveis deste campo
ActorID Nome do operador que reconheceu o alarme. Os valores

possíveis para este campo são os seguintes:
· O usuário logado no Elipse Power Viewer quando o
reconhecimento é realizado no E3Alarm ou "Sem
usuário" se não há usuário logado
· "System", quando o reconhecimento é automático, ou
seja, para alarmes que não pedem reconhecimento
· Um nome passado por script, como por exemplo ao
usar os métodos AckArea, AckAllAlarms ou
LogTrackingEvent do Servidor de Alarmes ou o
método Ack da Fonte de Alarmes
O tamanho padrão deste campo é de 50 caracteres
AlarmArea Para eventos de alarme, é o nome da Área à qual a Fonte

de Alarmes pertence. Para outros eventos, como por
exemplo ao usar o método LogTrackingEvent do
Servidor de Alarmes, pode ser um texto definido pelo
usuário. O tamanho padrão deste campo é de 100
caracteres
AlarmSourceName Registra o nome da Fonte de Alarme. O tamanho padrão

deste campo é de 100 caracteres
AllowShelving Indica se este evento pode ou não ser arquivado
ChangeMask Não é usado e seu valor é sempre igual a 0 (zero)
ConditionActive Indica se a Fonte de Alarme está em alarme. Os valores

possíveis para este campo são 0: Condição não ativa ou 1:
Condição ativa
ConditionName Nome da condição, se é um evento de alarme. Os valores

possíveis para este campo são Banda Morta: Fonte de
Alarme do tipo Banda Morta, Digital: Fonte de Alarme do
tipo Digital, Discreto: Fonte de Alarme do tipo Discreto,
Nível: Fonte de Alarme do tipo Analógico ou
TaxaDeVariação: Fonte de Alarme do tipo Taxa de
Variação. Se o evento não é um alarme, como por
Servidor de Alarmes, este valor é sempre uma String
vazia. O tamanho padrão deste campo é de 100
caracteres
Cookie Valor associado à Fonte de Alarme e usado internamente

pelo Servidor de Alarmes
CurrentValue Determina o valor da Fonte de Alarme, convertido para o

formato Double, no momento do evento. Para outros
eventos, como por exemplo ao usar o método
LogTrackingEvent, o valor é sempre 0 (zero)
Deleted Determina se este alarme foi removido. Um alarme só

pode ser removido se o campo Unbound estiver
configurado como Verdadeiro
343 Alarmes
CAMPO DESCRIÇÃO
E3TimeStamp Data e hora do computador no momento do evento
Enabled Determina se a verificação de um alarme está habilitada.

Os valores possíveis para este campo são 0: Verificação
da fonte de alarmes desabilitada ou 1: Verificação da
fonte de alarme desabilitada
EventCategory Categoria do evento. Para alarmes, os valores possíveis

para este campo são Banda Morta: Fonte de Alarme do
tipo Banda Morta, Digital: Fonte de Alarme do tipo
Digital, Discreto: Fonte de Alarme do tipo Discreto,
Nível: Fonte de Alarme do tipo Analógico, ou
TaxaDeVariação: Fonte de Alarme do tipo Taxa de
Variação. Para outros eventos, como por exemplo ao usar
o método LogTrackingEvent do Servidor de Alarmes, o
campo pode assumir valores definidos pelo usuário. O
tamanho padrão deste campo é de 100 caracteres
EventCLSID Identificador único para toda a vida de um alarme.

Quando um alarme novo ocorre em uma Fonte, gera-se
um novo identificador. Assim, este alarme mantém este
mesmo identificador no banco de dados enquanto não
sair da lista de alarmes ativos e não reconhecidos
EventTime Data e hora do valor do Tag associado à Fonte de Alarme

no momento do evento
EventTimeDbl Corresponde ao campo EventTime como um valor em

EventTimeMS Corresponde ao campo EventTime como um valor em

Oracle
EventTimeUTC Corresponde ao campo EventTime com relação ao

horário de Greenwich. Este campo é mantido no Elipse
Power por questões de compatibilidade
EventType Tipo do evento. Para eventos de alarme, o valor deste

campo é sempre igual a "Condition". Para outros eventos,
pode ser um texto definido pelo usuário, como por
Servidor de Alarmes ("Tracking", "Simple"). O tamanho
padrão deste campo é de 100 caracteres
FormattedValue Mostra o valor formatado da Fonte de Alarme que vai

para o evento. O tamanho padrão deste campo é de 100
caracteres. NOTA: Este campo é somente de leitura
FullAlarmSourceName Registra o caminho completo da Fonte de Alarme,

incluindo Áreas, nome da Configuração de Alarmes e de
possíveis Pastas onde esta possa estar inserida, como por
exemplo "Pasta1.ConfigAlarmes1.Area1.FonteAlarme1". O
InTime Registra a data e hora do valor, no momento em que

entra na condição de alarme
InTimeDbl Corresponde ao campo InTime como um número em

Alarmes 344
CAMPO DESCRIÇÃO
InTimeMS Corresponde ao campo InTime como um valor em
Oracle
Message Texto configurado na Fonte de Alarme ou especificado

por um outro evento, como por exemplo ao usar o
método LogTrackingEvent do Servidor de Alarmes. O
OutTime Registra a data e hora do valor no momento em que sai

da condição de alarme ou zero (30/12/1899) caso o
alarme ainda não tenha saído da condição ativa
OutTimeDbl Corresponde ao campo OutTime como um número em

OutTimeMS Corresponde ao campo OutTime como um valor em

Oracle
Quality Qualidade do valor de Fonte de alarme no momento do

evento. Os valores possíveis para este campo são 0 - 63:
Qualidade ruim, 64 - 127: Qualidade incerta, 128 - 191:
Valor não definido ou 192 - 255: Qualidade boa. Se o
evento não é um alarme, como por exemplo ao usar o
método LogTrackingEvent do Servidor de Alarmes, este
campo é igual a uma String vazia. O tamanho padrão
Severity Valor de severidade configurado na Fonte de Alarme. Os

valores possíveis para este campo são -2: Crítica, 0: Alta,
1: Média ou 2: Baixa. Este campo também pode assumir
outro valor definido pelo usuário se é um evento, como
por exemplo ao usar o método LogTrackingEvent do
Servidor de Alarmes. O tamanho padrão deste campo é
de 20 caracteres
ShelveActorID Nome do operador que arquivou este evento. Consulte o

campo ActorID para mais informações sobre o conteúdo
deste campo
ShelveCount Número de vezes que este evento foi arquivado
Shelved Indica se este evento foi ou não arquivado
ShelvedOutTime Data e hora em que este evento é desarquivado
ShelvedTime Data e hora em que este evento é arquivado
ShelveDuration Tempo, em minutos, que este evento esteve arquivado
ShelveMaxCount Número máximo de vezes que este evento pode ser

arquivado
ShelveMaxDuration Tempo máximo, em minutos, que este evento pode

permanecer arquivado
ShelveReason Motivo pelo qual este evento foi arquivado. O tamanho

limite deste campo é de 150 caracteres
Source Para eventos de alarme, informa a expressão utilizada

para avaliar as condições de alarme. O tamanho padrão
345 Alarmes
CAMPO DESCRIÇÃO
SubConditionName Nome da Subcondição, se é um evento de alarme. Os
valores possíveis para este campo são BM: Alarme de
Banda Morta, DIG: Alarme Digital, TV: Alarme Taxa de
Variação, LOLO: Alarme Analógico na faixa Muito Baixo,
LO: Alarme Analógico na faixa Baixo, HI: Alarme Analógico
na faixa Alto ou HIHI: Alarme Analógico na faixa Muito
Alto. Se o evento não é um alarme, como por exemplo ao
utilizar o método LogTrackingEvent do Servidor de
Alarmes, este campo é igual a uma String vazia. O
tamanho padrão deste campo é de 100 caracteres. Para
Fontes de Alarme do tipo Discreto, este campo assume o
nome da Subcondição definida pelo usuário na aba
Discreto das propriedades deste tipo de Alarme
Unbound Indica se este alarme não está vinculado a uma Fonte de

Alarme
Campos do Usuário São os campos definidos pelo usuário. Estes campos são
configurados na aba Campos do usuário no Servidor de
Alarmes
NOTAS
· É necessário que haja um Servidor de Alarmes no Domínio para que seja possível o monitoramento de alarmes.
· Os campos EventTimeMS, InTimeMS, OutTimeMS e AckTimeMS não estão disponíveis no E3Alarm, pois neste
objeto é possível visualizar os milissegundos através da formatação das colunas de data e hora.
· Alterar o tamanho de campos do tipo Texto para um valor menor do que o tamanho atual, em campos que já
possuem dados, pode levar ao truncamento ou à perda destes dados.
Depois de definidas todas as configurações, a aplicação inicializa a inserção e gravação das informações na tabela
dos alarmes, conforme as especificações dos campos. Ao clicar em Gerar tabela, o Elipse Power Studio gera a tabela
de dados dos alarmes conforme as especificações e informa se a tabela foi gerada com sucesso.
Mensagem do Servidor de Alarmes

A estrutura da tabela dos alarmes é semelhante à do Histórico, composta por uma tabela de definições, uma tabela
principal de dados e uma tabela opcional de backup.
Alarmes 346
Tabela de campos
Os campos gerados na tabela são explicados no tópico Configurações da Tabela do capítulo Histórico.
Através da janela de configuração do Servidor de Alarmes, pode-se especificar o Servidor de Banco de Dados
utilizado para a gravação dos alarmes. O Servidor de Banco de Dados (objeto DBServer) é um módulo do Elipse
Power que deve ser inserido na aplicação.
18.4.2 Configurações dos Campos do Usuário

Na aba Campos do usuário pode-se adicionar valores arbitrários aos eventos de alarmes.
Aba Campos do usuário

Opções disponíveis na aba Campos do usuário
OPÇÃO DESCRIÇÃO
Nome Determina o nome do Campo
Tipo Determina o tipo do Campo. As opções disponíveis são

0: String, 1: Integer, 2: Double ou 3: DateTime
Tamanho Determina o tamanho do Campo
Fonte Determina a fonte de dados do Alarme
347 Alarmes
OPÇÃO DESCRIÇÃO
Propagar? Força a atualização imediata de todos os alarmes que
herdam o valor deste Campo do Usuário, sempre que
este receber um valor forçado ou se a Associação for
alterada
Adicionar Campo do Usuário Adiciona um Campo do Usuário ao final da listagem
Remover Campo do Usuário Remove o último Campo do Usuário da listagem
Campos do Usuário só podem ser incluídos ou excluídos ao final da listagem. A exclusão de Campos de Usuário nesta
listagem se reflete em todas as Áreas e Fontes de Alarmes relacionadas a este Servidor de Alarmes, mas apenas se os
Campos removidos não tenham sido configurados com um valor forçado ou uma Associação. Do contrário, estes
Campos continuam aparecendo nas Áreas e Fontes de Alarme. A figura a seguir mostra um Alarme Analógico com os
Campos do Usuário herdados do Servidor de Alarmes.
Campos do Usuário herdados
NOTA
Para mais informações sobre o comportamento de um Campo do Usuário de Áreas e Fontes de Alarme, tanto no
Elipse Power Studio quanto em tempo de execução, verifique as propriedades Link, Value e ValueSource no
Alarmes 348
CAPÍTULO
E3Alarm
19
O E3Alarm serve para monitoramento dos alarmes ativos ou não reconhecidos em uma aplicação. Através deste
objeto é possível verificar o estado dos alarmes, bem como reconhecê-los manualmente.
E3Alarm
Para utilizar este objeto, siga este procedimento:
1. Clique com o botão direito do mouse em uma Tela ou na área de trabalho e selecione a opção Inserir - E3Alarm,
ou então clique em E3Alarm na barra de ferramentas da Tela.
Inserindo um E3Alarm em uma Tela

Propriedades e faça os devidos ajustes.
19.1 Configurações
Para configurar um E3Alarm, clique com o botão direito do mouse no objeto e selecione a opção Propriedades.
349 E3Alarm
19.1.1 Aba Conexões
A aba Conexões permite configurar uma ou mais conexões a Servidores de Alarmes locais ou remotos.
Aba Conexões
Opções disponíveis na aba Conexões
OPÇÃO DESCRIÇÃO
Adicionar Conexão Adiciona uma nova Conexão a um E3Alarm. Esta opção
corresponde ao método Add da Coleção de Conexões
Remover Conexão Remove a Conexão selecionada. Esta opção corresponde

ao método Remove da Coleção de Conexões. NOTA: A
Conexão criada automaticamente com um E3Alarm não
pode ser removida
Nome conexão Nome desta Conexão. Pressione a tecla F2 para editar

este nome. Esta opção corresponde à propriedade
ConnectionName do objeto Conexão na Coleção de
Conexões
Domínio Nome amigável para identificar o Domínio do Servidor

de Alarmes selecionado. Esta opção corresponde à
propriedade DomainName do objeto Conexão na
Coleção de Conexões
Servidor de Alarmes Nome do Servidor de Alarmes, que tanto pode estar em

um Domínio local quanto em um Domínio Remoto. Esta
opção corresponde à propriedade AlarmServer do
objeto Conexão na Coleção de Conexões. Clique em
para selecionar um Servidor de Alarmes utilizando o
AppBrowser
Filtro conexão Nome de um Filtro que contém a configuração do filtro

de alarmes, definido na aba Filtros. Esta opção
corresponde à propriedade FilterConnection do objeto
Conexão na Coleção de Conexões
É possível acessar um Servidor de Alarmes remoto simplesmente preenchendo a propriedade AlarmServer do objeto
Conexão na Coleção de Conexões de um E3Alarm com os dados do Domínio e do Servidor de Alarmes remotos, no
formato DOMINIO:SERVIDOR, onde SERVIDOR é o nome do Servidor de Alarmes remoto e DOMINIO é o nome do
Domínio Remoto que o contém. Para configurar o Domínio Remoto, consulte o tópico Domínios Remotos no capítulo
sobre Domínios.
E3Alarm 350
19.1.2 Aba Filtros
A aba Filtros permite gerenciar os filtros de um E3Alarm.
Aba Filtros
OPÇÃO DESCRIÇÃO
Filtros Caixa de seleção com os Filtros atualmente disponíveis
Configurar Abre a janela de configuração do Filtro selecionado,

descrita no tópico de configuração do Filtro de Alarmes
Adicionar Adiciona um novo Filtro à Coleção de Filtros. Esta opção

corresponde ao método Add da Coleção de Filtros
Remover Remove o Filtro selecionado. Esta opção corresponde ao

método Remove da Coleção de Filtros. NOTA: O Filtro
criado automaticamente com o E3Alarm não pode ser
removido
19.1.3 Aba Colunas

Através da aba Colunas é possível selecionar os campos que são visualizados em um E3Alarm. Os campos mostrados
nas listas Campos disponíveis e Campos selecionados são gerados pelo Servidor de Alarmes. Para mais
informações, consulte a Tabela dos Campos dos Alarmes no tópico Configurações para Geração da Tabela de
Alarmes do capítulo Alarmes.
351 E3Alarm
Aba Colunas
A lista Campos disponíveis mostra todos os campos da Fonte de Alarme. Clicando em Adicionar, pode-se
acrescentar campos individualmente em um E3Alarm. Clicando em Propriedades, é possível configurar as
propriedades do campo do alarme.
Janela Propriedades da Coluna

Opções disponíveis na janela Propriedades da Coluna
OPÇÃO DESCRIÇÃO
Visível Indica se esta coluna é visível ou não. Esta opção
corresponde à propriedade Visible do objeto Campo da
Coleção de Campos de um E3Alarm
Largura (pixels) Determina a largura da coluna, em pixels. A largura

padrão das colunas de um E3Alarm é de 80 pixels. Esta
opção corresponde à propriedade Width do objeto
Campo da Coleção de Campos de um E3Alarm
Formatador Determina o formatador utilizado na coluna de um

E3Alarm. O formatador utilizado é o padrão do Elipse
Power (consulte o tópico Formatação de Valores), com
exceção do campo Severidade e dos campos Condição
Ativa, Pede Ack, Reconhecido e Habilitado, cujos
exemplos de formatação podem ser vistos nas tabelas a
seguir. Esta opção corresponde à propriedade Format
do objeto Campo da Coleção de Campos de um E3Alarm
Renomear para Renomeia o título da coluna
E3Alarm 352
OPÇÃO DESCRIÇÃO
Permite reconhecer Permite configurar o reconhecimento do alarme quando o
usuário clicar na linha da coluna configurada. As opções
disponíveis são Nunca: O alarme não é reconhecido
(padrão), Com clique: O alarme é reconhecido quando o
usuário clica na linha da coluna ou Com clique-duplo: O
alarme é reconhecido quando o usuário clica duas vezes
na linha da coluna. NOTA: Se o alarme puder ser
reconhecido, o formato do cursor do mouse muda para
, em tempo de execução, quando estiver sobre uma
linha de alarme não reconhecido. Esta opção
corresponde à propriedade AckOnClick do objeto
Campo da Coleção de Campos de um E3Alarm
Esta coluna nunca pisca Habilita ou desabilita o piscar desta coluna. Esta opção
corresponde à propriedade AllowBlink do objeto Campo
da Coleção de Campos de um E3Alarm
Formatador para o campo Severidade

Severidade Crítica "A";"B";"C"; C
Severidade Alta ;;; Alta
Severidade Média "A";"M";"B" M
Severidade Baixa ;;; Baixa
Formatador para os campos Condição Ativa, Pede Ack, Reconhecido e Habilitado

Verdadeiro "OK";"Não OK" OK
Falso "OK";"Não OK" Não OK
Verdadeiro "AAA" AAA
Falso "AAA" Não
Verdadeiro ; Sim
Falso ; Não
Para remover algum campo indesejado, selecione-o e clique em Remover.
19.1.4 Aba Ordenação

A aba Ordenação permite configurar a ordenação padrão dos alarmes. Quando mais de um campo de ordenação é
usado, os campos subsequentes permitem a ordenação entre alarmes que tenham o mesmo valor para o campo
anterior ou anteriores.
353 E3Alarm
Aba Ordenação
Cada campo da aba Ordenação possui uma propriedade correspondente. As propriedades disponíveis estão
Opções disponíveis na aba Ordenação
OPÇÃO DESCRIÇÃO
Pelo campo Ordena os alarmes conforme o campo especificado. Este
campo equivale à propriedade PrimarySortField do
objeto E3Alarm
Depois por Ordena os alarmes a partir do item especificado na

opção Pelo campo. O próximo item é ordenado a partir
da especificação indicada nos campos Depois por. Estes
campos equivalem às propriedades SecondarySortField,
ThirdSortField e FourthSortField do objeto E3Alarm,
respectivamente
Ascendente Ordena os campos do alarme de forma ascendente.

Estes campos equivalem às propriedades
E3Alarm em Verdadeiro, respectivamente
Descendente Ordena os campos do alarme de forma descendente.

Estes campos equivalem às propriedades
E3Alarm em Falso, respectivamente
NOTAS
· A ordenação padrão é realizada através do campo InTime, de maneira descendente.
· Caso a propriedade BannerMode esteja configurada para Verdadeiro, o alarme mostrado depende da
configuração realizada nesta aba.
19.1.5 Aba Cores

Na aba Cores são definidas as cores de reconhecimento dos alarmes em um E3Alarm. É possível configurar as cores
para cada tipo de alarme ou por severidade.
E3Alarm 354
Aba Cores
Clique em para selecionar a cor do tipo de alarme selecionado. A janela da figura a seguir é mostrada.
Cores do alarme selecionado

Opções disponíveis na janela Cores
OPÇÃO DESCRIÇÃO
Cor de fundo Determina a cor de fundo de um alarme. Esta opção
corresponde à propriedade BackgroundColor do objeto
Cor do Alarme
Cor do texto Determina a cor do texto de um alarme. Esta opção

corresponde à propriedade TextColor do objeto Cor do
Alarme
Não pisca Quando esta opção é selecionada, o texto de um alarme

não pisca. Esta opção corresponde à propriedade
BlinkMode do objeto Cor do Alarme configurada com o
valor 0 (zero)
Pisca invertendo fundo e texto Quando esta opção é selecionada, as cores de texto e
fundo alternam entre si. Esta opção corresponde à
propriedade BlinkMode do objeto Cor do Alarme
configurada com o valor 1 (um)
355 E3Alarm
OPÇÃO DESCRIÇÃO
Pisca apagando texto Quando esta opção é selecionada, a cor do texto varia
entre as cores selecionadas para o texto e para o fundo.
Esta opção corresponde à propriedade BlinkMode do
objeto Cor do Alarme configurada com o valor 2 (dois)
Pisca texto trocando para a cor Quando esta opção é selecionada, a cor do texto varia
entre a cor selecionada na opção Cor do texto e a cor
selecionada nesta opção. Esta opção corresponde à
propriedade BlinkMode do objeto Cor do Alarme com o
valor 3 (três) e a cor selecionada corresponde à
propriedade TextColor2 do objeto Cor do Alarme
É possível também selecionar as cores por severidade para cada tipo de alarme.
Cores do alarme por severidade

Clique em para redefinir as cores apenas para um tipo de severidade, no tipo de alarme selecionado. A janela da
figura a seguir é mostrada.
Cores por severidade

E3Alarm 356
Opções disponíveis na janela Cores por severidade
OPÇÃO DESCRIÇÃO
Redefinir cor de fundo Determina a cor de fundo deste alarme apenas para a
severidade selecionada. Se esta opção não está
selecionada, permanece a cor selecionada na opção Cor
de fundo do tipo de alarme selecionado. Esta opção
corresponde à propriedade OverrideBackgroundColor
do objeto Cor do Alarme
Redefinir cor do texto Determina a cor do texto deste alarme apenas para a
severidade selecionada. Se esta opção não está
selecionada, permanece a cor selecionada na opção Cor
do texto do tipo de alarme selecionado. Esta opção
corresponde à propriedade OverrideTextColor do
objeto Cor do Alarme
Redefinir pisca Redefine a opção de pisca para o texto e para o fundo

deste alarme na severidade selecionada. Se esta opção
não está selecionada, permanece a opção selecionada
no tipo de alarme selecionado, conforme descrito na
tabela Opções disponíveis na janela Cores. Esta opção
corresponde à propriedade OverrideBlinkMode do
objeto Cor do Alarme
Cada um dos itens da listagem Configure as cores dos alarmes corresponde a uma propriedade do E3Alarm que
retorna um objeto Cor do Alarme, conforme a tabela a seguir.
Propriedades correspondentes às configurações de cores dos alarmes
ITEM PROPRIEDADE
Alarme Ativo ColorActiveAlarm
Alarme Reconhecido ColorAckedAlarm
Alarme Não Reconhecido ColorNACkAlarm
Evento Ativo ColorActiveEvent
As propriedades descritas na tabela anterior são indexadas, ou seja, na sua utilização é possível especificar um índice
que indica qual severidade pode ser configurada. Os valores possíveis para os índices destas propriedades são -2:
Severidade crítica, 0: Severidade alta, 1: Severidade média, 2: Severidade baixa ou -1: Configuração global do alarme,
ou seja, configura os valores que são utilizados caso a severidade não os sobrescreva.
NOTA
As propriedades ColorActiveAlarm, ColorAckedAlarm, ColorNACkAlarm e ColorActiveEvent só estão disponíveis
via script. O objeto retornado por qualquer uma destas propriedades pode ser configurado utilizando o método
SetConfig.
357 E3Alarm
19.1.6 Aba Fontes
Através da aba Fonte é possível configurar a fonte do cabeçalho e das linhas de um E3Alarm.
Aba Fonte
As opções disponíveis são referentes a tipo, tamanho e efeitos de uma fonte.
NOTA
O nome da aba aparece no idioma do Windows, e não necessariamente no idioma do Elipse Power.
19.2 Características Específicas de Tempo de Execução

O E3Alarm possui uma série de características que se aplicam apenas em tempo de execução (runtime). Estas
características são descritas nos tópicos a seguir.
NOTA
Todas as opções do E3Alarm em tempo de execução que estão disponíveis via menu contextual, ou seja, através do
clique com o botão direito do mouse, também estão disponíveis utilizando o atalho de teclado SHIFT + F10, que
corresponde à tecla de aplicação ou de menu .
E3Alarm 358
19.2.1 Visualizando os Alarmes
Em tempo de execução, os alarmes do sistema podem ser visualizados em um E3Alarm.
E3Alarm em execução
Dentre os alarmes que satisfazem os filtros configurados, são mostrados no E3Alarm aqueles que estiverem em
condição ativa ou não estiverem reconhecidos. De maneira geral, estes alarmes podem ser divididos em dois casos:
· Se a opção Pede Ack da Fonte de Alarme estiver em Falso, o alarme é considerado reconhecido desde a sua
ativação, sem a necessidade de reconhecimento. Neste caso, o alarme permanece visível até que saia da condição
ativa
· Se a opção Pede Ack da Fonte de Alarme estiver em Verdadeiro, o usuário pode reconhecer o alarme antes ou
depois da variável sair da condição de alarme. Em ambos os casos, o alarme só sai da lista do E3Alarm quando
as duas condições estiverem satisfeitas
A propriedade BannerMode, quando configurada para Verdadeiro, permite visualizar apenas uma mensagem de
alarme no objeto E3Alarm. A mensagem que é mostrada depende da configuração realizada na aba Ordenação.
19.2.2 Reconhecimento de Alarmes

Na configuração padrão, as opções de reconhecimento de alarmes são Reconhecimento e Deletar alarmes
desvinculados, disponíveis no menu contextual do E3Alarm. Selecionar a opção Reconhecimento mostra a caixa de
diálogo da figura a seguir.
Reconhecimento de alarmes
Opções disponíveis na caixa de diálogo Alarmes
OPÇÃO DESCRIÇÃO
Apenas os alarmes selecionados Somente os alarmes selecionados são reconhecidos
359 E3Alarm
OPÇÃO DESCRIÇÃO
Todos os alarmes do filtro corrente Todos os alarmes visíveis neste E3Alarm são
reconhecidos
Globalmente todos os alarmes Todos os alarmes do Domínio são reconhecidos
A opção Apenas os alarmes selecionados só está disponível se realmente houver alarmes selecionados no E3Alarm.
O usuário pode reconhecer o alarme, e neste caso é inserido um novo registro no Banco de Dados indicando o
reconhecimento, e no E3Alarm a linha correspondente indica que este alarme foi reconhecido. Esta opção está
desabilitada caso a propriedade AllowAckSelected esteja configurada para Falso.
A opção Todos os alarmes do filtro corrente só está disponível se realmente houver alarmes visíveis no E3Alarm. É
possível utilizar esta opção sem clicar em nenhum alarme. Para isto, clique em qualquer área do E3Alarm para mostrar
a janela de Reconhecimento. Clicando nesta janela, a caixa de diálogo de reconhecimento é mostrada. Esta opção está
desabilitada caso a propriedade AllowAckCurrentFilter esteja configurada para Falso.
A opção Globalmente todos os alarmes está sempre disponível, mesmo que não haja alarmes visíveis no E3Alarm.
Esta opção está desabilitada caso a propriedade AllowAckAll esteja configurada para Falso.
Selecionar a opção Deletar alarmes desvinculados mostra a caixa de diálogo da figura a seguir.
Deletar alarmes vinculados

Para esta opção, o único item disponível é Globalmente todos os alarmes, ou seja, todos os alarmes que não
estejam vinculados a uma Fonte de Alarme são removidos. Esta opção do menu contextual de um E3Alarm está
desabilitada caso a propriedade AllowDeleteUnboundAlarms esteja configurada para Falso.
NOTA
Um alarme é considerado desvinculado quando está presente no sumário de alarmes mas sua Fonte de Alarme foi
desativada. Esta desvinculação pode ocorrer em algumas situações, como por exemplo ao mudar o nome de uma
Fonte de Alarme, ao utilizar o método Deactivate na Fonte de Alarme em um script ou ao remover uma Fonte de
Alarme.
O reconhecimento de alarmes também pode ser executado através de um clique ou duplo-clique na linha do alarme.
Para isto, especifique nas propriedades da coluna desejada, na Janela de Propriedades do E3Alarm, aba Colunas,
opção Propriedades, como deve ser executado o reconhecimento do alarme em tempo de execução, com um ou dois
cliques na coluna.
19.2.3 Arquivamento de Alarmes

O Arquivamento de Alarmes permite que um operador remova temporariamente alarmes do sumário corrente. Isto
possibilita ao operador gerenciar os alarmes visíveis, silenciando-os enquanto resolve um problema ou concentrando-
se em alarmes mais importantes.
Na configuração padrão, as opções de arquivamento de alarmes são Arquivar Alarmes e Desarquivar Alarmes,
disponíveis no menu contextual do E3Alarm. Estas opções não estão disponíveis caso a propriedade
AllowShelveAlarms esteja configurada para Falso.
Selecionar a opção Arquivar Alarmes mostra a caixa de diálogo da figura a seguir.
E3Alarm 360
Arquivamento de alarmes
Opções disponíveis na caixa de diálogo Alarmes
OPÇÃO DESCRIÇÃO
Apenas os alarmes selecionados Somente os alarmes selecionados são arquivados
Todos os alarmes do filtro corrente Todos os alarmes visíveis neste E3Alarm são arquivados
Globalmente todos os alarmes Todos os alarmes do Domínio são arquivados
Duração do arquivamento Duração do arquivamento do alarme, em minutos
Motivo Razão para o arquivamento do alarme
A opção Apenas os alarmes selecionados só está disponível se realmente houver alarmes selecionados no E3Alarm.
O usuário pode arquivar o alarme, e neste caso é inserido um novo registro no Banco de Dados indicando o
arquivamento, e no E3Alarm a linha correspondente indica que este alarme foi arquivado.
A opção Todos os alarmes do filtro corrente só está disponível se realmente houver alarmes visíveis no E3Alarm. É
possível utilizar esta opção sem clicar em nenhum alarme. Para isto, clique em qualquer área do E3Alarm para mostrar
a janela de arquivamento. Clicando nesta janela, a caixa de diálogo de arquivamento é mostrada.
A opção Globalmente todos os alarmes está sempre disponível, mesmo que não haja alarmes visíveis no E3Alarm.
Selecionar a opção Desarquivar Alarmes mostra a caixa de diálogo da figura a seguir.
Desarquivamento de alarmes
Para esta opção, os itens disponíveis são os mesmos da opção Arquivar Alarmes.
361 E3Alarm
NOTA
Caso um alarme seja desarquivado por um operador, este alarme retorna ao sumário como um alarme reconhecido.
Caso seja desarquivado automaticamente, ou seja, pela expiração do tempo de duração do arquivamento, este
alarme volta como não reconhecido.
19.2.4 Ordenação de Colunas

Na configuração padrão, é possível ordenar os alarmes clicando-se no cabeçalho das colunas de um E3Alarm. Ao
clicar no cabeçalho da coluna desejada, o campo associado a esta coluna é configurado como o campo primário de
ordenação. Ao clicar novamente no cabeçalho da mesma coluna, o sentido de ordenação primário, ascendente ou
descendente, é invertido.
Clicando no cabeçalho da coluna desejada com a tecla SHIFT pressionada, o campo associado a esta coluna é
configurado como campo secundário de ordenação. Ao clicar novamente com a tecla SHIFT pressionada no cabeçalho
desta coluna, o sentido de ordenação secundário é invertido.
A propriedade EnableSortMarker permite mostrar ou esconder a indicação de ordenação ascendente ou
descendente ao clicar no cabeçalho de uma coluna.
Para mais detalhes sobre este comportamento, consulte as propriedades EnableSortMarker, PrimarySortAscending,
PrimarySortField, SecondarySortAscending, SecondarySortField, ThirdSortAscending, ThirdSortField,
FourthSortAscending, FourthSortField e BannerMode do objeto E3Alarm no Manual de Referência e Scripts do
Elipse Power.
Exemplo de ordenação
19.2.5 Status das Conexões

A partir da versão 4.7, o E3Alarm permite visualizar o status das conexões configuradas na aba Conexões. Para
habilitar a barra de status, configure a propriedade ShowConnectionStatusBar do objeto E3Alarm na Lista de
Propriedades. A figura a seguir mostra a barra de status habilitada.
E3Alarm 362
Barra de status de conexões do E3Alarm
As propriedades de um E3Alarm que podem ser configuradas para controlar o comportamento da barra de status
são as seguintes:
· ShowConnectionStatusBar: Mostra ou esconde a barra de status
· ConnectionStatusBarColor: Especifica a cor de fundo da barra de status
· PictureConnected: Caminho para um arquivo de imagem com o ícone representando uma conexão com sucesso.
O padrão é mostrar o ícone
· PictureNotConnected: Caminho para um arquivo de imagem com o ícone representando uma conexão em falha.
O padrão é mostrar o ícone
· PictureUnknown: Caminho para um arquivo de imagem com o ícone representando uma conexão indefinida. O
padrão é mostrar o ícone
NOTA
O status indefinido indica que um E3Alarm não recebeu uma confirmação do Servidor de Alarmes de que a conexão
teve sucesso. Este é o status padrão para versões anteriores à 4.7.
363 E3Alarm
CAPÍTULO
Storage
20
O Storage é um módulo alternativo de gravação de dados históricos. Através deste módulo é possível transformar
dados de produção, processos e outras coletas em informações gerenciais. Este módulo permite que diversas
informações sejam coletadas através de servidores OPC, Drivers da Elipse Software, bancos de dados em geral, ou
até mesmo arquivos de texto e armazenamentos em bancos de dados comerciais, tais como SQL Server e Oracle, por
objetos históricos definidos pelo usuário em uma forma compacta e eficiente.
O armazenamento das informações segue a lógica de que um dado só é gravado quando há uma variação
significativa, definida pelo usuário. A análise das variações é realizada pelo algoritmo BoxCar/BackSlope, que permite,
dependendo das bandas mortas configuradas, uma compactação significativa dos dados com a recuperação total das
informações úteis.
A recuperação dos dados no ambiente do Elipse Power pode ser executada através de uma ferramenta de consulta
padronizada, que permite montar sua estrutura de consulta de forma gráfica, similar à ferramentas como Access ou
SQL Server, ou ainda editar diretamente as consultas SQL. Os dados extraídos podem ser visualizados em formato
tabular (E3Browser), gráficos (E3Chart), relatórios que permitem visualização em tela (usando o método PrintPreview
do Relatório), impressão direta para o papel, ou mesmo exportação para vários formatos, tais como PDF, HTML, TXT,
CSV, TIFF e GIF, entre outros.
A principal função do Storage é permitir a gravação dos dados de forma compacta. Através desta ferramenta é
possível recuperar com grande exatidão todas as mudanças nas variáveis de processo, ocupando assim o mínimo de
espaço no banco de dados. Alguns exemplos são mostrados nos tópicos a seguir.
Gráfico sem Compactação

A informação processada contém vários pontos.
Gráfico sem compactação

Gráfico com Compactação
Veja que a informação é praticamente a mesma, só que com menos pontos.
Storage 364
Gráfico com compactação
A gravação no Storage é realizada da seguinte maneira:
· Após a definição da tabela nas propriedades do Storage, esta é gerada clicando em Gerar Tabela e os dados
são gravados de acordo com estas definições. Se houver variação de qualidade no Tag, os dados também são
gravados
· Os dados só não são gravados se a variação ocorreu em um tempo menor que o mínimo programado no campo
MinRecTime
Para inserir esta ferramenta no Elipse Power, siga este procedimento:

1. Clique com o botão direito do mouse no projeto no modo Explorer e selecione a opção Inserir - Storage. No
modo Domínio, clique com o botão direito do mouse no item Objetos de Servidor - Banco de Dados, selecione
a opção Inserir Storage Em e logo após o nome do projeto desejado.
Inserindo um Storage no modo Domínio
365 Storage
Caso necessite, configure as propriedades do objeto. Algumas das propriedades deste objeto podem ser
configuradas através da Lista de Propriedades, sem a necessidades de criar scripts para isto. Para mais informações,
consulte o Manual de Referência e Scripts do Elipse Power.
NOTA
O objeto Storage pode ser configurado para funcionar como Área de Alarme.
Ao abrir o Editor do Storage, as opções disponíveis para configuração são as mostradas na figura a seguir.
Janela do Editor do Storage

Para adicionar um Campo do Storage, pode-se arrastar e soltar um Tag ou propriedade a partir do Organizer,
selecionar a opção Adicionar na barra de ferramentas ou então clicar com o botão direito do mouse no item
Fields e selecionar a opção Inserir - Campo do Storage.
NOTA
As licenças do Storage são verificadas apenas quando o aplicativo é executado e levam em conta apenas os Campos
do Storage ativos na aplicação, não a quantidade de Campos do Storage existentes no banco de dados.
Para efeitos de posterior consulta nos dados, toda a busca é realizada usando o caminho do Tag ou da propriedade
que está sendo armazenada, definido através da coluna Fonte. A coluna Nome só é utilizada caso a coluna Fonte
contenha uma expressão, como por exemplo Driver1.Tag1 + Driver1.Tag2. Logo, se expressões não estiverem sendo
utilizadas na coluna Fonte, não há necessidade de se importar com o nome do Campo do Storage. As opções
disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis no Editor do Storage
OPÇÃO DESCRIÇÃO
Adicionar Adiciona Campos do Storage na tabela do Storage
Remover Remove o Campo do Storage selecionado da tabela do

Storage
Gerar Estrutura no BD Gera a estrutura no banco de dados
Consulte o tópico Campo do Storage para mais informações sobre as opções disponíveis no Editor do Storage em
relação aos Campos que podem ser inseridos no objeto Fields.
20.1.1 Criando um Storage Vazio

O objeto Storage pode ser criado sem que tenha Campos configurados. Para isto, preencha as propriedades
DBServer e TableName na criação. Esta configuração permite que seja criado um Storage somente para consulta, o
que é bastante útil para acessar dados gerados por aplicativos externos. Algumas restrições se aplicam nesta
situação:
· Embora o Storage seja ativado normalmente, não gera tabelas nem altera índices
· A opção Gerar Tabela na Janela de Propriedades, a opção Gerar Estrutura no DB do menu contextual e a opção
da barra de ferramentas do Storage retornam uma mensagem de erro, indicando que a estrutura do banco
de dados não pode ser criada pois não há Campos definidos
Storage 366
· Um Storage vazio é listado normalmente na caixa de seleção Nome do Servidor de uma Consulta
· Não há necessidade de licenças de Storage para consultar dados externos, somente para escrita de dados
20.2 Configuração da Tabela

Para acessar as configurações da tabela utilizada no Storage, clique com o botão direito do mouse no objeto no
Organizer e selecione a opção Propriedades para abrir a janela da figura a seguir.
Aba Storage
Cada opção da aba Storage possui uma propriedade correspondente. As opções disponíveis nesta aba estão
Opções disponíveis na aba Storage
OPÇÃO DESCRIÇÃO
Servidor de Banco de Dados Define o servidor de Banco de Dados. Esta opção
equivale à propriedade DbServer do Storage
Nome da tabela Determina o nome da tabela. Esta opção equivale à

propriedade TableName do Storage
Descartar dados da tabela principal Habilita ou desabilita o descarte de dados da tabela

principal. Um dado é considerado antigo de acordo com
o que é definido na opção Descartar dados mais
antigos que. Esta opção equivale à propriedade
EnableDiscard do Storage
o intervalo de tempo desta opção, então é descartado.
Storage e a opção de seleção da unidade de tempo do
intervalo equivale à propriedade DiscardTimeUnit do
Storage
367 Storage
OPÇÃO DESCRIÇÃO
de descarte de dados antigos da tabela. Esta opção
equivale à propriedade VerificationUnit do Storage
descartados na tabela secundária ou tabela de backup.
do Storage
opção deve ser igual a 30 meses. Este intervalo deve ser
Storage e a opção de seleção da unidade de tempo do
intervalo equivale à propriedade
BackupDiscardTimeUnit do Storage
Gerar Tabela Gera a estrutura da tabela no Banco de Dados. Esta

opção também está disponível clicando com o botão
direito do mouse no objeto Storage no Organizer e
selecionando a opção Gerar Estrutura no BD
Após definir as configurações da tabela, clique em Gerar Tabela. Esta ação cria a estrutura da tabela no banco de
dados.
A estrutura de tabelas do Storage é semelhante à estrutura do Histórico, com uma tabela de definições, uma tabela
principal de dados e uma tabela de backup, se selecionada pelo usuário. Para que se possa identificar externamente
que é uma tabela compactada, verifique se foi criada a tabela _Fields.
Tabela _Fields
Esta tabela possui os Campos descritos na tabela a seguir.
Storage 368
Campos da tabela _Fields
CAMPO DESCRIÇÃO
FieldDeadBand Banda morta
FieldDeadBandUnit Unidade da banda morta, em porcentagem do valor

anterior ou porcentagem dos limites de engenharia
(valor fixo)
FieldDescription Descrição do Campo
FieldEU Unidade de Engenharia
FieldHighEng Limite superior do Tag
FieldID Índice do Campo cadastrado no Storage
FieldLowEng Limite inferior do Tag
FieldMaxRecTime Depois que este tempo expira, um dado deve ser

automaticamente gravado
FieldMinRecTime Valor mínimo de tempo de variação para armazenar

dados
FieldName Nome do Campo
FieldQuality Qualidade do Campo
FieldScanTimeMs Tempo de varredura que deve ser utilizado para

reconstruir o gráfico do Tag, em milissegundos
FieldSize Tamanho do Campo
FieldSource Associação utilizada para obter valores deste Campo
FieldType Tipo de dados do Campo
FieldVARTYPE Tipo de dados nativo do Campo. Os valores possíveis

são 0: Indefinido, 3: Integer, 5: Double, 8: Text ou 11: Bit
A implementação do Storage permite que um usuário não tenha que se preocupar em como os dados estão
armazenados nas tabelas. Entretanto, para uma melhor compreensão do funcionamento do módulo, e também para
permitir acesso por outros programas, é mostrado a seguir o formato das tabelas.
As opções de gerenciamento de tabelas especificadas no item anterior se aplicam na verdade a três conjuntos de
tabelas geradas pelo Storage, de acordo com a opção Nome de Tabela.
Isto porque, para cada tipo de grandeza armazenada, é gerado automaticamente um conjunto de tabelas, a saber: um
conjunto para os Tags analógicos, outro para os textos e mais outro para os digitais. Desta forma, cada Storage pode
gerenciar até sete tabelas, caso se especifique que os três tipos de Tags devam ser armazenados:
· <NomeTabela>_Fields
· <NomeTabela>
· <NomeTabela>_Text
· <NomeTabela>_Bit
· <NomeTabela>_Backup
· <NomeTabela>_Text_Backup
· <NomeTabela>_Dig_Backup
A tabela _Fields contém a descrição dos Campos que são armazenados, que de forma geral armazenam as mesmas
informações definidas na configuração dos Campos do Storage, além de associar um índice automático para cada
Campo. As demais tabelas possuem um formato fixo:
· E3TimeStamp: Campo que armazena a data e hora em que houve a variação do Tag. Caso o protocolo de
comunicação suporte o envio de informação de tempo, este Campo contém a estampa de tempo do
equipamento
· Qualidade: Contém a informação de qualidade do ponto (Ruim, Incerto ou Bom) de acordo com a utilização
dentro do Elipse Power e das normas OPC
369 Storage
· Índice: Relaciona o Campo gravado com o respectivo nome armazenado na tabela _Fields
· Valor: Valor armazenado. Para a tabela de analógicos trata-se de um Campo do tipo Double, ou um número
real. Já para a tabela de digitais trata-se de um número inteiro e para os textos trata-se de um Campo do tipo
NVARCHAR de tamanho variável, especificado pelo usuário no Campo StringFieldSize
20.2.1 Execução
Ao iniciar a execução de uma aplicação e receber a primeira notificação de valor de cada uma das variáveis
armazenadas, o Storage armazena este valor obtido com qualidade Ruim, e logo em seguida com a qualidade
enviada, se esta é Boa. Isto porque ao realizar a consulta, o usuário tem a visualização de que houve uma interrupção
no armazenamento.
Depois, conforme sejam obtidos novos valores para as variáveis, um algoritmo de verificação de gravação interpreta
a sequência e decide se cada ponto é ou não armazenado. Este algoritmo, conhecido como BoxCar/BackSlope, cria
duas bandas de variação, cuja amplitude é dada pela banda morta da variável, de um ponto gravado. A banda
horizontal (BoxCar) define uma verificação comum da banda morta. Uma segunda banda diagonal (BackSlope) define
uma variação para cima ou para baixo da banda morta.
Portanto, se a variável está em uma derivativa contínua descendente ou ascendente, só é necessário armazenar os
pontos iniciais ou finais nesta linha reta. Assim, uma variável analógica só é gravada se o valor viola tanto a banda
horizontal quanto a vertical, ou se houve uma mudança na qualidade, ou seja, o equipamento foi ligado ou desligado.
Exemplo do algoritmo BoxCar/BackSlope

Esta verificação, entretanto, só ocorre para os Campos analógicos. Para os Campos de texto e digitais, basta que haja
uma mudança qualquer de valor ou qualidade, como por exemplo a perda de comunicação, para que sejam
gravados.
20.2.2 Ferramentas de Consultas Internas

A ferramenta Consulta provê algumas facilidades para realizar consultas nos dados do Storage.
Ao iniciar a configuração de uma Consulta em uma aplicação que possui um Storage, este objeto entra na lista de
bancos de dados disponíveis para consulta. Isto porque o Storage atua como um novo provedor de dados, criando
facilidades para que usuários consultem os dados nas tabelas temporais.
Entretanto, nada impede que usuários realizem as consultas diretamente no banco de dados de origem, de acordo
com os formatos das tabelas já mencionado. A desvantagem neste caso é que o processo de consulta é mais
complexo.
Portanto, uma vez selecionado o próprio Storage como provedor de dados para uma Consulta, a interface de
configuração apresenta algumas diferenças, conforme a figura a seguir.
Storage 370
Janela de consulta do Storage
As opções disponíveis na aba Campos estão descritas na tabela a seguir.
Opções disponíveis na aba Campos
OPÇÃO DESCRIÇÃO
Funções Permite selecionar uma função para consolidação de
dados. Consulte a tabela a seguir para mais informações
sobre as funções disponíveis nesta opção
Selecione abaixo o(s) campo(s) que faz(em) parte da Permite selecionar um Campo ou Campos para
consulta visualização no resultado da Consulta
Colunas Permite selecionar o Campo correspondente a cada

coluna do resultado, de acordo com a seleção da opção
anterior
Título Permite especificar um título para a coluna selecionada
Filtro Permite especificar um filtro para os dados retornados

por uma coluna da Consulta. Para mais informações
sobre o formato de um filtro, consulte o tópico
Utilização
Incluir qualidade RUIM Permite indicar se dados com qualidade ruim são
incluídos no resultado. Esta opção corresponde à
propriedade IgnoreQuality da Consulta associada ao
Storage
As funções para consolidação de dados disponíveis na opção Funções estão descritas na tabela a seguir.
Funções disponíveis para consolidação de dados
FUNÇÃO DESCRIÇÃO
LastValue Retorna o último valor armazenado no banco de dados
371 Storage
FUNÇÃO DESCRIÇÃO
ArchivedValue Retorna um valor armazenado em relação a um
determinado instante de tempo definido na variável
TimeStamp. O tipo de relação, definido na propriedade
FunctionSubType da Consulta, pode ser Previous, um
valor armazenado imediatamente antes da estampa de
tempo fornecida, Interpolated, um valor calculado a
partir dos valores anterior e posterior, Next, um valor
armazenado imediatamente após a estampa de tempo,
ou ExactTime, um valor armazenado no exato instante
fornecido pela estampa de tempo
TagAttribute Devolve um atributo de um Tag, definido na propriedade

FunctionSubType da Consulta. As opções disponíveis
são FieldDescription, o significado ou descrição do Tag,
FieldSource, o caminho do Tag armazenado, FieldType,
o tipo de dados, FieldEU, a unidade de engenharia,
FieldLowEng, o limite inferior de engenharia,
FieldHighEng, o limite superior de engenharia,
FieldDeadBand, a banda morta para gravação,
FieldDeadBandUnit, a unidade de banda morta (em
valores absolutos ou em porcentagem),
FieldMinRecTime, o tempo mínimo para gravação
(variações menores que este intervalo são desprezadas),
FieldMaxRecTime, o tempo máximo para gravação (a
ausência de variação nestes intervalos força uma
gravação), FieldSize, o tamanho do Campo,
FieldVARTYPE, o tipo de dados nativo do Campo, ou
FieldScanTimeMs, o tempo de varredura utilizado para
reconstruir o gráfico do Tag
CompressedDataNValues Retorna, para um único Tag, N valores definidos na

variável NumVals, armazenados a partir de um instante
inicial, definido na variável StartTime
CompressedDataStartEndTime Retorna, para um único Tag, os valores armazenados

que estão entre o intervalo definido pelas variáveis
StartTime e EndTime
SampledData Retorna, para um ou mais Tags, os valores interpolados,

ou seja, estimados entre os instantes definidos pelas
variáveis StartTime e EndTime, a intervalos fixos definidos
pela variável TimeInterval
CalculatedData Retorna, para um ou mais Tags, o resultado de

operações matemáticas aplicadas aos dados entre os
instantes definidos pelas variáveis StartTime e EndTime, a
intervalos fixos definidos pela variável TimeInterval. Os
tipos de cálculos disponíveis são Total, Minimum
(mínimo), Maximum (máximo), StandardDeviation
(desvio padrão), Range (amplitude), Average (média) ou
Mean (mediana)
Storage 372
NOTAS
· Apenas as funções SampledData e CalculatedData permitem a seleção de mais de um Campo. Todas as outras
funções exigem que apenas um Campo seja selecionado.
· As funções que permitem a definição de variáveis na aba Variáveis podem também definir estas variáveis em
tempo de execução utilizando o método SetVariableValue da Consulta. A única função que não define variáveis é
TagAttribute.
· Para mais informações sobre o funcionamento das abas Variáveis e Visualizar, consulte o tópico Criando uma
Consulta.
· Para mais informações sobre os valores retornados pelas opções FieldType e FieldVARTYPE da função
TagAttribute, consulte a tabela Campos da tabela _Fields.
20.2.3 Utilização
Se a função selecionada na opção Funções da aba Campos permite especificar variáveis, então é preciso informar o
valor destas variáveis na aba Variáveis ou usando o método SetVariableValue da Consulta em tempo de execução,
conforme o exemplo a seguir.
Set Chart = Screen.Item("E3Chart1")
Set Query = Chart.Item("Consulta1")
Query.SetVariableValue "StartTime", Chart.DataIni
Query.SetVariableValue "EndTime", Chart.DataFim
Query.SetVariableValue "TimeInterval",_
rs.Fields("SampleInterval").Value
Chart.Queries.UpdateData()
Além das variáveis, pode-se também definir um filtro específico para cada coluna retornada pela Consulta na coluna
Filtro da aba Campos. Para especificar, por exemplo, que uma determinada coluna deve retornar apenas valores
maiores ou iguais a 1 (um) e menores que 5 (cinco), preencha a coluna Filtro com a expressão ">= 1 and < 5".
20.2.4 Ferramentas de Consultas Externas

Quando se desenvolve uma aplicação externa em linguagens de programação como Java, Visual Basic ou C++, e se
deseja obter os dados armazenados pelo Storage, é possível realizar chamadas a Procedimentos Armazenados
(Stored Procedures), que são criados pelo Storage em um banco de dados. Os Procedimentos Armazenados que
correspondem às opções de Consulta estão descritos na tabela a seguir.
Opções de consultas disponíveis
FUNÇÃO DE CONSULTA PROCEDIMENTO ARMAZENADO
LastValue E3LastValueEx
ArchivedValue E3ArchiveEx, E3ArchiveInterpolate
CompressedDataNValues E3NCompDataEx
CompressedDataStartEndTime E3CompDataEx
SampledData E3SampledData
CalculatedData E3CalculatedData
Os Procedimentos Armazenados que utilizam parâmetros de tipo Data recebem este parâmetro na chamada como
um número Float (ponto flutuante), ao invés de DateTime. Isto permite aumentar a precisão do Elipse Power, já que
ao utilizar o formato DateTime a precisão máxima é de 3 ms, ao invés de 1 ms com o tipo Float.
Para facilitar a passagem de parâmetros, pode-se adicionar ao banco de dados uma função do usuário 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
Os tópicos a seguir contêm informações sobre os Procedimentos Armazenados criados pelo Storage.
373 Storage
NOTA
O Procedimento Armazenado E3RawData, que retorna os dados sem agregações, não está disponível como opção
no item Funções da aba Campos da Consulta associada ao Storage.
20.2.4.1 E3ArchiveEx
Retorna um valor armazenado em relação a um instante, conforme exposto na função ArchivedValue. É usado
somente para os subtipos Previous (0), Next (2) e ExactTime (3). A descrição formal é a seguinte:
E3ArchiveEx(
@iSubType int,
@strTableName VARCHAR(100),
@strAliasName VARCHAR(100),
@dDate float,
@strFilter VARCHAR(500),
@bQuality int)
Onde:
· @iSubType: Subtipo da função. Os valores possíveis são 0: Anterior, 2: Próximo ou 3: Instante exato
· @strTableName: Nome da tabela a ser consultada
· @strAliasName: Título para a coluna FieldValue
· @dDate: Instante no tempo para a busca, no formato Float
· @strFilter: Opções de filtro para o valor
· @bQuality: Se diferente de 0 (zero), somente inclui Tags com qualidade Boa
Este Procedimento Armazenado retorna apenas uma linha de resultado com as colunas E3TimeStamp, Quality e
FieldValue.
20.2.4.2 E3ArchiveInterpolate
Retorna os pontos imediatamente anteriores e posteriores a um instante, conforme exposto para a função
ArchivedValue, porém somente para o subtipo Interpolated (interpolado). A descrição formal é a seguinte:
E3ArchiveInterpolate(
@dDate float,
@type int,
@bQuality int)
Onde:
· @type: Tipo de dados. Os valores possíveis são 0: String, 1: Bit ou Integer ou 2: Analógico
Este Procedimento Armazenado retorna apenas uma linha de resultado com as colunas E3TimeStamp e FieldValue.
20.2.4.3 E3CalculatedData
Equivale à função CalculatedData. A descrição formal é a seguinte:
E3CalculatedData(
@iSubType int,
@iModMin int,
@dStartDate float,
@dEndDate float,
@strWhere VARCHAR(4000),
@type int,
@bQuality int)
Onde:
Storage 374
· @iSubType: Subtipo do cálculo. Os valores possíveis são 0: Total, 1: Mínimo, 2: Máximo, 3: Desvio padrão, 4:
Amplitude, 5: Média ou 6: Mediana
· @iModMin: Intervalo de tempo, em segundos, que o Procedimento Armazenado deve utilizar para realizar
totalizações e agrupamentos
· @dStartDate: A data inicial, em formato Float
· @dEndDate: A data final, em formato Float
· @strWhere: Opções de filtro para o valor
Este Procedimento Armazenado retorna os resultados com as colunas E3TimeStamp e FieldValue.
20.2.4.4 E3CompDataEx
Equivale à função CompressedDataStartEndTime. A descrição formal é a seguinte:
E3CompDataEx(
@dStartDate float,
@dEndDate float,
@strOrder VARCHAR(100),
@bQuality int)
Onde:
· @strOrder: Opções de ordenação do resultado por um campo diferente de E3TimeStamp
Este Procedimento Armazenado retorna os valores encontrados, no intervalo especificado, com as colunas
E3TimeStamp, Quality e FieldValue.
20.2.4.5 E3LastValueEx
Retorna o último valor de um determinado Tag que está armazenado no banco de dados. A descrição formal é a
seguinte:
E3LastValueEx(
@bQuality int)
Onde:
Este Procedimento Armazenado retorna apenas uma linha de resultado com as colunas E3TimeStamp, Quality e
FieldValue.
20.2.4.6 E3NCompDataEx
Equivale à função CompressedDataNValues. A descrição formal é a seguinte:
E3NCompDataEx(
@dDate float,
@iNValues int,
375 Storage
@strOrder VARCHAR(100),
@bQuality int)
Onde:
· @iNValues: O número de valores desejados
Este Procedimento Armazenado retorna os valores solicitados, se encontrados, com as colunas E3TimeStamp,
Quality e FieldValue.
20.2.4.7 E3RawData
Retorna os valores de uma tabela sem agregações. A descrição formal é a seguinte:
E3RawData(
@strTable NVARCHAR(100),
@dStartDate float,
@dEndDate float,
@strFilter NVARCHAR(4000),
@strOrder NVARCHAR(100))
Onde:
· @strTable: Nome da tabela a ser consultada
Este Procedimento Armazenado retorna os resultados com as colunas E3TimeStamp, Quality e FieldValue.
NOTA
Este Procedimento Armazenado não está disponível no item Funções da aba Campos da Consulta associada ao
Storage.
20.2.4.8 E3SampledData
Equivale à função SampledData. A descrição formal é a seguinte:
E3SampledData(
@strTable VARCHAR(100),
@iModMin int,
@dStartDate float,
@dEndDate float,
@strWhere VARCHAR(4000),
@type int,
@bQuality int)
Onde:
· @strTable: Nome da tabela a ser consultada
· @iModMin: Intervalo em segundos para a interpolação de cada valor dentro do intervalo
· @strWhere: Opções de filtro para o valor
Storage 376
Este Procedimento Armazenado retorna os resultados com as colunas E3TimeStamp e FieldValue.
20.3 Objeto Fields

O objeto Fields representa uma coleção de Campos de um Storage em uma tabela. Este objeto é criado
automaticamente ao adicionar um Storage na aplicação.
Para inserir novos Campos, clique com o botão direito do mouse no objeto Fields e selecione a opção Inserir -
Campo do Storage. Para remover um Campo, clique com o botão direito do mouse no Campo e selecione a opção
Deletar.
NOTAS
· Em aplicações criadas antes da versão 5.0 do Elipse Power, a propriedade Fields do Storage é uma coleção que
suporta o método Item para acessar os Campos disponíveis. A partir da versão 5.0, esta propriedade também
retorna o objeto Fields, e portanto a forma de acesso aos Campos é diferente para ambas as formas. O exemplo
a seguir demonstra a forma correta de utilização como objeto e como coleção em um script.
· Aplicações salvas na versão 5.0 convertem os objetos Storage do formato de coleção para objeto e NÃO podem
mais ser abertas em versões anteriores.
Para acessar a coleção de Campos do Storage tanto como uma coleção quanto como um objeto, use os formatos
descritos no exemplo a seguir.
'A aplicação contém um objeto chamado Storage1
'que contém um Campo chamado Campo1
'Para acessar este Campo como coleção,
'use a sintaxe a seguir
Set campoColecao = Application.GetObject("Storage1").Fields.Item("Campo1")
'Para acessar o mesmo Campo como objeto,
'use a sintaxe a seguir
Set campoNativo = Application.GetObject("Storage1.Fields.Campo1")
Consulte o tópico a seguir, Campo do Storage, para mais informações sobre as propriedades dos Campos do
Storage existentes no objeto Fields.
20.4 Campo do Storage

Um objeto Campo do Storage representa um Campo na tabela do Storage em um banco de dados. As opções
disponíveis para configuração de um Campo do Storage estão descritas na tabela a seguir.
Opções disponíveis para Campos do Storage
OPÇÃO DESCRIÇÃO
Nome Determina o nome do Campo do Storage da tabela do
Storage. Esta opção corresponde à propriedade Name
do Campo do Storage
Fonte Determina a fonte de dados associada ao Campo do

Storage. Esta opção é somente de leitura e corresponde
à propriedade Link do Campo do Storage
Tipo Determina o tipo de dados deste Campo do Storage na

tabela do Storage. Os valores possíveis para esta opção
são 0: eStorageDouble, 1: eStorageBit, 2: eStorageText
ou 3: eStorageInteger. Se este valor é alterado para
eStorageBit, eStorageText ou eStorageInteger, as
opções MinRecTime, MaxRectTime, Varredura, Banda
Morta e Unidade permanecem desabilitadas. Esta opção
corresponde à propriedade Type do Campo do Storage
MinRecTime Diferença mínima, em milissegundos, entre as estampas

de tempo de dois registros quaisquer de mesma
qualidade, isto é, o tempo mínimo para que um novo
dado seja gravado. Esta opção corresponde à
propriedade MinRecTime do Campo do Storage
377 Storage
OPÇÃO DESCRIÇÃO
MaxRecTime Diferença máxima, em segundos, entre as estampas de
tempo de dois registros consecutivos, isto é, o tempo
máximo sem que nenhum dado seja gravado. Ao passar
este tempo, este dado é considerado antigo e é
armazenado. Esta opção corresponde à propriedade
MaxRecTime do Campo do Storage
Varredura Tempo de varredura do Campo do Storage, ou seja, de

quanto em quanto tempo o valor do Tag é realimentado
no algoritmo de compactação de dados. Se este valor é
igual a 0 (zero), esta coluna permanece desabilitada e
mostra o valor definido em MaxRecTime, em
milissegundos. Esta opção corresponde à propriedade
ScanTime do Campo do Storage
Banda Morta Banda morta utilizada para cálculo do algoritmo de

compactação de dados. Indica a precisão que o usuário
está disposto a perder em cada Campo do Storage a ser
armazenado. Esta opção corresponde à propriedade
DeadBand do Campo do Storage
Unidade Unidade da opção Banda Morta. Este valor pode ser

especificado em unidades absolutas ou como uma
porcentagem do valor atual do Tag. Esta opção
corresponde à propriedade DeadBandUnit do Campo
do Storage
Storage 378
CAPÍTULO
Histórico
21
Históricos são módulos responsáveis pelo armazenamento de dados de uma aplicação em um banco de dados.
Permitem armazenar dados de processos para análises futuras. Pode-se criar tantos arquivos de Históricos quantos
se desejar, cada um contendo diversos Tags ou expressões. Cada Histórico pode criar ou utilizar uma tabela
independente dentro do banco de dados, cujo armazenamento pode ser definido por Tempo ou por Evento. Através
da propriedade CacheSize, define-se o número de registros enviados por vez para o banco de dados. Conforme a
definição da propriedade DBServer, define-se o Servidor do Banco de Dados que é utilizado pelo Histórico. Para
Histórico. No modo Domínio, clique com o botão direito do mouse no item Objetos de Servidor - Banco de
Dados, selecione a opção Inserir Histórico em e logo após o nome do projeto desejado.
Inserindo um Histórico no modo Domínio
2. Quando o Editor do Histórico é aberto, as opções de configuração da figura a seguir são mostradas.
Objeto Histórico
As opções disponíveis na barra de ferramentas do Editor estão descritas na tabela a seguir.
379 Histórico
Opções disponíveis na barra de ferramentas do Editor do Histórico
OPÇÃO DESCRIÇÃO
Adicionar Adiciona um objeto Indexes ou PrimaryKey caso esteja
selecionado o Histórico, um Campo de Histórico na
tabela do Histórico caso esteja selecionado o objeto
Fields, um Índice de Histórico caso esteja selecionado o
objeto Indexes ou um Campo de Chave Primária caso
esteja selecionado o objeto PrimaryKey
Remover Remove os objetos Indexes, PrimaryKey, Campo de

Histórico, Índice de Histórico ou Campo de Chave
Primária selecionados no Histórico
Gerar Estrutura no BD Gera a estrutura no Banco de Dados
Buscar Campos da Tabela Original Busca os Campos de Histórico na tabela original.

Consulte o tópico Configurações da Tabela para mais
informações
Manter Histórico Sem Vínculo Direto com Tabela Já Mantém o Histórico sem vínculos diretos com uma
Existente tabela existente. Consulte o tópico Configurações da
Tabela para mais informações
Vincular Histórico a uma Tabela Já Existente Vincula o Histórico a uma tabela já existente. Consulte o
tópico Configurações da Tabela para mais informações
Consulte o tópico Campo de Histórico para mais informações sobre as opções disponíveis no Editor do Histórico em
relação aos Campos que podem ser inseridos no objeto Fields . Consulte o tópico Objeto Indexes para mais
informações sobre os índices que podem ser inseridos no Histórico e o tópico Objeto PrimaryKey para mais
informações sobre as chaves primárias que podem ser inseridas no Histórico.
3. Abra a Janela de Propriedades do Histórico. Para isto, clique com o botão direito do mouse no objeto e selecione
a opção Propriedades. Algumas das propriedades deste objeto podem ser configuradas através da Lista de
Propriedades, sem a necessidade da criação de scripts para isto. Caso seja necessário configurar alguma
propriedade, localize-a na Lista de Propriedades e execute os devidos ajustes. Demais informações sobre as
funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referência e Scripts do
Elipse Power, no capítulo referente ao objeto Histórico.
NOTAS
· O objeto Histórico pode ser configurado para funcionar como Área de Alarme.
· Históricos criados na versão 5.0 ou posteriores não podem ser abertos em versões anteriores.
· Históricos criados em versões anteriores à versão 5.0 podem ser abertas normalmente na versão 5.0 ou
posteriores mas, ao serem salvos, NÃO PODEM mais ser abertos em versões anteriores.
Quando um Histórico é inserido no projeto, o Campo E3TimeStamp é criado automaticamente no objeto Fields. Este
Campo mostra a data e hora em que o valor é buscado, diferente da estampa de tempo do Tag. Vale lembrar que
este Campo é utilizado somente para leitura e é possível associar um Tag a este Campo. Se não houver uma
Associação, este Campo busca a hora atual do sistema operacional para a gravação.
NOTA
O uso da hora atual do sistema operacional para a gravação do Campo E3TimeStamp só está disponível quando a
tabela é criada pelo Histórico. No caso de utilizar uma tabela já existente, é necessário associar um Tag do tipo
Demo com a propriedade Type configurada como 3 - Current Time para que este Campo registre a data e hora
corretamente.
Para criar uma tabela no Histórico, é importante que seus Campos sejam previamente criados clicando-se em
Adicionar na barra de ferramentas do Histórico ou clicando com o botão direito do mouse no objeto Fields e
selecionando a opção Inserir - Campo de Histórico. Para remover um Campo, selecione-o e clique em Remover
Histórico 380
na barra de ferramentas do Histórico ou clique com o botão direito do mouse em um Campo e selecione a opção
Deletar. A mensagem de confirmação da figura a seguir é mostrada.
Mensagem para confirmar a exclusão de um Campo da tabela
NOTA
Os Campos de Histórico podem ser reordenados no Editor do Histórico arrastando o Campo para uma nova
posição. Esta operação afeta o índice do Campo na coleção de Campos retornada pelo objeto Fields, ou seja, ao
usar o método Item.
Consulte o tópico Campo de Histórico para mais informações sobre as propriedades de um objeto Campo de
Histórico.
21.1.1 Configurações da Tabela

Depois de definidas as opções descritas anteriormente, é necessário configurar as informações da tabela do Histórico
e gerar a estrutura no Banco de Dados. Para isto, clique com o botão direito do mouse no Histórico, selecione a
opção Propriedades e selecione a aba Histórico, conforme a figura a seguir.
Aba Histórico
Cada opção da aba Histórico possui uma propriedade correspondente. As opções disponíveis nesta aba estão
381 Histórico
Opções disponíveis na aba Histórico
OPÇÃO DESCRIÇÃO
Servidor de Banco de Dados Define o servidor de Banco de Dados. Esta opção
equivale à propriedade DbServer do Histórico
Nome da tabela Determina o nome da tabela. Esta opção equivale à

propriedade TableName do Histórico
Intervalo entre registros (ms) Determina a variação do intervalo de tempo em

milissegundos, ou seja, de quanto em quanto tempo os
dados do Histórico são gravados na tabela. Esta opção
equivale à propriedade ScanTime do Histórico
Descartar dados da tabela principal Habilita ou desabilita o descarte dos dados da tabela
principal. Um dado é antigo de acordo com o que é
definido na opção Descartar dados mais antigos que.
Esta opção equivale à propriedade EnableDiscard do
Histórico
Histórico e a opção de seleção da unidade de tempo do
intervalo equivale à propriedade DiscardTimeUnit do
Histórico

de descarte de dados antigos da tabela. Esta opção
equivale à propriedade VerificationUnit do Histórico
descartados na tabela secundária, ou tabela de backup.
do Histórico
Histórico e a opção de seleção da unidade de tempo do
intervalo equivale à propriedade
BackupDiscardTimeUnit do Histórico
Gerar Tabela Gera a estrutura da tabela no Banco de Dados. Esta

opção também está disponível clicando com o botão
direito do mouse no objeto Histórico no Organizer e
selecionando a opção Gerar Estrutura no BD
Ao clicar em Gerar Tabela, o Elipse Power Studio mostra a caixa de diálogo da figura a seguir.
Histórico 382
Mensagem do Elipse Power Studio
Quando a opção Gerar Tabela é utilizada, a tabela especificada no Histórico é gerada, além de uma tabela _Fields.
Esta tabela possui as informações de cada Campo cadastrado no Histórico.
Tabela de campos
Os Campos disponíveis na tabela _Fields do Histórico estão descritos na tabela a seguir.
Campos da tabela _Fields do Histórico
CAMPO DESCRIÇÃO
FieldDeadBand Banda morta
FieldDeadBandUnit Unidade utilizada pela banda morta, em valores

absolutos ou em porcentagem
FieldDescription Descrição do Campo
FieldEU Unidade de engenharia
FieldHighEng Limite superior do Tag
FieldID Índice do Campo cadastrado no Histórico
FieldLowEng Limite inferior do Tag
FieldMaxRecTime Depois que este tempo expira, este dado deve ser
automaticamente gravado
FieldMinRecTime Valor mínimo de tempo de variação para

armazenamento de um dado
FieldName Nome do Campo do Histórico
383 Histórico
CAMPO DESCRIÇÃO
FieldQuality Tipo da qualidade do Campo. As opções disponíveis são
0: Sem qualidade, 1: Método anterior à versão 1.21, em
que 0 (zero) é um valor duvidoso e 1 (um) é um valor
bom ou 2: Qualidade real do Tag
FieldScanTimeMs Tempo de varredura que deve ser utilizado para

reconstruir o gráfico do Tag, em milissegundos
FieldSize Tamanho do Campo
FieldSource Associação utilizada pelo Campo para obter os seus

valores
FieldType Tipo de dados do Campo
FieldVARTYPE Tipo de dados nativo do Campo. As opções disponíveis

são 0: Indefinido, 3: Integer, 5: Double, 8: Text ou 11: Bit
A opção Vincular Histórico a uma Tabela Já Existente vincula o Histórico a tabelas existentes no Banco de
Dados. Quando esta opção é habilitada, o Elipse Power Studio abre uma caixa de diálogo para determinar quais as
tabelas são vinculadas ao Histórico corrente, conforme a figura a seguir.
Seleção de tabela para vincular ao

Histórico
Quando uma tabela é selecionada e clica-se em OK, o Elipse Power Studio mostra a mensagem da figura a seguir.
Removendo o vínculo de uma tabela do Histórico

Clicando em Cancel, os Campos configurados na tabela permanecem com as configurações atuais. Já clicando em OK,
todos os Campos, Índices e Chaves Primárias definidos no Histórico são substituídos pelos dados da tabela
selecionada.
Quando este item é utilizado, outras duas opções são habilitadas, Manter Histórico sem Vínculo Direto com Tabela
Já Existente e Buscar Campos da Tabela Original .
Histórico 384
Quando a opção Manter Histórico sem Vínculo Direto com Tabela Já Existente é habilitada, o Elipse Power
Studio mostra a mensagem da figura a seguir.
Transformando um Histórico em um Histórico do usuário

Clicando em Cancel, a tabela permanece com as configurações atuais. Já clicando em OK, a tabela é reinicializada com
seus Campos iniciais, somente com o Campo padrão habilitado, ou seja, E3TimeStamp.
Histórico após habilitar a opção Manter Histórico sem Vínculo Direto com Tabela Já
Existente
Já a opção Buscar Campos da Tabela Original recupera os dados do Histórico vinculado à tabela existente, que
haviam sido apagados.
Histórico utilizando a opção Buscar Campos da Tabela Original
21.2 Objeto Fields

O objeto Fields representa uma coleção de Campos de um Histórico em uma tabela. Este objeto é criado
automaticamente ao adicionar um Histórico na aplicação, e contém um Campo chamado E3TimeStamp, que
representa a estampa de tempo em que o valor do registro foi buscado.
Para inserir novos Campos, clique com o botão direito do mouse no objeto Fields e selecione a opção Inserir -
Campo de Histórico ou selecione o objeto Fields e clique em Adicionar - Campo de Histórico na barra de
ferramentas do Histórico. Para remover um Campo, clique com o botão direito do mouse no Campo e selecione a
opção Deletar ou selecione um Campo e clique em Remover na barra de ferramentas do Histórico.
385 Histórico
NOTAS
· O Campo E3TimeStamp é somente para leitura e não pode ser removido do objeto Fields.
· É possível arrastar e soltar Campos de Histórico de um Histórico para outro. Entretanto, a propriedade
PrimaryKey de um Campo de Histórico não é persistida após copiar este Campo dentro de um mesmo Histórico,
pois esta propriedade é uma informação do Histórico e não do Campo.
· Em aplicações criadas antes da versão 5.0 do Elipse Power, a propriedade Fields do Histórico é uma coleção
padrão, que suporta o método Item para acessar os Campos disponíveis. A partir da versão 5.0, esta propriedade
também retorna o objeto Fields, nativo do Elipse Power, e portanto a forma de acesso aos Campos é diferente
para ambas as formas. O exemplo a seguir demonstra a forma correta de utilização como objeto nativo e como
coleção em um script.
· Aplicações salvas na versão 5.0 convertem os objetos Histórico do formato de coleção para objeto nativo e NÃO
podem mais ser abertas em versões anteriores.
Para acessar a coleção de Campos de Histórico tanto como uma coleção quanto como um objeto nativo, use os
formatos descritos no exemplo a seguir.
'A aplicação contém um objeto chamado Hist1
'que contém um Campo chamado Campo1.
'Para acessar este Campo como coleção,
'use a seguinte sintaxe:
Set campoColecao = Application.GetObject("Hist1").Fields.Item("Campo1")
'Para acessar o mesmo Campo como objeto nativo,
'use a seguinte sintaxe:
Set campoNativo = Application.GetObject("Hist1.Fields.Campo1")
Consulte o tópico Campo de Histórico para mais informações sobre as propriedades dos Campos de Histórico
existentes em um objeto Fields.
21.2.1 Campo de Histórico

Um objeto Campo de Histórico representa um Campo na tabela do Histórico em um banco de dados, conforme a
figura a seguir.
Campos de Histórico
As opções disponíveis para configuração de um Campo de Histórico estão descritas na tabela a seguir.
Opções disponíveis para Campos de Histórico
OPÇÃO DESCRIÇÃO
Nome Nome deste Campo de Histórico na tabela do Histórico.
Esta opção corresponde à propriedade Name do
Campo de Histórico
Histórico 386
OPÇÃO DESCRIÇÃO
Chave Primária Indica se este Campo de Histórico é usado na definição
da chave primária na tabela do Histórico. Esta opção
corresponde à propriedade PrimaryKey do Campo de
Histórico. Consulte o tópico Campo de Chave Primária
para mais informações. Selecionar esta opção
automaticamente cria um objeto PrimaryKey e seu
respectivo objeto Campo de Chave Primária. Desmarcar
esta opção remove o Campo de Chave Primária mas
mantém o objeto PrimaryKey
Tipo Tipo de dados deste Campo de Histórico na tabela do

Histórico. As opções disponíveis são 0: fdText, 1:
fdInteger, 2: fdDouble ou 3: fdDateTime. Esta opção
corresponde à propriedade Type do Campo de
Histórico
Fonte Fonte de dados deste Campo de Histórico na tabela do

Histórico. Esta opção corresponde à propriedade Link
do Campo de Histórico
Tamanho Tamanho deste Campo de Histórico na tabela do

Histórico. Esta opção corresponde à propriedade Size
do Campo de Histórico
NOTA
As opções Campo e Ordem não estão disponíveis para edição nos Campos de Histórico. Estas opções só estão
disponíveis para os objetos Campo de Índice e Campo de Chave Primária.
21.3 Objeto Indexes

O objeto Indexes representa uma coleção de Índices de um Histórico em uma tabela do banco de dados, que
melhoram a performance das consultas que utilizam este Índice. Índices são utilizados para encontrar registros com
um valor específico em uma coluna rapidamente. Sem um Índice, o Banco de Dados tem de iniciar com o primeiro
registro e depois ler através de toda a tabela até que encontre os registros relevantes. Quanto maior a tabela, maior
o custo desta operação. Se a tabela possui um Índice para as colunas em questão, o Banco de Dados pode
rapidamente obter uma posição para procurar no meio do arquivo de dados sem ter que varrer toda a tabela,
portanto otimizando o acesso aos registros.
Todos os tipos de colunas de uma tabela podem ser indexados. O uso de Índices nas colunas relevantes é a melhor
forma de melhorar a performance da tabela. O número máximo de Índices por tabelas e o tamanho máximo de um
Índice é definido pelo mecanismo de armazenamento do Servidor de Banco de Dados. Pode-se criar Índices em
múltiplas colunas, que podem ser considerados vetores ordenados contendo valores que são criados concatenando-
se valores de colunas indexadas.
Para inserir um objeto Indexes em um Histórico, clique com o botão direito do mouse no Histórico e selecione a
opção Adicionar - Indexes. Consulte o tópico Índice de Histórico para mais informações sobre os Índices que
podem ser inseridos neste objeto e consulte o tópico Campo de Índice para mais informações sobre os Campos que
podem ser inseridos nos Índices.
21.3.1 Índice de Histórico

O objeto Índice de Histórico representa um Índice de um Histórico em uma tabela do banco de dados. Para
inserir um objeto Índice de Histórico, clique com o botão direito do mouse no objeto Indexes e selecione a opção
Inserir - Índice de Histórico ou selecione o objeto Indexes e clique em Adicionar - Índice de Histórico na barra
de ferramentas do Histórico. Consulte o tópico Campo de Índice para mais informações sobre os Campos que
podem ser inseridos neste objeto.
21.3.2 Campo de Índice

O objeto Campo de Índice representa um Campo em um Índice de Histórico. Para inserir um objeto Campo de
Índice, clique com o botão direito do mouse em um objeto Índice de Histórico e selecione a opção Inserir - Campo
de Índice ou selecione um objeto Índice de Histórico e clique em Adicionar - Campo de Índice na barra de
ferramentas do Histórico. Ao inserir um Campo de Índice, a janela da figura a seguir é aberta para a seleção dos
387 Histórico
Campos ainda não selecionados na tabela do Histórico. Caso haja apenas um Campo não selecionado, a janela da
figura a seguir não é mostrada e este Campo é adicionado automaticamente. Caso não haja nenhum Campo não
selecionado, é criado um Campo com a coluna Campo vazia e a coluna Ordem com o valor foAscending.
Janela de seleção de um Campo para o Índice

Um Campo de Índice, após inserido, pode ter apenas as colunas Campo e Ordem alteradas. A coluna Campo, que
corresponde à propriedade Field deste objeto, permite selecionar o Campo do Histórico que faz parte deste Índice e
a coluna Ordem, que corresponde à propriedade Order deste objeto, permite alterar a ordenação deste Campo no
Índice, seja ascendente (foAscending) ou descendente (foDescending), conforme a figura a seguir.
Configuração dos Campos de Índices

Ao atualizar o nome de um Campo de Histórico no objeto Fields, a coluna Campo do objeto Campo de Índice
correspondente é atualizada automaticamente. Ao remover um Campo de Histórico do objeto Fields, a janela da
figura a seguir é mostrada, solicitando a confirmação desta operação. Caso o usuário clique em Sim, o Campo de
Histórico e o Campo de Índice são removidos, além dos dados correspondentes na tabela do banco de dados.
Confirmação de exclusão de um Campo de Histórico
21.4 Objeto PrimaryKey

O objeto PrimaryKey representa uma coleção de Campos que identifica de maneira única cada registro de uma
tabela. Assim como o índice principal para a tabela, uma Chave Primária é utilizada para associar dados entre tabelas.
Alguns exemplos de chaves primárias são códigos de clientes, CNPJ, número de matricula, etc. Após a definição de um
Campo como sendo a Chave Primária da tabela, o próprio Banco de Dados garante que não sejam inseridos dados
duplicados neste Campo. Por exemplo, se o usuário tentar cadastrar um pedido com o mesmo número de um pedido
já existente, o registro não é cadastrado e uma mensagem de erro é mostrada. Há dois tipos de Chave Primárias, a
Simples e a Composta.
Histórico 388
Uma Chave Primária Simples é um Campo que identifica de modo único cada registro de uma tabela. Uma Chave
Primária Composta pode ser formada pela combinação de dois ou mais Campos da tabela. Podem existir casos em
que um único Campo não é capaz de atuar como Chave Primária por apresentar valores repetidos. Além disto, uma
tabela pode ter somente uma Chave Primária, seja simples ou composta, ou seja, não se pode definir dois ou mais
Campos de uma tabela para que cada um seja uma Chave Primária separada. Não confunda com o caso de uma
Chave Primária composta, onde a união de dois ou mais Campos é que forma a única Chave Primária da tabela.
Ao selecionar Campos para uma Chave Primária, considere os seguintes detalhes:
· Não são permitidos valores duplicados ou nulos
· Caso não exista um identificador único para uma determinada tabela, pode-se usar um Campo que numere os
registros sequencialmente
Para inserir um objeto PrimaryKey em um Histórico, clique com o botão direito do mouse no Histórico e selecione a
opção Adicionar - PrimaryKey. Consulte o tópico Campo de Chave Primária para mais informações sobre os
Campos que podem ser inseridos neste objeto.
21.4.1 Campo de Chave Primária

O objeto Campo de Chave Primária representa um Campo em uma Chave Primária de Histórico. Para inserir um
objeto Campo de Chave Primária, clique com o botão direito do mouse em um objeto PrimaryKey e selecione a opção
Inserir - Campo de Chave Primária ou selecione o objeto PrimaryKey e clique em Adicionar - Campo de Chave
Primária na barra de ferramentas do Histórico. Ao inserir um Campo de Chave Primária, a janela da figura a seguir é
aberta para a seleção dos Campos ainda não selecionados na tabela do Histórico. Caso haja apenas um Campo não
selecionado na tabela do Histórico, a janela da figura a seguir não é mostrada e este Campo é adicionado
automaticamente. Caso não haja nenhum Campo não selecionado, é criado um Campo com a coluna Campo vazia e a
coluna Ordem com o valor foAscending.
Janela de seleção de um Campo para a Chave Primária

Um Campo de Chave Primária, após inserido, pode ter apenas as colunas Campo e Ordem alteradas. A coluna
Campo, que corresponde à propriedade Field deste objeto, permite selecionar o Campo do Histórico que faz parte
desta Chave Primária e a coluna Ordem, que corresponde à propriedade Order deste objeto, permite alterar a
ordenação deste Campo na Chave Primária, seja ascendente (foAscending) ou descendente (foDescending),
Configuração dos Campos de Chave Primária

Ao atualizar o nome de um Campo de Histórico no objeto Fields, a coluna Campo do objeto Campo de Chave
Primária correspondente é atualizada automaticamente. Ao remover um Campo de Histórico do objeto Fields, a janela
389 Histórico
da figura a seguir é mostrada, solicitando a confirmação desta operação. Caso o usuário clique em Sim, o Campo de
Histórico e o Campo de Chave Primária são removidos, além dos dados correspondentes na tabela do banco de
dados.
Confirmação de exclusão de um Campo de Histórico
Histórico 390
CAPÍTULO
E3Browser
22
O E3Browser é um controle ActiveX utilizado para visualizar dados armazenados em um bancos de dados. Pode-se
configurar consultas utilizando filtros de vários tipos nos dados e atribuir cores para cada coluna, entre outras
configurações. Este objeto é utilizado para visualizar os Históricos, alarmes ou qualquer tabela existente em um banco
de dados.
E3Browser
1. Insira um E3Browser no projeto clicando com o botão direito do mouse na área de trabalho e selecionando o item
Inserir - E3Browser.
Inserindo um E3Browser em uma Tela
391 E3Browser
2. O E3Browser utiliza um objeto Consulta para auxiliar o usuário no processo de definição de consultas no banco de
dados da aplicação. Para mais informações, consulte o capítulo Consultas.
3. Caso necessite, configure as propriedades do E3Browser. Algumas das propriedades deste objeto podem ser
configuradas através da Lista de Propriedades, sem a necessidade de criar scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faça os devidos ajustes. Demais informações
sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referência e
Scripts do Elipse Power, em seu capítulo respectivo.
22.1 Objeto Consulta no E3Browser

A Consulta é um objeto do Elipse Power que auxilia o usuário no processo de definição de consultas no banco de
dados da aplicação. Toda vez que o E3Browser busca dados no banco de dados é necessário enviar um comando, de
forma que se saiba quais os dados desejados para aquele objeto. Logo, toda vez que uma aplicação Elipse Power
precisa gravar ou buscar dados armazenados em um banco de dados, são enviados comandos no formato SQL
(Structured Query Language).
Consulta em um objeto E3Browser

A Consulta apresenta uma interface amigável que permite a construção das consultas de forma gráfica e o
acompanhamento imediato da sintaxe SQL que está sendo gerada.
NOTA
Um E3Browser não pode carregar consultas que se encontrem no servidor.
A aba Consulta mostra os campos disponíveis na Consulta. Estes campos podem ser acessados clicando-se em
Configurar, que abre o assistente de configuração da Consulta.
E3Browser 392
Aba Consulta
Para maiores informações sobre a Consulta, consulte o capítulo Consultas.
22.2 Outras Configurações

As configurações disponíveis no E3Browser estão descritas nos tópicos a seguir.
22.2.1 Aba Estilo

Através da aba Estilo pode-se definir a aparência das divisões (grade) das células e dimensões das linhas e colunas.
Aba Estilo
As opções disponíveis na aba Estilo possuem uma propriedade correspondente. As propriedades disponíveis estão
Opções disponíveis na aba Estilo
OPÇÃO DESCRIÇÃO
Estilo da grade Determina o estilo da grade do E3Browser. Os valores
possíveis para esta opção são Sem linhas separadoras
, Com linhas horizontais , Com linhas verticais
ou Com linhas verticais e horizontais (padrão). Esta
opção equivale à propriedade GridLinesType do
E3Browser
393 E3Browser
OPÇÃO DESCRIÇÃO
Altura do cabeçalho Determina a altura, em pixels, do cabeçalho do E3Browser.
Esta opção equivale à propriedade FixedRowHeight do
E3Browser
Largura da 1ª coluna Determina a largura da primeira coluna na tabela. Esta

opção equivale à propriedade FixedColumnWidth do
E3Browser
Altura das Linhas Determina a altura das linhas restantes na tabela. Esta
opção equivale à propriedade RowHeight do E3Browser
Largura das Colunas Determina a largura das colunas da tabela. Esta opção
equivale à propriedade ColumnWidth do E3Browser
22.2.2 Aba Opções

Na aba Opções, informe o intervalo de tempo em que os dados são gravados e atualizados no E3Browser. Esta
atualização ocorre em milissegundos (ms). Pode-se também selecionar a opção de não atualizar os dados, permitindo
que as gravações permaneçam as mesmas. Na opção do tipo de seleção, informe qual o tipo de seleção é realizada
na tabela.
Aba Opções
As opções disponíveis na aba Opções possuem uma propriedade correspondente. As propriedades disponíveis estão
Opções disponíveis na aba Opções
OPÇÃO DESCRIÇÃO
Informe o intervalo de tempo em que os dados serão Determina o intervalo de tempo, em milissegundos, em
atualizados que os dados são atualizados. As opções disponíveis são
Não atualizar, equivalente a configurar esta opção em 0
(zero), ou Atualizar a cada (ms). Este valor deve ser
superior a 1000 ms. Esta opção equivale à propriedade
RefreshTime do E3Browser
Informe qual será o tipo de seleção Determina o tipo de seleção na tabela do E3Browser. As
opções disponíveis são Selecionar as células
individualmente ou Selecionar a linha inteira que
contém a célula. Esta opção equivale à propriedade
SelectRow do E3Browser
22.2.3 Aba Cores

A aba Cores determina as cores do E3Browser, referentes às suas colunas e células. Para alterar a cor de qualquer
uma das opções disponíveis, selecione a opção e clique em para abrir a caixa de diálogo de edição de cores.
E3Browser 394
Aba Cores
As opções disponíveis nesta aba correspondem às propriedades descritas na tabela a seguir.
Propriedades correspondentes às opções da aba Cores
OPÇÃO DESCRIÇÃO
Cor de fundo do E3Browser Esta opção corresponde à propriedade GridBkColor do
E3Browser
Cor da linha da grade Esta opção corresponde à propriedade GridLineColor

do E3Browser
Cor do texto do cabeçalho Esta opção corresponde à propriedade FixedTextColor

do E3Browser
Cor de fundo do cabeçalho Esta opção corresponde à propriedade FixedBkColor do

E3Browser
Cor do texto da barra de funções Esta opção corresponde à propriedade

ToolbarForeColor do E3Browser
Cor de fundo da barra de funções Esta opção corresponde à propriedade ToolbarBkColor

do E3Browser
Cor do texto da célula Esta opção corresponde à propriedade TextColor do

E3Browser
Cor de fundo da célula Esta opção corresponde à propriedade TextBkColor do

E3Browser
Cor do texto da dica da célula Esta opção corresponde à propriedade

TitleTipTextColor do E3Browser
Cor de fundo da dica da célula Esta opção corresponde à propriedade TitleTipBkcolor

do E3Browser
NOTA
O nome desta aba aparece no idioma do Windows, e não necessariamente no idioma do Elipse Power.
395 E3Browser
22.2.4 Aba Fonte
Na aba Fonte, definem-se as especificações de fontes no E3Browser.
Aba Fonte
As opções disponíveis são referentes a tipo, tamanho e efeitos da fonte.
NOTA
O nome desta aba aparece no idioma do Windows, e não necessariamente no idioma do Elipse Power.
E3Browser 396
CAPÍTULO
E3Chart
23
O E3Chart é um componente ActiveX criado especialmente para trabalhar em conjunto com o Elipse Power. Com este
objeto é possível exibir gráficos mostrando Tags variando em tempo real, bem como dados históricos gravados em
um banco de dados.
O E3Chart é composto por várias coleções. Uma coleção (collection) é um objeto especial que gerencia um conjunto
de objetos semelhantes. O E3Chart possui as seguintes coleções:
· Coleção de Eixos: Gerencia os Eixos do E3Chart, onde podem ser configuradas diferentes escalas a serem
associadas aos dados das Penas
· Coleção de Penas: Gerencia o conjunto de Penas criadas para manipular a sequência de dados representada no
E3Chart
· Coleção de Colunas da Legenda: Gerencia as colunas da Legenda do E3Chart, onde são mostradas as
informações sobre as Penas
· Coleção de Consultas: Gerencia as consultas com informações sobre as Penas, como por exemplo no caso de
gráficos que mostram dados históricos já gravados em um banco de dados
Para utilizar os recursos do E3Chart, siga estes procedimentos:

1. Clique com o botão direito do mouse em uma Tela e selecione a opção Inserir - E3Chart.
Inserindo um E3Chart na Tela
2. Caso seja necessário, configure as propriedades do E3Chart. Algumas das propriedades deste objeto podem ser
configuradas através da Lista de Propriedades, sem a necessidade da criação de scripts para isto. Caso necessite
configurar alguma propriedade, localize-a na Lista de Propriedades e faça os devidos ajustes. Demais informações
sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de Referência e
Scripts do Elipse Power, em seu capítulo correspondente.
Para configurar um E3Chart, clique com o botão direito do mouse neste objeto e selecione a opção Propriedades
para abrir a Janela de Propriedades. Os tópicos a seguir descrevem as opções disponíveis nas abas desta janela.
397 E3Chart
23.1.1 Abas Item, Posição e Geral
A aba Item permite visualizar o nome do E3Chart e atribuir-lhe uma descrição.
Aba Item
Cada opção da aba Item possui uma propriedade correspondente. As opções disponíveis estão descritas na tabela a
seguir.
Opções disponíveis na aba Item
OPÇÃO DESCRIÇÃO
Nome Determina o nome do objeto. Esta opção equivale à
propriedade Name do E3Chart
Documentação Texto livre que possibilita a documentação das

funcionalidades e características do objeto pelo
programador. Esta opção equivale à propriedade
DocString do E3Chart
A aba Posição determina o posicionamento do E3Chart na Tela.
Aba Posição
Cada opção da aba Posição possui uma propriedade correspondente. As opções disponíveis estão descritas na
tabela a seguir.
E3Chart 398
Opções disponíveis na aba Posição
OPÇÃO DESCRIÇÃO
X Define a coordenada horizontal esquerda do objeto, em
unidades Himetric. Esta opção equivale à propriedade X
do E3Chart
Y Define a coordenada vertical superior do objeto, em

unidades Himetric. Esta opção equivale à propriedade Y
do E3Chart
Largura Determina a largura do objeto. Esta opção equivale à

propriedade Width do E3Chart
Altura Determina a altura do objeto. Esta opção equivale à

propriedade Height do E3Chart
A aba Geral permite especificar o estilo e a aparência do gráfico.
Aba Geral
Cada opção da aba Geral possui uma propriedade correspondente. As opções disponíveis estão descritas na tabela a
seguir.
OPÇÃO DESCRIÇÃO
Mostrar título Exibe o título do gráfico. Esta opção equivale à
propriedade Title do E3Chart
Mostrar título com a cor Determina a cor do texto do título do gráfico. Esta opção
equivale à propriedade TitleColor do E3Chart
Mostrar borda Habilita ou desabilita uma borda externa no E3Chart,

quando a visualização das escalas está desabilitada. Esta
opção equivale à propriedade ShowBorder do E3Chart
Mostrar o fundo do gráfico com a cor Determina a cor de fundo do gráfico. Esta opção
equivale à propriedade BackColor do E3Chart
Mostrar o fundo da grade com a cor Determina a cor de fundo da grade do gráfico. Esta
opção equivale à propriedade GridBackColor do E3Chart
Intervalo entre as atualizações (segundos) Determina o intervalo entre as atualizações do desenho

no gráfico. Esta opção equivale à propriedade
RefreshTime do E3Chart
399 E3Chart
23.1.2 Aba Eixos
O objeto Coleção de Eixos representa o conjunto de Eixos contidos no E3Chart. Os Eixos são escalas colocadas no
contorno da grade do E3Chart.
A aba Eixos permite adicionar ou remover Eixos na Coleção de Eixos, bem como configurar suas propriedades
individualmente.
Aba Eixos
Quando o E3Chart é criado, os Eixos Horizontal, Vertical e Automático são criados automaticamente. Estes são os
Eixos padrão e não podem ser removidos. Clique em Adicionar para criar um novo Eixo no gráfico e abrir uma janela
de configuração, que permite determinar as propriedades deste Eixo. Esta janela possui as abas descritas a seguir, e
também pode ser aberta clicando em Configurar.
NOTAS
· O Eixo Automático é um Eixo vertical que agrupa e plota todas as Penas do tipo Automática. Sempre que uma
operação disponível no menu contextual do E3Chart é aplicada (zoom, mover, enquadrar, etc.), este Eixo atualiza
todas as escalas. Este Eixo automático é criado invisível por padrão e se torna visível somente quando utilizado ou
quando configurado explicitamente na Janela de Propriedades do Eixo.
· Quando uma Pena do tipo Automática não recebe dados válidos, esta Pena utiliza o Eixo Vertical padrão.
· Caso todas as Penas estejam utilizando o Eixo Automático padrão, o Eixo Vertical padrão é escondido.
· O Eixo Automático padrão funciona em parceria com o Eixo Horizontal padrão, portanto não é possível utilizar
Eixos horizontais criados pelo usuário para Penas do tipo Automática.
Aba Geral
Esta aba contém informações que identificam um Eixo.
E3Chart 400
Aba Geral
Cada opção da aba Geral possui uma propriedade ou método correspondente. As opções disponíveis estão descritas
na tabela a seguir.
OPÇÃO DESCRIÇÃO
Nome Determina o nome do Eixo do gráfico. Esta opção
equivale à propriedade Name do Eixo
Posição Determina a posição do Eixo no gráfico. As opções

disponíveis são no topo, na base, à esquerda ou à
direita. Esta opção equivale à propriedade Position do
Eixo
Espelhar o eixo Mostra o Eixo também do lado oposto ao escolhido,

com efeito de espelho. Esta opção equivale à
propriedade Mirror do Eixo
Título do eixo Determina o título do Eixo. Esta opção equivale à

propriedade Title do Eixo
Usar unidade de engenharia como título do eixo Permite usar a unidade de engenharia da Pena
selecionada como título deste Eixo, sobrescrevendo o
texto configurado na opção Título do eixo. Esta opção
equivale à propriedade UsePenEUAsTitle do Eixo e só
está disponível para Eixos do tipo Automático
401 E3Chart
OPÇÃO DESCRIÇÃO
Cor da escala Determina a cor da escala. Esta opção corresponde à
propriedade Color do Eixo
Visível Determina a visibilidade do Eixo no gráfico. Esta opção

equivale à propriedade Visible do Eixo
Texto na cor da escala Determina se a cor do texto do Eixo tem a mesma cor
definida na opção Cor da escala. Se esta opção estiver
desabilitada, a cor do texto do Eixo é a cor definida na
propriedade ForeColor do E3Chart. Esta opção equivale
à propriedade EnableTextColor do Eixo
Escala na cor da pena Determina que a escala seja desenhada com a mesma
cor da Pena selecionada. Esta opção equivale à
propriedade EnableScaleColor do Eixo e só está
disponível em Eixos do tipo Automático
Cor das linhas na grade Determina a cor das linhas na grade. Esta opção equivale
à propriedade GridColor do Eixo
Estilo da linha Determina o estilo da linha da grade do gráfico. Esta

opção equivale à propriedade GridStyle do Eixo
Mostrar as linhas na grade Habilita a visualização das linhas na grade. Esta opção
equivale à propriedade ShowGrid do Eixo
Intervalo entre divisões Determina o intervalo entre os marcadores da escala,

caso a opção Automático esteja desabilitada. Se a
escala não for numérica, é possível selecionar a unidade
de tempo a que este intervalo se refere. Esta opção
equivale ao método SetTickSpacing do Eixo
Automático Seleciona automaticamente o intervalo entre os

marcadores da escala. Esta opção equivale ao método
SetTickSpacing do Eixo, com 0 (zero) no valor do
intervalo
Número de subdivisões Determina o número de subdivisões entre os

marcadores. Esta opção equivale à propriedade
MinorTicks do Eixo
Clique em Aplicar para visualizar as modificações realizadas nesta aba e em OK para salvá-las.
Aba Escala
Esta aba define as configurações da escala do Eixo.
E3Chart 402
Aba Escala
Cada opção da aba Escala possui uma propriedade ou um método correspondente. As opções disponíveis estão
Opções disponíveis na aba Escala
OPÇÃO DESCRIÇÃO
Escala numérica Define o Eixo como sendo uma escala numérica. Esta
opção equivale à propriedade ScaleType do Eixo. As
opções de configuração para escalas numéricas são as
seguintes:
· Mínimo: Determina o valor mínimo da escala numérica.
Esta opção equivale ao método SetMinMax do Eixo
· Máximo: Determina o valor máximo da escala numérica.
Esta opção equivale ao método SetMinMax do Eixo
NOTA: As configurações desta opção são sobrescritas na
execução para os Eixos do tipo Automático pelos valores
vindos do servidor
Mostrar último período (tempo real) Mostra o intervalo de tempo que o Eixo mostra, sempre
em relação à hora atual. Esta opção equivale ao método
SetRealTimePeriod do Eixo
Intervalo de tempo (histórico) Determina um intervalo de tempo fixo. As opções de

configuração são as seguintes:
· Do dia: Data e hora iniciais do intervalo
· Até o dia: Data e hora finais do intervalo
· Selecionar: Seleciona o intervalo de tempo
403 E3Chart
OPÇÃO DESCRIÇÃO
Esta opção corresponde ao método SetHistoricPeriod do
Eixo
Inverter escala Inverte os valores da escala selecionada. Esta opção

corresponde à propriedade Inverse do Eixo
Formatação Determina a formatação dos valores do Eixo, que pode

ser Automática ou Personalizada. Esta opção
corresponde à propriedade Format do Eixo. Para mais
informações sobre formatos, consulte o tópico
Formatação de Valores
Clique em Aplicar para visualizar as modificações realizadas nesta aba e em OK para salvá-las.
Aba Referência Visual

Esta aba define as informações visuais para as linhas e bandas de referência de um Eixo.
Aba Referência Visual

Cada opção da aba Referência Visual possui uma propriedade correspondente. As opções disponíveis nesta aba
estão descritas na tabela a seguir.
Opções disponíveis na aba Referência Visual
OPÇÃO DESCRIÇÃO
Valor de referência Define o valor usado como referência para a linha. Este
valor se refere ao eixo x ou y, dependendo se a escala é
vertical ou horizontal. Esta opção corresponde à
propriedade ReferenceLineValue do Eixo
E3Chart 404
OPÇÃO DESCRIÇÃO
Cor da linha Define a cor da linha de referência. Esta opção
corresponde à propriedade ReferenceLineColor do Eixo
Estilo do traço Define o estilo do traço da linha de referência. Os valores

possíveis para esta opção são Sólida, Tracejada,
Pontilhada, Traço-Ponto e Traço-Ponto-Ponto. Esta
opção corresponde à propriedade ReferenceLineStyle
do Eixo
Espessura da linha Define a espessura da linha de referência. Os valores

possíveis para esta opção vão de 0 (zero) a 11 pixels.
Esta opção corresponde à propriedade
ReferenceLineWidth do Eixo
Visível Indica se a linha de referência está visível ou não. Esta

opção corresponde à propriedade ReferenceLineVisible
do Eixo
Valor superior Define o valor superior da banda de referência. Esta

NormalBandHighValue do Eixo
Valor inferior Define o valor inferior da banda de referência. Esta

NormalBandLowValue do Eixo
Cor de fundo Define a cor da banda de referência. Esta opção

corresponde à propriedade NormalBandColor do Eixo
Visível Indica se a banda de referência está visível ou não. Esta

opção corresponde à propriedade NormalBandVisible
do Eixo
Clique em Aplicar para visualizar as modificações realizadas nesta aba e em OK para salvá-las. A figura a seguir
mostra uma referência visual configurada no Eixo Vertical com os seguintes valores:
· Valor de referência: 0 (zero)
· Cor da linha: Preto (RGB(0, 0, 0))
· Estilo do traço: Sólido
· Espessura da linha: 2 (dois) pixels
· Valor superior: 50
· Valor inferior: -50
· Cor de fundo: Prata (RGB(192, 192, 192))
405 E3Chart
Exemplo de uso da referência visual
23.1.3 Aba Penas

O objeto Coleção de Penas representa o conjunto de Penas contidas no E3Chart. Cada Pena é configurada para exibir
dados conforme a configuração executada na aba Dados da Janela de Propriedades.
A aba Penas permite adicionar ou remover Penas da Coleção de Penas, bem como configurar suas propriedades
principais, individualmente ou através da múltipla seleção de Penas.
Aba Penas
As opções disponíveis na aba Penas estão descritas na tabela a seguir.
Opções disponíveis na aba Penas
OPÇÃO DESCRIÇÃO
Adicionar Pena Adiciona uma Pena. Mostra um menu que permite
selecionar o tipo de Pena a ser criada. As opções
disponíveis são Tempo Real , Histórica , Histórica
e Tempo Real ou Automática
Excluir Pena Remove as Penas selecionadas
E3Chart 406
OPÇÃO DESCRIÇÃO
Propriedades Abre a Janela de Propriedades da Pena selecionada.
Esta operação só é permitida se apenas uma Pena está
selecionada
Mover Pena para cima Move a Pena selecionada uma posição para cima. Esta
operação só é permitida se apenas uma Pena está
selecionada
Mover Pena para baixo Move a Pena selecionada uma posição para baixo. Esta
operação só é permitida se apenas uma Pena está
selecionada
NOTA
Para a utilização de Penas do tipo Automática, não é preciso criar ou configurar uma Consulta. Tanto os dados de
tempo real quanto os dados históricos são retornados automaticamente sob demanda pelo servidor, conforme o
período de tempo definido no eixo horizontal.
A listagem de Penas do E3Chart permite copiar e colar Penas, tanto no mesmo E3Chart quanto entre E3Charts
diferentes. Clique com o botão direito do mouse na Pena desejada, ou nas Penas selecionadas em caso de múltipla
seleção, e selecione a opção Copiar (CTRL + C). No E3Chart de destino, abra a Janela de Propriedades e, na aba
Penas, clique com o botão direito do mouse na listagem de Penas e selecione a opção Colar (CTRL + V). A opção de
Recortar a Pena (CTRL + X) também está presente. No caso de o E3Chart de destino já possuir uma Pena com o
mesmo nome da Pena copiada, o nome é automaticamente incrementado.
NOTA
Todas as opções das Penas selecionadas que estão disponíveis via menu contextual (através do clique com o botão
direito do mouse) também estão disponíveis utilizando o atalho de teclado SHIFT + F10, que corresponde à tecla de
aplicação ou de menu .
Algumas propriedades da Pena podem ser configuradas diretamente na lista mostrada na aba Penas. Na coluna
Estilo, ao clicar em , a janela da figura a seguir é mostrada.
Estilo da Pena
407 E3Chart
Opções disponíveis na janela Estilo da Pena
OPÇÃO DESCRIÇÃO
Cor principal Define a cor da linha da Pena. Esta opção equivale à
propriedade Color da Pena
Cor do Fundo Define a cor de fundo usada em uma Pena do tipo Área.
Esta opção equivale à propriedade BkColor da Pena
Tipo de desenho Define o tipo de desenho da Pena. As opções disponíveis

são Linhas, Pontos, Linhas e Pontos ou Área. Esta
opção equivale à propriedade PenType da Pena
Estilo do traço Define o tipo de linha da Pena. As opções disponíveis

são Sólida, Tracejada, Pontilhada, Traço-Ponto, Traço-
Ponto-Ponto ou Sem Linha. Esta opção equivale à
propriedade PenLineStyle da Pena
Espessura da linha Define a espessura da linha. Esta opção equivale à

propriedade Width da Pena
Amostra Mostra um exemplo de como a Pena é desenhada no

E3Chart
Clique com o botão direito do mouse em uma Pena e selecione a opção Configurar Pena ou selecione uma Pena e
clique em na barra de ferramentas para abrir a Janela de Propriedades. Esta janela possui as abas descritas a
seguir.
Aba Geral
Esta aba contém as informações que identificam uma Pena no E3Chart.
E3Chart 408
Aba Geral
Cada opção da aba Geral possui uma propriedade correspondente. As opções disponíveis estão descritas na tabela a
seguir.
OPÇÃO DESCRIÇÃO
Nome da pena Indica o nome da Pena. Esta opção equivale à
propriedade Name da Pena
Cor principal Determina a cor da linha da Pena. Esta opção equivale à

propriedade Color da Pena
Visível Indica o estado de visibilidade da Pena no gráfico. Esta

opção equivale à propriedade Visible da Pena
Unidade de Engenharia Indica a unidade de engenharia utilizada pela Pena. Esta

opção equivale à propriedade EU da Pena
Aba Dados
Esta aba contém informações de acordo com o tipo da Pena.
409 E3Chart
Aba Dados
Cada opção da aba Dados possui uma propriedade correspondente. As opções disponíveis estão descritas na tabela
a seguir.
Opções disponíveis na aba Dados
OPÇÃO DESCRIÇÃO
Tipo de pena Determina o tipo de Pena em uso. Esta opção equivale à
propriedade DataSourceType da Pena
Link do eixo vertical Nome da Associação usada para plotar os dados em

uma escala vertical. Esta opção equivale à propriedade
YLink da Pena
Link do eixo horizontal Nome da Associação usada para plotar os dados em

uma escala horizontal. Esta opção equivale à
propriedade XLink da Pena
Número de amostras mantidas na memória Determina o número de amostras nas Penas de tempo
real. Esta opção equivale à propriedade BufferSize da
Pena
Usar a estampa de tempo Habilita ou desabilita a estampa de tempo. A estampa de

tempo é o valor de tempo que acompanha o valor do
Tag, indicando o momento em que este valor é alterado.
Esta opção equivale à propriedade UseTimeStamp da
Pena. Se esta opção está habilitada, a opção Link do
eixo horizontal permanece inativa
E3Chart 410
OPÇÃO DESCRIÇÃO
Consulta local Determina a Consulta vinculada ao E3Chart que é
utilizada nos dados do Eixo. Esta opção equivale à
propriedade QueryName da Pena
Consulta externa Determina a consulta externa, isto é, os dados vêm de

uma consulta fora do E3Chart
Campo do eixo vertical Nome do campo da Consulta usado para plotar os

dados em uma escala vertical. Esta opção equivale à
propriedade YField da Pena
Campo do eixo horizontal Nome do campo da Consulta usado para plotar os

dados em uma escala horizontal. Esta opção equivale à
propriedade XField da Pena
Usar consulta automática Indica se a Pena deve ou não usar uma consulta
automática. A consulta automática não é utilizada se o
E3Chart usa um código SQL personalizado, se usa um
Storage ou se possui várias tabelas. Esta opção equivale
à propriedade AutoQuery da Pena
Eixo vertical Especifica o Eixo vertical. Esta opção equivale à

propriedade ScaleY da Pena
Eixo horizontal Especifica o Eixo horizontal. Esta opção equivale à

propriedade ScaleX da Pena
Usar eixos automáticos Quando esta opção está selecionada, a Pena é plotada
utilizando um Eixo automático, que recebe os limites
mínimos e máximos das configurações da unidade de
engenharia do Tag no servidor. NOTA: Esta opção só
está disponível para Penas do tipo Automática e,
quando selecionada, desabilita as opções Eixo vertical e
Eixo horizontal
Aba Estilo
Esta aba determina o estilo da Pena.
411 E3Chart
Aba Estilo
Cada opção da aba Estilo possui uma propriedade correspondente. As opções disponíveis estão descritas na tabela
a seguir.
Opções disponíveis na aba Estilo
OPÇÃO DESCRIÇÃO
Tipo de desenho Indica o tipo de desenho da Pena. Esta opção equivale à
propriedade PenType da Pena
Estilo do traço Determina o estilo do traço da Pena. Esta opção equivale

à propriedade PenLineStyle da Pena
Espessura da linha Determina a espessura da linha, em pixels. Esta opção

equivale à propriedade Width da Pena
Cor do Fundo Determina a cor de fundo da linha. Esta opção equivale à

propriedade BkColor da Pena
Documentação Determina a documentação que pode ser mostrada na

Legenda. Esta opção equivale à propriedade DocString
da Pena
Habilita alarme alto Habilita a verificação do alarme alto. Esta opção equivale
à propriedade EnableHighLimit da Pena. A caixa de
texto correspondente permite estabelecer o limite deste
alarme, que equivale à propriedade HighLimit da Pena
E3Chart 412
OPÇÃO DESCRIÇÃO
Habilita alarme baixo Habilita a verificação do alarme baixo. Esta opção
equivale à propriedade EnableLowLimit da Pena. A caixa
de texto correspondente permite estabelecer o limite
deste alarme, que equivale à propriedade LowLimit da
Pena
Cor de alarme Cor da Pena quando em alarme. Esta opção equivale à

propriedade LimitPenColor da Pena
Cor de fundo do alarme Cor do fundo da Pena quando em alarme. Esta opção
equivale à propriedade LimitPenBkColor da Pena
A aparência da Pena, conforme a opção configurada, pode ser visualizada a seguir.
Modo analógico de ligação entre os pontos
413 E3Chart
Modo digital de ligação entre os pontos
O modo como a Pena é apresentada quando o scan é considerado é representado pela cor verde e quando esta
opção está desabilitada é representado pela cor azul.
Modo de apresentação da Pena considerando o scan

Aba Modo de Ligação
Esta aba determina o estilo da ligação entre a parte histórica e a parte de tempo real de uma Pena.
E3Chart 414
Aba Modo de Ligação
As opções disponíveis na aba Modo de Ligação estão descritas na tabela a seguir.
Opções disponíveis na aba Modo de Ligação
OPÇÃO DESCRIÇÃO
Usar modo de ligação automático Habilita o modo automático de ligação dos pontos da
Pena. Esta opção só está disponível para Penas do tipo
Automática. Esta opção equivale à propriedade
EnableAutoPlotMode da Pena. Consulte a nota a seguir
para mais informações sobre o comportamento desta
opção
Digital ou Analógico Esta opção define a forma de ligação entre os pontos da

parte histórica e os pontos da parte de tempo real. Esta
opção equivale à propriedade DigitalData da Pena. As
opções possíveis são Digital, onde o traçado é sempre
baseado em retas somente horizontais e verticais,
sugerindo variação instantânea, ou Analógico, onde o
traçado busca uma reta unindo cada um dos pontos do
gráfico. Esta opção não está disponível quando a opção
Usar modo de ligação automático está selecionada
415 E3Chart
OPÇÃO DESCRIÇÃO
Valor considerado para o scan (ms) Define o tempo de leitura esperado do Tag da Pena de
tempo real. Se este valor é igual a 0 (zero), o E3Chart
desenha apenas os pontos realmente recebidos da fonte
(Tag). Para valores diferentes de 0 (zero), o E3Chart pode
criar pontos virtuais enquanto o valor não é recebido da
fonte e o tempo de scan é excedido. Esta opção equivale
à propriedade ScanValue da Pena
Mostrar os pontos de qualidade ruim Define se mostra ou não os pontos de qualidade ruim.
Esta opção equivale à propriedade ShowBadPoints da
Pena
Intervalo máximo para ligar os dados históricos aos Especifica um tempo limite a ser considerado para a
de tempo real (s) conexão visual entre a parte histórica e a parte de tempo
real de uma Pena do tipo Histórica e Tempo Real. Esta
opção equivale à propriedade MaxGapTime da Pena
Realçar linha quando MaxGapTime é usado Realça a linha de ligação entre a parte histórica e a parte
de tempo real. Esta opção equivale à propriedade
HighlightMaxGapTime da Pena
Cor da linha usada com MaxGapTime Especifica a cor da linha de ligação. Esta opção equivale
à propriedade MaxGapTimeColor da Pena
Estilo da linha usada com MaxGapTime Especifica o estilo da linha de ligação. Esta opção
equivale à propriedade MaxGapTimeStyle da Pena
NOTA
A opção Usar modo de ligação automática está desabilitada para as Penas do tipo Tempo Real, Histórica e
Histórica e Tempo Real. Esta opção é habilitada por padrão para as Penas do tipo Automática, indicando que os
dados são recebidos do servidor sem modificação. Pode-se forçar o modo de ligação para Digital ou Analógico
de uma Pena do tipo Automática desmarcando esta opção.
Aba Estatísticas
Esta aba habilita o cálculo de dados estatísticos.
E3Chart 416
Aba Estatísticas
Cada opção da aba Estatísticas possui uma propriedade correspondente. As opções disponíveis estão descritas na
tabela a seguir.
Opções disponíveis na aba Estatísticas
OPÇÃO DESCRIÇÃO
Calcular dados estatísticos Habilita o cálculo de dados estatísticos. Esta opção
equivale à propriedade EnableCalc da Pena
Mostrar linha da média Exibe a linha da média dos dados estatísticos. Esta
opção equivale à propriedade ShowAverage da Pena.
Veja a nota a seguir para mais informações sobre esta
opção
Mostrar mínimo e máximo Exibe o mínimo e o máximo dos dados estatísticos. Esta
opção equivale à propriedade ShowMinMax da Pena
NOTA
A média calculada pela opção Mostrar linha da média não é uma média aritmética simples, e sim uma média
aritmética ponderada em relação ao intervalo de tempo dos dados estatísticos.
23.1.4 Aba Legenda

A Legenda é utilizada para exibir as Penas visíveis no gráfico e informações sobre estas Penas, tais como cor, nome e
estado, entre outras.
417 E3Chart
Objeto Legenda em tempo de execução
A aba Legenda permite configurar as informações referentes ao objeto Legenda e suas Colunas.
Propriedades do objeto Legenda

Algumas opções da aba Legenda possuem uma propriedade ou método correspondente. As opções disponíveis
nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Legenda
OPÇÃO DESCRIÇÃO
Mostrar legenda Habilita a visualização da Legenda. A caixa de seleção ao
lado desta opção define o posicionamento da Legenda,
que pode ser no topo, à esquerda, na base (padrão) e
à direita. Esta opção equivale à propriedade Visible da
Legenda, e a opção de seleção da posição da Legenda
equivale à propriedade LegendPos da Legenda
Tamanho (pixels) Determina o tamanho da Legenda, em pixels. Pode ser a

altura ou a largura, dependendo da posição. A outra
dimensão acompanha a do E3Chart. Esta opção
corresponde à propriedade Size da Legenda
Mais Configurações Clique nesta opção para abrir a janela Configurações da

Legenda, descrita mais adiante neste tópico
E3Chart 418
OPÇÃO DESCRIÇÃO
Configuração das colunas Lista com todas as Colunas disponíveis para visualização
na Legenda. Consulte a tabela Opções disponíveis na
lista Configuração das colunas para verificar as Colunas
disponíveis nesta lista
Ordenação das colunas Lista com todas as Colunas selecionadas na lista

Configuração das colunas na ordem em que aparecem
na Legenda
Mover para cima e Mover para baixo Troca a posição da Coluna na Legenda. Estas opções
equivalem ao método ChangeColumnPos da Legenda
As opções disponíveis na lista Configuração das colunas estão descritas na tabela a seguir.
Opções disponíveis na lista Configuração das colunas
OPÇÃO DESCRIÇÃO
Visível? Indica se esta Coluna é visível na Legenda. Selecionar
esta opção automaticamente adiciona a Coluna na lista
Ordenação das colunas. Da mesma forma, remover a
seleção desta opção retira a Coluna da lista Ordenação
das colunas
Nome Nome interno da Coluna, que pode ser utilizado

diretamente pelos métodos InsertColumn (no parâmetro
Col), Item e RemoveColumn da Legenda. Para uma
descrição mais detalhada destes nomes, consulte a
tabela Opções disponíveis para identificação de
Colunas, mais adiante neste tópico
Descrição Texto descritivo da Coluna
Título da Coluna Determina o título da Coluna. Esta opção equivale à

propriedade Caption da Coluna da Legenda
Largura (px) Define a largura inicial da Coluna, em pixels. Esta opção

equivale à propriedade Width da Coluna da Legenda
Alinhamento Determina o alinhamento do texto na Coluna da Legenda.

As opções disponíveis são 0: Esquerda (padrão), 1:
Direita ou 2: Centralizado. Esta opção equivale à
propriedade TextAlign da Coluna da Legenda
Formatação Determina o formato de apresentação do conteúdo da

Coluna selecionada. Esta opção equivale à propriedade
Format da Coluna da Legenda
Os valores da coluna Nome da lista Configuração das colunas estão descritos na tabela a seguir. Tanto o valor
descrito na coluna Nome quanto o valor descrito na coluna Valor podem ser usados nos métodos InsertColumn,
Item e RemoveColumn da Legenda.
Opções disponíveis para identificação de Colunas
NOME VALOR DESCRIÇÃO
Name 0 Mostra o nome da Pena
TagX 1 Mostra o nome do Tag associado ao

Eixo X
TagY 2 Mostra o nome do Tag associado ao

Eixo Y
TagXValue 3 Mostra o valor da pesquisa no Eixo X
TagYValue 4 Mostra o valor da pesquisa no Eixo Y
419 E3Chart
NOME VALOR DESCRIÇÃO
Description 5 Mostra a descrição contida na
propriedade DocString da Pena
Color 6 Mostra a cor da Pena
Status 7 Mostra o estado de funcionamento

atual da Pena
ScaleX 8 Mostra o nome do Eixo X associado

à Pena
ScaleY 9 Mostra o nome do Eixo Y associado

à Pena
AverageY 10 Mostra o valor médio da Pena no

intervalo
MinY 11 Mostra o valor mínimo da Pena no

intervalo
MaxY 12 Mostra o valor máximo da Pena no

intervalo
XBegin 13 Mostra a posição inicial do cursor
XEnd 14 Mostra a posição final do cursor
DiffX 15 Mostra a diferença entre os cursores

inicial e final
DiffY 16 Mostra a diferença no Eixo Y entre os

pontos interpolados inicial e final
YBegin 17 Mostra o ponto interpolado onde o

cursor inicial cruza com a Pena
YEnd 18 Mostra o ponto interpolado onde o

cursor final cruza com a Pena
EU 19 Mostra a unidade de engenharia

utilizada pela Pena
ScaleYMax 20 Mostra o valor máximo da escala

vertical
ScaleYMin 21 Mostra o valor mínimo da escala

vertical
Ao clicar em Mais Configurações, a janela Configurações da Legenda é mostrada, conforme a figura a seguir.
Janela Configurações da Legenda
E3Chart 420
As opções disponíveis na aba Geral desta janela estão descritas na tabela a seguir.
OPÇÃO DESCRIÇÃO
Fonte Permite configurar o nome, o estilo e o tamanho da fonte
das Colunas. Esta opção equivale à propriedade Font da
Legenda
Mostrar fundo da Legenda Habilita a visualização de uma cor de fundo para a

Legenda, configurada na opção Cor de fundo. Se esta
opção estiver desabilitada, a Legenda aparece com a cor
configurada na opção Mostrar o fundo do gráfico com
a cor da aba Geral. Se aquela opção estiver desabilitada,
a Legenda aparece com a cor do objeto que estiver por
baixo do E3Chart. Esta opção corresponde à
propriedade ShowBackground da Legenda
Cor do fundo Permite configurar a cor de fundo da Legenda. Esta

opção equivale à propriedade BackColor da Legenda
Estilo da borda Permite configurar o estilo da borda da Legenda. Esta

opção equivale à propriedade BorderStyle da Legenda
Mostrar texto utilizando a cor da pena Habilita a utilização da cor da Pena para o texto da
Legenda. Esta opção equivale à propriedade
EnableTextColor da Legenda
Mostrar texto utilizando a seguinte cor Permite configurar uma cor para o texto da Legenda.
Esta opção equivale à propriedade TextColor da
Legenda
A figura a seguir mostra a aba Colunas da janela Configurações da Legenda.
Aba Colunas
As opções disponíveis na aba Colunas desta janela estão descritas na tabela a seguir.
Opções disponíveis na aba Colunas
OPÇÃO DESCRIÇÃO
Mostrar títulos das colunas Habilita o cabeçalho da Legenda. Esta opção equivale à
propriedade ShowHeader da Legenda
Cor do fundo das colunas Define a cor de fundo das Colunas do cabeçalho da
HeaderBackColor da Legenda
421 E3Chart
OPÇÃO DESCRIÇÃO
Estilo da borda das colunas Define o estilo das bordas das Colunas do cabeçalho da
HeaderBorderStyle da Legenda
Cor do texto das colunas Define a cor do texto das Colunas do cabeçalho da
HeaderTextColor da Legenda
23.1.5 Aba Consultas

As Consultas são necessárias para mostrar valores históricos no E3Chart. Através da aba Consultas é possível
adicionar ou remover Consultas, bem como configurá-las.
Aba Consultas
As opções disponíveis na aba Consultas estão descritas na tabela a seguir.
Opções disponíveis na aba Consultas
OPÇÃO DESCRIÇÃO
Consultas Mostra a Consulta selecionada para edição
Configurar Configura a Consulta selecionada
Adicionar Adiciona uma nova Consulta. Para mais informações

sobre Consultas, veja o capítulo Consultas
Remover Remove a Consulta selecionada
NOTA
Ao clicar em Adicionar ou Configurar, uma caixa de diálogo é aberta para especificação do Servidor de Banco de
Dados que guarda a Consulta. Os procedimentos de definição da Consulta podem ser encontrados no capítulo
Consultas.
E3Chart 422
23.1.6 Aba Fonte
A aba Fonte permite configurar a fonte do cabeçalho e das linhas do E3Chart.
Aba Fonte
As opções disponíveis na aba Fonte são referentes a tipo, tamanho e efeitos da fonte.
NOTA
O nome desta aba aparece sempre no idioma do Windows, e não necessariamente no idioma atual do Elipse Power.
23.2 Exemplos de Utilização

Os tópicos a seguir mostram alguns exemplos de utilização do E3Chart.
23.2.1 Habilitando e Desabilitando Penas

O exemplo a seguir demonstra como habilitar ou desabilitar a conexão dos dados de uma Pena no E3Chart, conforme
os procedimentos a seguir.
1. Crie um E3Chart em uma Tela.
2. Abra a Janela de Propriedades deste E3Chart e selecione a aba Penas. Crie uma nova Pena do tipo Tempo Real e
associe-a a um Tag Demo no Eixo Vertical.
3. Crie dois Botões de Comando nesta Tela. No primeiro Botão de Comando, digite na propriedade Caption a
descrição "Desabilitar Pena".
4. Abra a Janela de Propriedades deste Botão de Comando e selecione a aba Scripts. No evento Click, digite o
script a seguir.
Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Disconnect()
End Sub
5. No segundo Botão de Comando, digite na propriedade Caption a descrição "Habilitar Pena".

script a seguir.
Pen1.Connect()
End Sub
7. Execute o projeto e verifique o resultado.
423 E3Chart
23.2.2 Atualizando um E3Chart Histórico com os Dados da Última
Hora
O exemplo a seguir demonstra como atualizar um E3Chart com os dados históricos da última hora. Para este
exemplo, é necessário que haja uma Consulta a uma tabela previamente criada em um banco de dados.
2. Abra a Janela de Propriedades deste E3Chart e selecione a aba Eixos. Clique na opção Configurar do Eixo
Horizontal e, na aba Escala, selecione a opção Intervalo de tempo (Histórico).
3. Selecione a aba Consultas e clique em Adicionar. O Elipse Power Studio mostra uma caixa de diálogo para que
se indique o nome do servidor de banco de dados em que a tabela da consulta está armazenada.
4. Selecione o servidor de banco de dados na caixa de diálogo e clique em OK. O Elipse Power Studio abre a janela
de configurações da Consulta.
5. Selecione na tabela histórica o campo E3TimeStamp e algum outro campo de dados para mostrar no gráfico.
6. No campo E3TimeStamp, crie um filtro conforme as especificações da figura a seguir.
Filtro a ser criado no campo E3TimeStamp

7. Após ter criado o filtro conforme as especificações anteriores, clique em OK.
8. Crie uma nova Pena. Abra a Janela de Propriedades desta Pena e, na aba Dados, item Tipo de Pena, selecione a
opção Histórica usando a Consulta e indique o campo da Consulta configurada.
9. No item Campo do eixo vertical, indique um campo da tabela. No item Campo do eixo horizontal, indique o
campo E3TimeStamp. Clique em OK.
10. Crie um novo Botão de Comando na Tela e, na propriedade Caption, digite a expressão "Atualizar E3Chart
Histórico".
11. Selecione a aba Scripts deste Botão de Comando e, no evento Click, escreva o script a seguir.
Set Chart = Screen.Item("E3Chart1")
Set Consulta = Chart.Item("Consulta1")
Consulta.SetVariableValue "Ini", Now – 1 / 24
Consulta.SetVariableValue "Fim", Now
Chart.HorScaleBegin = Now – 1 / 24
Chart.HorScaleEnd = Now
Chart.Queries.UpdateData()
End Sub
23.2.3 Habilitando ou Desabilitando a Visualização de uma Pena

O exemplo a seguir demonstra como habilitar ou desabilitar a visualização de uma Pena em um E3Chart, conforme os
procedimentos a seguir.
2. Abra a Janela de Propriedades deste E3Chart e selecione a aba Penas. Crie uma nova Pena do tipo Tempo Real e
associe-a a um Tag Demo no Eixo Vertical.
E3Chart 424
3. Crie dois Botões de Comando na Tela. No primeiro, mude a propriedade Caption para "Desabilitar Visualização
da Pena".
script a seguir.
Pen1.Visible = False
End Sub
5. No segundo Botão de Comando, mude a propriedade Caption para "Habilitar Visualização da Pena".
script a seguir.
Set Pen1 = Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Visible = True
End Sub
23.2.4 Criação de uma Pena por Script

O exemplo a seguir demonstra como criar uma Pena por script, conforme os procedimentos a seguir.
2. Crie um Botão de Comando nesta Tela. Na propriedade Caption, digite o texto "Criar Pena".
3. Abra a Janela de Propriedades deste Botão de Comando e selecione a aba Scripts. Digite o script a seguir no
evento Click.
Sub Texto1_Click()
Set E3Chart1 = Screen.Item("E3Chart1")
MsgBox "Clique em OK para criar a Pena"
Set Pen = E3Chart1.Pens.AddPen("Pen1")
Pen.DataSourceType = 0 ' Tempo real
Pen.VerDataSource = "Dados.TagDemo1"
Pen.UseTimeStamp = True ' No X usa o timestamp
Pen.Color = RGB(255, 0, 0)
Pen.DocString = "teste"
MsgBox "Clique em OK para conectar"
Pen.Connect() ' Começa a receber os dados
MsgBox "Clique em OK para enquadrar"
E3Chart1.FitPen(0)
MsgBox "Clique em OK para desconectar"
Pen.Disconnect() ' Para de receber os dados
MsgBox "Clique em OK para remover a Pena"
E3Chart1.Pens.Remove(Pen.Name)
End Sub
23.3 Características Específicas de Tempo de Execução

O E3Chart possui uma série de características que se aplicam apenas em tempo de execução. Estas características são
explicadas nos tópicos a seguir.
23.3.1 Opções do Ponteiro do Mouse

Clique na legenda do gráfico para redimensionar suas colunas. Para isto, selecione a coluna desejada e arraste-a.
23.3.2 Opções do Menu Contextual

Clique com o botão direito do mouse no gráfico do E3Chart para abrir o menu contextual mostrado na figura a
seguir.
425 E3Chart
Opções do menu contextual do
E3Chart em tempo de execução
As opções disponíveis neste menu contextual estão descritas na tabela a seguir.
Opções disponíveis do menu contextual do E3Chart em tempo de execução
OPÇÃO DESCRIÇÃO
Caixa de Zoom Coloca o ponteiro do mouse no modo zoom por área
selecionada. Esta opção está disponível nos gráficos de
escala numérica em XY e escala fixa
Mover Coloca o ponteiro do mouse em modo de movimentação

das escalas
Mover horizontalmente Coloca o ponteiro do mouse em modo de movimentação

das escalas somente na direção horizontal
Pesquisar Coloca o ponteiro do mouse em modo de pesquisa de

valores nos dados das Penas
Pesquisar Intervalos Habilita a opção de pesquisa de intervalos de tempo
Menos Zoom Diminui o zoom de todo o Eixo
Mais Zoom Aumenta o zoom de todo o Eixo
Enquadrar tudo Enquadra a Pena selecionada em ambos os Eixos
Enquadrar verticalmente Enquadra a Pena selecionada somente no Eixo Vertical
Enquadrar horizontalmente Enquadra a Pena selecionada somente no Eixo Horizontal
Enquadrar pena Enquadra a Pena selecionada ou todas as Penas

existentes
23.3.3 Opção Pesquisar

Esta opção permite pesquisar valores dos pontos das Penas. Estes valores são mostrados na legenda através das
colunas Valor do Tag X e Valor do Tag Y.
E3Chart 426
Opção Pesquisar
NOTA
Para mais informações sobre as colunas Valor do Tag X e Valor do Tag Y, consulte o tópico Aba Legenda.
23.3.4 Opção Pesquisar Intervalos

Neste modo são mostrados dois cursores, que definem o intervalo de cálculos estatísticos. Os valores dos cursores
são mostrados nas colunas InícioX, InícioY, FimX e FimY. Para alterar a posição de um cursor, selecione-o clicando
com o botão esquerdo do mouse e arraste-o para a posição desejada.
Opção Pesquisar intervalos
427 E3Chart
23.3.5 Coluna Estado da Legenda
A coluna Estado da legenda mostra o estado atual de cada Pena. O conteúdo desta mensagem é composto por uma
informação de erro, se houver, e informações sobre a situação atual da Pena, como por exemplo o número de
pontos. As tabelas a seguir mostram as possíveis mensagens de erro e de informação para Penas do tipo Tempo
Real e Histórica. Se a Pena é do tipo Histórica e Tempo Real, a mensagem final é uma combinação da mensagem da
parte de tempo real com a mensagem da parte histórica. Caso haja mensagens de erro, a linha da coluna é mostrada
em vermelho enquanto o erro persistir.
Mensagens de status da parte de tempo real
MENSAGEM SIGNIFICADO
Erro: Parte de tempo real desconectada (YLink='Nome Não houve conexão da parte de tempo real da Pena.
do Tag') (XLink='Nome do Tag') Verifique o nome dos Tags nas propriedades YLink e
XLink da Pena
Info: Tempo real n pts Mostra o número total de pontos da parte de tempo real
Mensagens de status da parte histórica

Info: Consulta aguardando Aguardando a inicialização da consulta. Significa que
alguma mudança ou pedido de atualização da consulta
foi detectado
Info: Consulta inicializando A consulta está iniciando. Nesta fase são validados os
campos informados na Pena
Erro: Consulta: Falha na inicialização Antes de carregar os dados da consulta, o E3Chart

precisa conhecer os campos que a consulta contém para
realizar a associação entre estes campos e as
propriedades XField e YField da Pena. Ocorreu uma
falha ao buscar estes campos, que pode ser tanto um
erro de rede quanto um erro de sintaxe SQL
Erro: Campo não encontrado (XField = 'Nome do O campo informado na propriedade XField não foi
Campo') encontrado na consulta. Verifique se o campo está
selecionado na tela de edição da consulta ou no código
SQL
Erro: Campo não encontrado (YField = 'Nome do O campo informado na propriedade YField não foi
Campo') encontrado na consulta. Verifique se o campo está
selecionado na tela de edição da consulta ou no código
SQL
Erro: 'Nome da Consulta' 'Mensagem de Erro' Indica que houve um erro na consulta e não é possível
recuperar os dados. As possíveis mensagens mostradas
em Mensagem de Erro são descritas na tabela a seguir
Info: n pts Mostra o número total de pontos da parte Histórica
Info: Carregando Indica que os dados da consulta ainda estão sendo

carregados do servidor
Erro: Consulta inválida (QueryName = 'Nome da A consulta indicada pela propriedade QueryName da
Consulta') Pena não foi encontrada pelo E3Chart
Mensagens específicas para falha na consulta

Falha ao inserir dados Não foi possível carregar os dados para a memória
Falha na criação da consulta Não foi possível criar a consulta
Erro ao executar a consulta Não foi possível executar a consulta
E3Chart 428
Falha ao baixar os dados do servidor Não foi possível trazer do servidor os resultados da
consulta
Falha ao pegar o número de registros do servidor Não foi possível trazer do servidor o total de registros
existentes na consulta
Falha ao posicionar o cursor para o início Não foi possível posicionar o cursor no primeiro registro
da consulta
Cursor ocupado Os registros da consulta não estão disponíveis para

serem trazidos do servidor
Falha ao pegar os dados do servidor Não foi possível trazer do servidor os registros da
consulta
Erro desconhecido Houve um erro inesperado ao tentar trazer do servidor

os dados da consulta
429 E3Chart
CAPÍTULO
TrendAnalysis
24
O TrendAnalysis é uma ferramenta para exibição de dados históricos e que usa os Tags providos pelo serviço de
histórico automático do Elipse Power. Os principais recursos do TrendAnalysis são os seguintes:
· Capacidade para grande volume de dados
· Visualização clara da escala de tempo para qualquer nível de zoom
· Rolagem e zoom por escala ou por área
· Pesquisa por valor anterior, mais próximo ou interpolado
· Displays atualizados automaticamente
· Visualização da qualidade de um ponto e indicação de pontos com valores nulos
· Enquadramento permanente de Penas por eixo
Esta ferramenta está acessível através dos métodos GetTrendAnalysis, para criação e configuração, e
ShowTrendAnalysis, para visualização, do Elipse Power Viewer. A janela resultante pode ser vista nas figuras a
seguir.
Aba Exibições
TrendAnalysis 430
Aba Marcadores
Aba Conexões
As opções de configuração das abas presentes na janela do TrendAnalysis estão descritas nos tópicos a seguir.
24.1 Aba Exibições

Esta aba mostra as Penas correspondentes aos dados disponíveis na aba Conexões. As opções disponíveis ao clicar
com o botão direito do mouse na Exibição estão descritas na tabela a seguir.
Opções disponíveis no menu contextual de uma Exibição
OPÇÃO DESCRIÇÃO
Selecionar Colunas Permite selecionar quais as colunas são mostradas para
as Penas
Atualização Automática Habilita ou desabilita o modo de atualização automática
431 TrendAnalysis
OPÇÃO DESCRIÇÃO
Mostrar Linhas da Grade Mostra ou esconde as linhas de grade na área das Penas
Mostrar Pontos Mín./Máx. Mostra ou esconde os pontos mínimos e máximos das

Penas
Mostrar Legenda Local Mostra uma legenda com o nome da Pena e a respectiva
cor
Interpolar Utiliza interpolação para desenhar a Exibição
Ao selecionar a opção Selecionar Colunas, a janela da figura a seguir é mostrada.
Janela Legenda
Opções disponíveis na janela Legenda
OPÇÃO DESCRIÇÃO
Disponível(eis) Colunas disponíveis para visualização
Adicionar Move a coluna selecionada para a lista Selecionada(s)
Remover Remove a coluna selecionada da lista Selecionada(s)
Subir Move a coluna selecionada uma posição para cima na

lista Selecionada(s)
Descer Move a coluna selecionada uma posição para baixo na

lista Selecionada(s)
Selecionada(s) Colunas selecionadas para visualização
NOTAS
· Para reordenar as colunas de uma Legenda, utilize as opções Subir ou Descer.
· As opções disponíveis para colunas de Legendas, incluindo a largura, aplicam-se somente à Exibição selecionada.
Cada Pena tem uma caixa de seleção, que indica a visibilidade ou não na Exibição, um ícone com a cor e o nome. Ao
clicar com o botão direito do mouse na Pena, é possível selecionar as opções descritas na tabela a seguir.
TrendAnalysis 432
Opções disponíveis no menu contextual de uma Pena
OPÇÃO DESCRIÇÃO
Enviar para Frente Move a Pena selecionada para uma posição superior na
ordem de sobreposição das Penas. As opções
disponíveis são Enviar para Frente: Move a Pena
selecionada para a primeira posição ou Avançar: Move a
Pena selecionada uma posição acima
Enviar para Trás Move a Pena selecionada para uma posição inferior na
ordem de sobreposição das Penas. As opções
disponíveis são Enviar para Trás: Move a Pena
selecionada para a última posição ou Recuar: Move a
Pena selecionada uma posição abaixo
Enquadrar Enquadra a Pena da Exibição selecionada tanto no eixo

vertical quanto no eixo horizontal
Editar Permite editar as informações da Pena selecionada
Mostrar Detalhes Mostra uma janela com informações detalhadas da Pena
Remover Pena Remove a Pena selecionada da Exibição
NOTAS
· Ao desmarcar a caixa de seleção ao lado de uma Pena, esta Pena para de receber dados em tempo real.
· Clicar no ícone da cor de uma Pena abre a caixa de diálogo padrão para seleção de cores do Windows.
Ao selecionar a opção Editar no menu contextual de uma Pena, a janela da figura a seguir é mostrada.
Janela Editar
Opções disponíveis na janela Editar
OPÇÃO DESCRIÇÃO
Título Permite alterar o título de uma Pena
Conexão Permite selecionar o tipo de conexão de uma Pena. Os

valores possíveis são Discreto ou Contínuo
433 TrendAnalysis
OPÇÃO DESCRIÇÃO
Tipo de linha Permite selecionar o tipo de linha de uma Pena. Os
valores possíveis são Nenhum: Sem linha, apenas
pontos, Sólida: Linha sólida, Área: Desenha a área da
Pena, Traço: Linha tracejada, Traço Ponto: Linha com
traço-ponto ou Traço Ponto Ponto: Linha com traço-
ponto-ponto
Tipo de ponto Permite selecionar o tipo dos pontos de uma Pena. Os

valores possíveis são Nenhum: Sem indicação do ponto,
Círculo, Quadrado, Triângulo ou Losango
Largura da linha Permite configurar a largura da linha de desenho de uma

Pena
Tipo Permite configurar o tipo da conexão. Os valores

possíveis são Não ligar pontos ruins: Não conecta
pontos com qualidade ruim, Ligar até ruim: Conecta
pontos até que a qualidade seja ruim ou Ignorar ruim:
Ignora pontos com qualidade ruim
Varredura (ms) Permite configurar o tempo de varredura de uma Pena
NOTA
As opções Tipo de linha e Tipo de ponto não podem ser configuradas simultaneamente com o valor Nenhum.
Ao clicar na opção Mostrar detalhes no menu contextual de uma Pena, a janela da figura a seguir é mostrada.
Janela Detalhes
Opções disponíveis na janela Detalhes
OPÇÃO DESCRIÇÃO
Conexão Mostra o nome da conexão da Pena
Fonte Mostra a fonte de dados da Pena
Estado Mostra o status da última consulta da Pena
Duração Mostra o tempo de duração da última consulta da Pena
Pontos recebidos Mostra o número de pontos recebidos na última consulta

da Pena
TrendAnalysis 434
Também é possível editar as Escalas vertical, Numérica, e horizontal, de Tempo, de uma Exibição. Para isto, clique com
o botão direito do mouse na Escala e selecione a opção Editar. As figuras a seguir mostram as opções disponíveis
em cada uma das Escalas.
Janela Escala Numérica

Opções disponíveis na janela Escala Numérica
OPÇÃO DESCRIÇÃO
Título Título da Escala Vertical
Mostrar título Habilita ou desabilita a visualização da Escala Vertical
Superior Valor máximo da Escala Vertical
Inferior Valor mínimo da Escala Vertical
Mostrar linhas de grade Habilita ou desabilita a visualização das linhas de grade

da Escala Vertical em relação à Escala de Tempo
Escala do eixo digital Ajusta a Escala Vertical para visualização de variáveis

digitais ou discretas
Enquadrar automaticamente Ao selecionar esta opção, as Penas que utilizam esta

Escala Vertical são permanentemente enquadradas de
acordo com o período visível. Neste modo, a Escala
Vertical não pode ser arrastada
435 TrendAnalysis
Janela Escala de Tempo
Opções disponíveis na janela Escala de Tempo
OPÇÃO DESCRIÇÃO
Início Data e hora iniciais mostradas na Escala de Tempo
Fim Data e hora finais mostradas na Escala de Tempo
Mostrar linhas da grade Mostra ou esconde as linhas de grade relativas à Escala

de Tempo
NOTA
Para adicionar ou remover Escalas Numéricas, use as opções e junto à Escala. Não é possível remover a
Escala Numérica original nem é possível adicionar ou remover a Escala de Tempo. Para criar novas Escalas de
Tempo, adicione uma nova Exibição.
24.2 Aba Marcadores

A aba Marcadores permite adicionar um marcador, ou bookmark, a um determinado período de tempo de uma Pena.
Para isto, clique com o botão direito do mouse na área da aba e selecione a opção Novo Marcador para abrir a
janela da figura a seguir.
Janela Marcador
Opções disponíveis na janela Marcador
OPÇÃO DESCRIÇÃO
Nome Nome do marcador
Início Data e hora iniciais do marcador
Fim Data e hora finais do marcador
TrendAnalysis 436
NOTA
Também é possível adicionar um marcador ao clicar com o botão direito do mouse na área da Exibição e selecionar
a opção Selecionar período. Depois de selecionar um período de tempo, clique com o botão direito do mouse na
área do período e selecione a opção Adicionar Marcador.
Ao clicar com o botão direito do mouse em um Marcador, é possível selecionar as opções descritas na tabela a
seguir.
Opções disponíveis no menu contextual de um Marcador
OPÇÃO DESCRIÇÃO
Aplicar a Aplica este Marcador a uma Exibição específica
Aplicar a Todas Não Agrupadas Aplicar este Marcador a todas as Exibições que não são
parte de um agrupamento
Editar Permite editar o Marcador selecionado
Remover Remove o Marcador selecionado
Novo Marcador Permite adicionar um novo Marcador
24.3 Aba Conexões

A aba Conexões mostra a conexão com o Elipse Power e os Tags disponíveis para uso nas Exibições. Para adicionar
uma Pena, arraste um Tag para a área da Exibição ou clique com o botão direito do mouse em um Tag e selecione a
opção Inserir.
24.4 Área de Exibições

A barra de título de uma Exibição mostra um ícone que representa o modo de reprodução daquela Exibição, seja
reproduzindo ou pausada .
No modo de reprodução, a Escala de Tempo se desloca em direção ao futuro, permitindo que se acompanhem
valores em tempo real. Mover a Escala de Tempo para o passado ou aplicar um zoom não altera o sentido de
deslocamento da Escala.
Quando as Exibições estão agrupadas, somente uma das Exibições está em modo de reprodução e as outras
Exibições no grupo copiam este movimento. Ao remover uma Exibição pausada de um grupo, esta Exibição para o
deslocamento. Se uma Exibição é adicionada a um grupo em deslocamento, esta Exibição também entra em
deslocamento.
O agrupamento de Exibições é utilizado para associar as Escalas de Tempo entre Exibições. Todas as Escalas de
Tempo de um grupo têm o mesmo fator de zoom, mas com períodos diferentes. Isto possibilita a comparação de
períodos diferentes usando a pesquisa, como por exemplo comparar um determinado mês ao mês anterior.
Para criar um agrupamento de Exibições, clique no ícone na barra de título das Exibições. Para remover uma
Exibição de um agrupamento, clique no ícone na barra de título da Exibição.
Quando agrupadas, todas as Exibições compartilham o mesmo modo de reprodução. Clique no ícone para
reproduzir e no ícone para pausar a reprodução. Os modos Pesquisar, Zoom e Selecionar são executados em
todas as Exibições de um grupo, de acordo com a relação entre os períodos.
Ao clicar com o botão direito do mouse na área de uma Exibição, é possível selecionar as opções descritas na tabela
a seguir.
Opções disponíveis no menu contextual da área de uma Exibição
OPÇÃO DESCRIÇÃO
Selecionar Permite selecionar uma Pena específica de uma Exibição
Mover Permite arrastar as Escalas de Tempo e Numérica sem

alterar o fator de zoom
Selecionar Período Permite selecionar um período de tempo específico
437 TrendAnalysis
OPÇÃO DESCRIÇÃO
Zoom Permite demarcar uma região específica da área da
Exibição. Os valores possíveis nesta opção são Zoom
XY: Demarca a região tanto no eixo vertical quanto no
eixo horizontal, Zoom X: Demarca a região somente no
eixo horizontal ou Zoom Y: Demarca a região somente
no eixo vertical
Pesquisar Permite visualizar os valores dos pontos das Penas ou

executar uma interpolação. Os valores possíveis nesta
opção estão descritos na tabela Opções disponíveis no
modo Pesquisar
Ir Para Permite ajustar a Escala de Tempo para períodos pré-

determinados. Os valores possíveis para esta opção são
Último Dia, Última Hora, Última Meia Hora, Últimos 10
Minutos ou Agora
Voltar Zoom Volta para o nível de zoom selecionado anteriormente, se

disponível
Enquadrar Enquadra as Penas da Exibição selecionada no período

de tempo selecionado
Mostrar Linhas de Grade Habilita a visualização de linhas de grade na área de

plotagem da Exibição
Copiar Imagem Copia a área da Exibição atual para a Área de

Transferência do Windows como uma imagem no
formato PNG
Exportar para CSV Exporta o conteúdo da Exibição para um arquivo no

formato CSV (Comma-Separated Values). Clicar nesta
opção abre a janela Exportar, descrita mais adiante
Editar Permite editar uma Exibição. Clicar nesta opção abre a

janela de edição, descrita mais adiante
Adicionar Exibição Permite adicionar uma nova Exibição. Os valores

possíveis para esta opção são No Topo, Na Direita, Na
Esquerda ou Na Base
Opções Permite configurar diversas opções de uma Exibição.

Clicar nesta opção abre a janela Opções, descrita mais
adiante
Opções disponíveis no modo Pesquisar

OPÇÃO DESCRIÇÃO
Painel Superior Anterior Permite visualizar a estampa de tempo, o valor e o nome
do ponto anterior ao ponteiro do mouse
Painel Superior Interpolado Permite visualizar a estampa de tempo, o valor e o nome

de um ponto interpolado em relação ao ponto anterior e
posterior ao ponteiro do mouse
Rótulo Interpolado Permite visualizar o valor de um ponto interpolado em

relação ao ponto anterior e posterior ao ponteiro do
mouse
Rótulo Mais Próximo Permite visualizar o valor do ponto mais próximo ao

ponteiro do mouse
Manter Último Ponto Pesquisado Permite que o ponteiro do mouse permaneça fixo na tela
durante uma pesquisa
TrendAnalysis 438
OPÇÃO DESCRIÇÃO
Inserir Ponto de Pesquisa Insere um ponto de pesquisa no centro da tela, usando a
última configuração de pesquisa da sessão atual ou
usando o modo Rótulo Mais Próximo se nenhuma
pesquisa foi executada
Ao clicar em Exportar para CSV, a janela da figura a seguir é mostrada.
Janela Exportar
Opções disponíveis na janela Exportar
OPÇÃO DESCRIÇÃO
Arquivo Permite indicar o arquivo de saída da exportação. Clique
em para selecionar um diretório de saída
Início Permite selecionar a data e hora de início da exportação
Fim Permite selecionar a data e hora de término da

exportação
Incluir qualidade Permite incluir a qualidade da Pena na exportação
Incluir Período Inicial e Final Permite incluir um ponto anterior ao período indicado na
opção Início e um ponto posterior ao período indicado
na opção Fim, se existirem
Incluir milissegundos Permite incluir os milissegundos nos períodos indicados
Ao clicar em Editar, a janela da figura a seguir é mostrada.
439 TrendAnalysis
Janela de edição de uma Exibição
Opções disponíveis na janela de edição de uma Exibição
OPÇÃO DESCRIÇÃO
Título Título da Exibição
Atualização automática Habilita ou desabilita o modo de autoatualização
Intervalo mínimo (ms) Intervalo mínimo de atualização, em milissegundos. O

menor valor aceito nesta opção é dois segundos, ou
2000 ms
Interpolar (usando spline cúbica) Utiliza uma interpolação de spline cúbico para o desenho
da Exibição
Mostrar legenda local Mostra ou esconde uma legenda com o nome da Pena e
a respectiva cor
Mostrar pontos mín./máx. Mostra ou esconde os pontos máximos e mínimos na

Exibição
Mostrar Linhas da Grade Mostra ou esconde as linhas de grade na Exibição
Ao clicar em Opções, a janela da figura a seguir é mostrada.
TrendAnalysis 440
Janela Opções
Opções disponíveis na janela Opções
OPÇÃO DESCRIÇÃO
Tema de Cores Permite selecionar um tema de cor para a Exibição. Os
valores possíveis são Claro ou Escuro
Mostrar seleção da Pena Mostra a Pena selecionada em destaque na Exibição
Posição Permite selecionar a posição onde é mostrado o Painel

de Tarefas com as abas Exibições, Marcadores e
Conexões. Os valores possíveis são No Topo, Na Base,
Na Esquerda ou Na Direita
Mostrar Painel de Tarefas Mostra ou esconde o Painel de Tarefas
Diferença UTC (s) Permite indicar um fuso horário, em segundos, ao

horário das Penas na Exibição
Usar horário local (diferença não usada) Usa o horário local, desprezando a opção Diferença
UTC (s)
24.5 Atalhos de Teclado

A tabela a seguir contém os atalhos de teclado disponíveis no TrendAnalysis.
Atalhos de teclado disponíveis no TrendAnalysis
0 (zero) Enquadra o eixo selecionado, vertical ou horizontal
Barra de espaço Reproduz ou pausa uma Exibição
CTRL + 0 (zero) Enquadra os eixos horizontais e verticais
CTRL + DELETE Remove um ponto de pesquisa de uma Exibição
CTRL + F6 Navega entre as Penas do eixo vertical selecionado
CTRL + G Exibe ou oculta a grade de uma Exibição
CTRL + INS Insere um ponto de pesquisa no centro da tela, usando

a última configuração de pesquisa da sessão atual ou
usando o modo Rótulo Mais Próximo caso não tenha
sido realizada nenhuma pesquisa
441 TrendAnalysis
CTRL + K Permite que o ponteiro do mouse permaneça fixo na
tela durante uma pesquisa
CTRL + Sinal de mais (+) Executa uma operação de zoom in no eixo do tempo
CTRL + Sinal de menos (-) Executa uma operação de zoom out no eixo do tempo
CTRL + T Exibe ou oculta o Painel de Tarefas
CTRL + TAB Alterna o foco entre o Painel de Tarefas e as Exibições
CTRL + Tecla de seta à direita Move o ponto de pesquisa para a direita
CTRL + Tecla de seta à esquerda Move o ponto de pesquisa para a esquerda
CTRL + Z Executa uma operação de zoom back, quando disponível
DELETE Remove uma área de plotagem se não há Escala Vertical

selecionada. Caso contrário, remove a Escala Vertical da
área associada
END Move para o período atual de tempo
ENTER Seleciona a Exibição ou a Pena atual no Painel de

Tarefas
ESC Limpa a seleção atual
F5 Atualiza todas as conexões na aba Conexões
F6 Permite selecionar individualmente os eixos
F11 Exibe ou oculta o Painel de Tarefas
H Exibe ou oculta a Exibição selecionada no Painel de

Tarefas
INS Adiciona uma área de plotagem se não há Escala

Vertical selecionada. Caso contrário, adiciona uma nova
Escala Vertical na área associada
L Adiciona ou remove o agrupamento da Exibição
PAGE DOWN Muda a Escala de Tempo do gráfico para unidades

menores, como por exemplo de horas para minutos
PAGE UP Muda a Escala de Tempo do gráfico para unidades

maiores, como por exemplo de minutos para horas
Roda do mouse Rola a área de Exibição horizontalmente ou

verticalmente
Seta à direita Move para o próximo ponto na Escala de Tempo
Seta à esquerda Move para o ponto anterior na Escala de Tempo
Seta para baixo Move para baixo o eixo selecionado
Seta para cima Move para cima o eixo selecionado
SHIFT + TAB Navega pelas Exibições, no sentido anti-horário
Sinal de mais (+) Executa uma operação de zoom in do eixo vertical

selecionado
Sinal de menos (-) Executa uma operação de zoom out do eixo vertical
selecionado
TAB Navega pelas Exibições, no sentido horário
Tecla de aplicação ou de menu Abre o menu contextual do item selecionado nas abas
Exibições, Marcadores e Conexões
TrendAnalysis 442
CAPÍTULO
E3Playback
25
Uma ferramenta de playback visa facilitar o pós-operação, sobretudo a análise de ocorrências. Sua necessidade é
justificada por permitir que o usuário visualize, através das telas de monitoramento em tempo real, as variações de
eventos e pontos analógicos em tempo passado que, em determinados casos, pode ser complicado observando
apenas relatórios de eventos e valores analógicos.
Cabe ressaltar que um playback é uma ferramenta que permite a um operador experiente e conhecedor do processo
interpretar os acontecimentos de forma mais clara. Não faz parte do escopo de um playback a identificação
automática de solução ou de causa de uma ocorrência.
Um exemplo prático de uso de um playback pode ser o seguinte:
O usuário, ao chegar em seu horário de trabalho, recebe a informação de uma grave ocorrência acontecida durante a
madrugada, por volta das 3h15min. Ele pode então abrir na ferramenta de playback uma tela que contém o ponto gerador
do evento e outros pontos relacionados, movendo o relógio para as 03h10min e clicando em Play. Ao observar a tela sendo
animada com os dados históricos, o usuário facilmente acompanha o estado geral do processo, avançando e retrocedendo
livremente no tempo até compreender perfeitamente a causa da ocorrência.
25.1 Objeto E3Playback

O E3Playback, a ferramenta de playback da Elipse Software, é um ActiveX que executa dentro do Elipse Power
Viewer ou do WebViewer e que permite visualizar as Telas do aplicativo utilizando dados históricos armazenados em
bancos de dados.
O E3Playback busca no banco de dados os Tags referenciados nas Telas, bem como as demais Associações entre um
Elipse Power Viewer e servidor (tais como os Tags do Viewer com Associações para objetos do servidor), e mostra
valores, animações, estados e gráficos de acordo com as informações existentes no banco de dados e o período de
playback definido.
25.2 Interface de Usuário

A interface de usuário do E3Playback é dividida em seis partes:
· Barra de Ferramentas
· Linha de Tempo
· Marcadores
· Área de Telas
· Lista de Eventos
· Lista de Tags
25.2.1 Barra de Ferramentas

A Barra de Ferramentas Playback reúne os principais comandos para operação do E3Playback.
Barra de ferramentas Playback

Esta barra de ferramentas possui as opções descritas na tabela a seguir.
Opções disponíveis na barra de ferramentas Playback
OPÇÃO AÇÃO
Reproduzir para Trás Inicia a reprodução dos dados no horário atual de
playback, retrocedendo o relógio de acordo com a
velocidade de reprodução atual
Pausa Congela o relógio de playback no tempo atual
Reproduzir Inicia a reprodução dos dados no horário atual de

playback, avançando o relógio de acordo com a
velocidade de reprodução atual
443 E3Playback
OPÇÃO AÇÃO
Parar Interrompe o playback, os dados de Tags e
alarmes são removidos das Telas e nenhuma nova
consulta é realizada no banco de dados
Mais Devagar Diminui a velocidade de playback pela metade. O

valor mínimo é 1/1024x, isto é, avança
aproximadamente um milissegundo de dados a
cada segundo
Velocidade Normal Deixa a velocidade de playback no valor normal

(1x)
Mais Rápido Dobra a velocidade de playback. O valor máximo é

de 1024x, isto é, a cada segundo o relógio de
playback avança 1024 segundos (aproximadamente
17 minutos)
Permite selecionar a velocidade de playback
Seletor de Velocidade
Data e Hora Atual Mostra a data e hora atual do relógio de playback,

e permite selecionar uma nova data
Mostrar ou Esconder a Linha de Tempo Mostra ou oculta a janela Linha de Tempo do

E3Playback
Mostrar ou Esconder a Lista de Tags Mostra ou oculta a janela Tags do E3Playback
Mostrar ou Esconder a Lista de Eventos Mostra ou oculta a janela Eventos do E3Playback
Iniciar ou Parar a Gravação de Vídeo Permite gerar um vídeo (em formato AVI)
capturando toda a área do ActiveX de playback
durante um determinado período, ou até que o
usuário mande parar a gravação
Capturar a Tela do E3Playback Permite capturar a área de Tela do ActiveX de

playback. A Tela capturada pode ser salva em um
arquivo BMP ou copiada para a Área de
Transferência
Ao selecionar a ferramenta Gravação de Vídeo , a seguinte janela de configurações é mostrada.
E3Playback 444
Janela Opções de gravação
Opções disponíveis na janela Opções de gravação
OPÇÃO DESCRIÇÃO
Salvar vídeo como Mostra o local e o nome do arquivo de vídeo a ser salvo.
Clique em para navegar pelas pastas do computador
Tempo máximo de gravação Permite definir um tempo total para gravação. Se o valor
estiver em Indefinido, a gravação apenas para se o
botão de gravação de vídeo do E3Playback é
pressionado. A opção Tempo permite que seja pré-
definido um tempo máximo de gravação, em segundos
(neste caso a gravação é encerrada automaticamente ao
final do tempo estipulado)
Quadros por segundo Configura o número de quadros (frames) capturados a

cada segundo de gravação
Mostrar cursor na gravação Quando esta opção estiver habilitada, o cursor do mouse
aparece no vídeo gravado. O padrão desta opção é
desabilitada. O ponteiro do mouse gravado no vídeo é o
que estiver configurado como padrão do Windows.
Ponteiros com animação não são animados no vídeo.
Neste caso, é mostrado sempre o primeiro quadro da
animação
Compressor Compressor de vídeo utilizado na gravação. São listados

todos os compressores que estão instalados no
computador, desde que sejam suportados pelo
E3Playback
Qualidade de compressão Configura a taxa de compressão, que afeta a qualidade

final do vídeo e, consequentemente, o tamanho do
arquivo gerado
445 E3Playback
OPÇÃO DESCRIÇÃO
Intervalo de quadros a cada quadro-chave Configura a quantidade de quadros a cada quadro-chave
(key frame)
Configurar (compressão de vídeo) Abre uma nova janela que possui configurações
específicas do compressor selecionado
Sobre Abre uma nova janela que possui informações sobre o

compressor selecionado
Gravar áudio Habilita a gravação de áudio. O padrão desta opção é

desabilitada
Dispositivo Lista os dispositivos de áudio instalados e habilitados no

sistema, e que podem ser utilizados na captura de áudio
Formato Mostra informações sobre o formato de áudio atualmente

selecionado
Atributos Mostra informações sobre os atributos do formato de

áudio atualmente selecionado
Configurar (gravação de áudio) Mostra uma janela que permite alterar o formato de
gravação e os atributos do áudio
Mostrar resumo ao concluir gravação Habilita ou desabilita a janela que é mostrada no

momento em que a gravação é finalizada
25.2.2 Linha de Tempo

A Linha de Tempo permite acompanhar visualmente e controlar o relógio de playback.
Linha de tempo
As opções deste componente estão descritas na tabela a seguir.
Opções disponíveis na Linha de Tempo
OPÇÃO DESCRIÇÃO
Régua Mostra a linha de tempo. Pode-se mover a linha de tempo
para os lados clicando e arrastando o ponteiro do mouse.
O zoom é controlado pela roda do mouse. Girar para
cima realiza um zoom in. Girar para baixo realiza um zoom
out. É necessário primeiro clicar no fundo da linha de
tempo antes de tentar executar o zoom. Se a tecla CTRL
estiver pressionada, o zoom é realizado três vezes mais
rápido
Cursor Marca a posição atual do relógio de playback. Quando o

playback está no modo Pausa pode-se arrastar o cursor
para os lados, alterando o relógio de playback enquanto
arrasta-se o cursor. Está sempre visível na linha de tempo
Barra de Consultas Mostra os períodos de tempo que já têm dados

carregados:
· Uma linha verde clara significa que naquele período os
dados já estão totalmente carregados
· Uma linha verde escura indica que os dados do período
estão sendo carregados
E3Playback 446
OPÇÃO DESCRIÇÃO
· Uma linha amarela clara indica que o período contém
alguns dados carregados. Novas consultas ao banco de
dados são necessárias se o cursor é movido para cima
do período
· Uma linha cinza clara indica que o período não tem
nenhum dado carregado ainda. Para carregar os dados
do período, mova o cursor de playback para cima do
período
Barra de Dados Indica com um ponto azul cada momento em que há um

evento de playback
Barra de Zoom Geral Mostra o período de dados que está sendo mostrado na
Linha de Tempo, comparado com o período total de
dados disponível para playback
Caso tenha sido selecionada a opção Mostrar gráfico na Linha de Tempo de um Tag na Lista de Eventos ou na
Lista de Tags, é mostrada uma representação visual do Tag à esquerda do gráfico. Esta representação 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 gráfico de estado do Tag, onde o valor do Tag aparece sempre sobre uma
linha inferior (Off ou False) ou sobre uma linha superior (On ou True). A linha do gráfico permanece pontilhada nos
períodos em que a qualidade do Tag está ruim
· Double, Integer ou Analógico: Mostra um gráfico de linha com os valores do Tag. A escala do gráfico (inferior e
superior) é calculada automaticamente de acordo com os valores do Tag que o E3Playback já consultou no banco
de dados. Assim como no gráfico digital, a linha do gráfico permanece pontilhada nos períodos em que a
qualidade do Tag está ruim. A linha também pode ser interpolada ou em escada, dependendo se o Tag suporta
(Storage) ou não (Histórico) interpolação
Mostrar gráfico na Linha de Tempo

Cada Tag adicionado na Linha de Tempo possui uma cor definida automaticamente, que pode ser alterada usando a
opção Alterar a cor do menu contextual. Esta opção abre a janela de Cores do sistema, permitindo selecionar uma
nova cor ou personalizar a cor selecionada.
25.2.3 Marcadores
Os Marcadores são utilizados para sinalizar ocorrências na linha de tempo do E3Playback.
Marcadores
Opções disponíveis na barra de ferramentas Marcadores
OPÇÃO AÇÃO
Adicionar Marcador no Timestamp Selecionado Adiciona um nome ao marcador na linha de tempo, na
data e hora selecionadas
447 E3Playback
OPÇÃO AÇÃO
Editar Marcador Selecionado Permite editar o marcador selecionado, podendo alterar
data e hora, nome ou descrição
Remover o Marcador Remove o marcador selecionado na linha de tempo
Remover Todos os Marcadores Remove todos os marcadores criados na linha de

tempo
Mover para o Marcador Anterior Seleciona o marcador imediatamente à frente na linha

de tempo e na lista de eventos, simultaneamente
Mover para o Marcador Seguinte Seleciona o próximo marcador na linha de tempo e na

lista de eventos, simultaneamente
Clicando em Adicionar ou em Editar , a janela da figura a seguir é mostrada.
Janela Adicionar/Editar Marcador

Opções disponíveis na janela Adicionar/Editar Marcador
OPÇÃO DESCRIÇÃO
Data/hora/ms Permite selecionar a data e a hora, incluindo os
milissegundos, do marcador. Estes campos já vêm
preenchidos com a data e a hora selecionadas na linha
de tempo
Nome Permite selecionar o nome do marcador
Comentários Permite informar algum comentário adicional para o

marcador
Quando um marcador é criado, este é mostrado na Linha de Tempo, como pode ser observado na figura a seguir, e
também na Lista de Eventos.
Linha de Tempo com marcadores
25.2.4 Área de Telas

Esta é a área onde são mostradas as Telas do aplicativo. A Tela inicial mostrada é a configurada na propriedade
InitialScreen do E3Playback. Se esta propriedade é deixada em branco, é utilizada a Tela inicial do Elipse Power
Viewer.
E3Playback 448
Área de Telas
A Área de Telas funciona como se fosse um Elipse Power Viewer dentro do E3Playback. As Telas são sempre abertas
no zoom Preencher. É possível navegar livremente entre as Telas do aplicativo.
Existem algumas restrições e comentários quanto ao funcionamento das Telas dentro do E3Playback:
· As Telas funcionam como se estivessem em um Elipse Power Viewer Somente Leitura, isto é, não é permitido o
envio de comandos e valores para o servidor Elipse Power. Isto garante que as operações efetuadas no
E3Playback não vão perturbar o funcionamento do aplicativo em tempo real
· Não é permitido acesso aos objetos do servidor através do método Application.GetObject. Se este método é
chamado em algum script, falha abortando o script
· Devido às várias limitações de acesso ao servidor, erros de script ocorridos dentro do E3Playback não geram
uma mensagem de erro, e os scripts são abortados silenciosamente
· O E3Playback emula um Elipse Power Viewer real. Para isto é criada uma nova cópia do objeto Elipse Power
Viewer e seus Tags para uso do E3Playback. Se algum comportamento específico do Elipse Power Viewer tiver
que ser habilitado ou desabilitado dentro do E3Playback, pode-se testar a propriedade IsPlaybackMode do
Viewer
· O isolamento entre as Telas que executam dentro do E3Playback e o que está fora é total
· O E3Playback trata os novos Quadros criados pelo aplicativo como novas abas no topo da Área de Telas. O título
da aba é o nome do Quadro ou Tela que foi aberto
Quadros abertos em abas no E3Playback

· Todas as Associações que se referem a objetos do servidor são capturadas pelo E3Playback, e passam a receber
os dados históricos de acordo com o relógio atual de playback. Isto inclui não apenas as Associações realizadas
nas Telas que estão sendo mostradas, mas também as Associações existentes nos Tags do Elipse Power Viewer
· As Associações realizadas entre objetos do Elipse Power Viewer (por exemplo, um Display mostrando o valor de
um Tag Demo interno ao Elipse Power Viewer) funcionam normalmente, sem nenhuma interferência do playback
· O E3Chart só funciona dentro do E3Playback se estiver configurado com Penas históricas. Penas de tempo real
são desabilitadas dentro do E3Playback (permanecem sem dados)
449 E3Playback
· O E3Alarm mostra o sumário de alarmes de acordo com o que estiver registrado na tabela de alarmes no banco
de dados
· O E3Browser funciona normalmente, já que consultas ao banco de dados são permitidas dentro do E3Playback
NOTA
Os dados mostrados no E3Browser são sempre os dados ATUAIS do banco de dados, isto é, o E3Playback não
tenta emular o estado do banco de dados em um momento no passado.
25.2.5 Lista de Eventos

A Lista de Eventos mostra a sequência cronológica de eventos de playback, permitindo a navegação evento a evento.
Um evento de playback pode ser:
· Uma alteração no valor de um Tag
· Uma alteração no estado de um alarme
Lista de Eventos
As colunas desta janela estão descritas na tabela a seguir.
Colunas da Lista de Eventos
COLUNA DESCRIÇÃO
Data/hora Mostra a data e a hora do evento, conforme está
registrado no banco de dados
Caminho do Tag Mostra o caminho do Tag ou da fonte de alarmes que

gerou este evento, ou o nome do Marcador
Evento Se o evento é de mudança do valor de um Tag, mostra o

novo valor. Se a qualidade não é Boa (192), esta é
mostrada na frente do valor (por exemplo, "Ruim(20);
45.433"). Se o evento é uma alteração no estado de um
alarme, mostra o nome da subcondição (HI, HIHI, LO,
LOLO, etc.) e a descrição do alarme. Se o alarme está
(ou foi) reconhecido, mostra no início o texto "ACK", com
o nome do operador entre parênteses. Se é um
Marcador, este campo mostra o comentário associado
A barra de ferramentas da Lista de Eventos possui as opções listadas na tabela a seguir.

Opções da barra de ferramentas da Lista de Eventos
OPÇÃO AÇÃO
Evento Anterior Posiciona o relógio de playback no evento anterior ao
evento selecionado na lista, pulando os eventos com
estampa de tempo igual à estampa de tempo atual
E3Playback 450
OPÇÃO AÇÃO
Próximo Evento Posiciona o relógio de playback no próximo evento com
estampa de tempo maior que a estampa de tempo atual
Filtrar Eventos Liga ou desliga o filtro de eventos. Ao ligar o filtro,

apenas os eventos do Tag ou da fonte de alarme
selecionado atualmente são mostrados na lista de
eventos. Os Marcadores são mostrados sempre,
independente do filtro
Filtrar Marcadores Mostra apenas os Marcadores criados
Ao clicar com o botão direito do mouse em um evento, um menu contextual é mostrado com as opções descritas na
tabela a seguir.
Opções do menu contextual dos eventos
OPÇÃO DESCRIÇÃO
Mostrar ou Remover gráfico na Linha de Tempo Adiciona ou remove uma representação visual do Tag
selecionado na janela Linha de Tempo
Mostrar apenas os eventos deste tag ou Mostrar todos Filtra os eventos na Lista de Eventos para mostrar apenas
os eventos o Tag selecionado. Selecionando de novo esta opção,
todos os eventos são mostrados
25.2.6 Lista de Tags

A Lista de Tags mostra os Tags que estão sendo utilizados para playback.
Lista de Tags
As colunas desta janela estão descritas na tabela a seguir.
Colunas da Lista de Tags
COLUNA DESCRIÇÃO
Caminho do Tag Mostra o caminho do Tag
Tabela Mostra o nome da tabela do banco de dados que

contém os dados do Tag
Estado Indica se o Tag foi encontrado ou não no banco de

dados
Valor Mostra o valor do Tag na data e hora atual de playback
Data/hora Mostra a estampa de tempo atual do Tag. Se o Tag

suportar interpolação (apenas para pontos analógicos
armazenados no Storage), então a estampa de tempo é
igual ao horário atual de playback. Caso contrário, a
estampa de tempo é a do último evento com estampa de
tempo anterior ou igual ao horário atual de playback
451 E3Playback
COLUNA DESCRIÇÃO
Qualidade Mostra a qualidade do Tag (padrão OPC) no momento
atual de playback. Quando a qualidade é 192, mostra
apenas o texto "Boa"
Evento Anterior Mostra a estampa de tempo do evento anterior deste

Tag no banco de dados. Se o Tag não suportar
interpolação, o evento anterior é sempre igual à estampa
de tempo atual do Tag. Se o Tag suportar interpolação,
o evento anterior é a última estampa de tempo
registrada no banco de dados antes do horário atual de
playback
Próximo Evento Mostra a estampa de tempo do próximo evento deste

Tag
NOTA
A Lista de Tags pode ajudar também 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 botão direito do mouse em um Tag, um menu contextual é mostrado com as mesmas opções
descritas no tópico Lista de Eventos, exceto no caso de Tags marcados com o ícone , em que o menu contextual
aparece desabilitado.
25.3 Banco de Dados de Playback

O E3Playback detecta automaticamente quais são os Tags e os alarmes que estão armazenados no banco de dados.
Este processo de detecção do banco de dados é chamado de Montagem. Depois que o banco de dados está
montado, o E3Playback utiliza as informações coletadas para realizar consultas aos dados armazenados, de acordo
com os Tags que estão sendo mostrados na Tela e de acordo com o relógio atual de playback.
25.3.1 Montagem do Banco de Dados

A Montagem do Banco de Dados é realizada sempre que o E3Playback é ativado. As informações de estrutura do
banco de dados coletadas durante a montagem são mantidas enquanto a seção de playback estiver ativa. Os passos
da montagem do banco de dados podem ser resumidos da seguinte forma:
1. Enumerar todas as tabelas do banco de dados.
2. Verificar quais destas tabelas possuem uma tabela _Fields correspondente. Por exemplo, quando o Elipse Power
gera uma tabela de alarmes chamada E3Alarms, gera também uma tabela com a descrição dos campos da tabela
de alarmes (E3Alarms_Fields).
3. Analisar os campos de cada tabela, bem como o conteúdo da sua tabela _Fields correspondente para determinar
o tipo de tabela. O E3Playback reconhece três tipos de tabela:
· Storage: A tabela deve ter os campos E3TimeStamp, FieldID, Quality e FieldValue
· Alarmes: A tabela deve ter os campos EventTime (ou EventTimeDbl), ConditionActive, Acked, AckRequired e
FullAlarmSourceName
· Histórico: A tabela deve ter o campo E3TimeStamp e não pode ter sido reconhecida como uma tabela de
Storage ou de Alarmes
4. Se a tabela é de Storage, a tabela _Fields é varrida para determinar quais são os Tags armazenados na tabela. O
caminho do Tag é determinado pelo campo FieldName da tabela _Fields. O campo que fornece a estampa de
tempo dos dados de Storage é sempre o campo E3TimeStamp. Cada Storage pode ter até três tabelas de
dados, uma para cada tipo de dados:
· Strings: O nome da tabela de dados é <Tabela>_String
· Bit/Digital: O nome da tabela de dados é <Tabela>_Bit
· Double/Analógicos: O nome da tabela de dados é <Tabela>
5. Se a tabela é de Histórico, a tabela _Fields é varrida para determinar quais são os Tags armazenados na tabela. O
caminho do Tag neste caso é determinado pelo campo FieldSource. O campo que fornece a estampa de tempo
dos dados desta tabela é sempre o campo E3TimeStamp.
E3Playback 452
6. Se a tabela é de alarmes, a tabela _Fields é varrida para determinar o nome dos campos de alarme de usuário, se
existirem. O campo que fornece a estampa de tempo na tabela de alarmes é o campo EventTime, opcionalmente
combinado com o campo EventTimeMS se existir, ou o campo EventTimeDbl. Este último tem prioridade por
representar os milissegundos com mais precisão.
7. Depois que todas as tabelas de dados e os caminhos dos Tags são detectados, é realizada uma consulta simples
em cada uma das tabelas para determinar a data mais antiga e a data mais nova armazenada na tabela. Isto
permite determinar o intervalo de datas em que o playback é permitido.
NOTAS
· O intervalo de datas válidas não é atualizado durante um processo de playback, de forma que os dados novos
adicionados ao banco de dados após a montagem só estão disponíveis se a janela de playback é fechada e aberta
novamente.
· Em modo Demo (ou com uma licença de Elipse Power Studio), o período permitido para playback se resume às
últimas seis horas de dados armazenados no banco de dados.
25.3.2 Consultas de Dados de Playback

A quantidade de dados disponível para playback pode ser enorme, dependendo do aplicativo. Para tornar a
navegação de Telas mais suave, o E3Playback executa consultas ao banco de dados em períodos de tempo chamados
Fatias.
Cada fatia de dados de playback tem uma largura fixa de um dia. Sempre que o relógio é posicionado em uma
determinada data e hora, o E3Playback cria ou encontra a fatia de tempo que contém a data e hora atual. Cada fatia
de dados possui as seguintes informações:
· Período de tempo da fatia (data e hora inicial e final)
· Uma lista dos Tags que já têm os seus dados carregados na fatia
· Para cada Tag armazenado em uma fatia, são mantidos os seguintes dados:
· O último evento do Tag anterior ao início da fatia
· Todos os eventos do Tag dentro do intervalo da fatia
· O próximo evento do Tag após o final da fatia
· O sumário de alarmes no momento do início da fatia
· Todos os eventos de alarmes que ocorreram durante o intervalo da fatia
· O próximo evento de alarme de cada Fonte de Alarme após o final da fatia
Quando o relógio de playback é movido sobre uma fatia de tempo, o E3Playback analisa se todos os Tags necessários
já estão carregados na fatia, e se todas as informações de alarme também já foram carregadas. Se estiver faltando
algum dado, então é gerada uma consulta assíncrona para carregar os dados necessários do banco de dados. Uma
consulta de dados de playback é composta dos seguintes parâmetros:
· Período que vai ser consultado (data e hora inicial e final)
· Conjunto de Tags que devem ser consultados (pode estar vazio). Para cada Tag deve ser retornado:
· O último evento anterior ao início da consulta
· Todos os eventos ocorridos durante o período da consulta
· O próximo evento que ocorreu após o período da consulta
· Informações de alarmes que devem ser consultadas, que podem ser zero ou mais das seguintes opções:
· Sumário de alarmes anterior (estado de cada Fonte de Alarme na data e hora inicial da consulta)
· Eventos de alarmes no período
· Sumário de alarmes posterior (próximo evento de cada Fonte de Alarme após a data e hora final do período)
Para executar uma consulta a dados de playback, normalmente são necessárias várias consultas ao banco de dados. O
servidor de dados de playback efetua estas consultas de forma assíncrona e em um thread separado, coleta os dados
e só os retorna quando todas as consultas tiverem terminado.
Quando uma consulta de playback é completada, os dados são imediatamente adicionados à fatia correspondente e o
E3Playback automaticamente dispara consultas para atualizar as fatias vizinhas. Desta forma, à medida que o relógio
de playback avança, as consultas de dados vão sendo realizadas, e quando o relógio passa para a próxima fatia é
bem provável que esta já tenha todos os seus dados carregados.
453 E3Playback
Caso o relógio de playback esteja no modo Reproduzir e entre em uma fatia sem dados ou com dados incompletos,
o E3Playback permanece temporariamente pausado aguardando até que as consultas daquela fatia sejam
completadas.
O E3Playback também busca minimizar o acesso ao banco de dados, aproveitando as informações dos campos
Último evento anterior, Próximo evento após, Sumário anterior e Sumário posterior para evitar que estes dados
sejam consultados novamente. Por exemplo:
· Se uma consulta a um Tag não retornou o próximo evento após o período da consulta, é sinal de que este Tag
não possui nenhum evento após a data e hora final da consulta, e portanto este Tag não precisa ser consultado
nas fatias de tempo posteriores
· Se uma consulta retornou o sumário anterior, eventos de alarmes no período e o sumário posterior para uma
fatia, é possível calcular o sumário anterior da próxima fatia simplesmente combinando o sumário anterior e os
eventos ocorridos durante a fatia atual. Desta forma, torna-se desnecessário consultar no banco de dados o
sumário anterior da próxima fatia
25.4 Configuração dos Objetos de Banco de Dados do Elipse

Power
Esta seção explica como os objetos do Elipse Power devem ser configurados para que os dados armazenados no
banco de dados possam ser utilizados no E3Playback.
25.4.1 Storage
A única recomendação para o Storage é que a coluna Fonte não deve conter expressões, pois estas não podem ser
utilizadas no playback.
O Elipse Power já cria automaticamente nas tabelas de Storage os índices necessários para otimizar as consultas do
E3Playback.
25.4.2 Alarmes
Para executar o playback de alarmes, siga estes procedimentos:
1. Habilite ou configure o registro de alarmes em disco.
2. Selecione os seguintes campos para registro (obrigatórios):
· EventTime (mais EventTimeMS) ou EventTimeDbl
· FullAlarmSourceName
· ConditionActive
· Acked
· AckRequired
3. Ainda é recomendada a seleção dos seguintes campos para registro:
· InTime (mais InTimeMS) ou InTimeDbl
· OutTime (mais OutTimeMS) ou OutTimeDbl
· AckTime (mais AckTimeMS) ou AckTimeDbl
· Area
· ActorID
· Enabled
· EventCategory
· EventType
· Message
· Severity
· Source
· SubConditionName
· CurrentValue
E3Playback 454
Seleção dos campos
O Elipse Power já cria automaticamente na tabela de alarmes os índices necessários para otimizar as consultas de
playback.
25.4.3 Históricos
O formato de arquivo Histórico não é o ideal para playback, pois normalmente muitos dados duplicados estão
armazenados. As consultas de playback têm um trabalho extra para eliminar os valores duplicados de cada Tag e
encontrar apenas os eventos de mudança de valor, o que pode exigir longas consultas sequenciais na tabela do
Histórico. Recomenda-se o uso do Storage sempre que possível. Se o uso de dados de Histórico no playback é
indispensável, deve-se seguir ao máximo as seguintes recomendações:
· Configurar a propriedade UserTable para Falso. Se esta propriedade está configurada em Verdadeiro, a tabela
_Fields deste Histórico não é gerada e este Histórico não é reconhecido pelo playback
· Colocar cada Tag em um campo separado, ou seja, não utilizar expressões na fonte do campo
· Criar um índice para o campo E3TimeStamp. Sem este índice as consultas ao Histórico tornam-se muito lentas,
tornando o playback impraticável
· Utilizar tabelas com poucos campos e, se possível, adicionar um índice individual para cada campo,
principalmente para os campos com poucas variações
· Configurar a propriedade CompressedTable em Verdadeiro e utilizar a propriedade DeadBand no Histórico
A figura a seguir mostra como deve ser a configuração de um índice para o campo E3TimeStamp:
Definição de um índice para o campo E3TimeStamp
455 E3Playback
25.4.4 Licenças
A Elipse Software fornece os seguintes pacotes de playback, de acordo com as ferramentas:
· Playback Básico
· Playback Avançado: Consiste no Playback Básico mais as ferramentas Gravação de Vídeo e Captura de Tela
Cada um destes pacotes é dimensionado conforme o número de pontos (Tags e Fontes de Alarmes) armazenados no
banco de dados. Por exemplo, um Playback Básico 1000 permite realizar o playback de um banco de dados com até
1000 pontos. Se o banco de dados tem mais pontos que as licenças disponíveis, a montagem do banco de dados
falha e é mostrada uma mensagem de erro indicando que não há licenças disponíveis para executar o playback.
A licença de Elipse Power Studio inclui uma licença de Playback Avançado sem limite de pontos, porém limitada às
últimas seis horas de dados armazenados no banco de dados. Isto permite que o desenvolvedor do aplicativo teste o
playback sem precisar adquirir as licenças para isto.
Em modo Demo (quando não há dispositivo de proteção), o playback também funciona no modo Avançado sem
limite de pontos, porém limitado a mostrar apenas as últimas seis horas de dados armazenados no banco de dados,
em relação à hora atual do servidor.
IMPORTANTE
Se o dispositivo de proteção é do tipo Master (Elipse Power Studio + Runtime) ou apenas de Runtime, o playback
só está disponível se houver licenças programadas no dispositivo. Para mais informações sobre as limitações do
modo Demo do Elipse Power, consulte o tópico Limitações do Modo Demonstração.
E3Playback 456
CAPÍTULO
Fórmulas
26
Fórmulas são módulos destinados ao armazenamento e transferência de conjuntos de valores para determinados
agrupamentos de variáveis, de forma a criar configurações pré-definidas. São compostas de Templates, Unidades e
Conjuntos de Valores.
As Fórmulas podem ser utilizadas para facilitar processos industriais. Por exemplo, uma fábrica de bebidas produz
vários tipos de sucos, cada um deles com uma receita diferente. Neste caso, os Templates são os sabores (laranja,
uva, tangerina, etc.). As Unidades são os tanques onde os sucos são produzidos. Os Conjuntos de Valores são o tipo
e a quantidade de produtos colocados em cada suco (por exemplo, 50 g de açúcar, 1000 l de água, polpa de fruta,
etc.). Para utilizar este recurso, siga este procedimento:
1. Clique com o botão direito do mouse no nome do projeto no Organizer e selecione a opção Inserir - Fórmula.
Inserindo uma Fórmula
NOTA
O objeto Fórmula pode ser configurado para funcionar como Área de Alarme.
Quando se cria uma Fórmula, é mostrada uma janela para a configuração do Banco de Dados e da tabela a ser
utilizados. Sem isto, não é possível a criação de Unidades e Conjuntos de Valores.
457 Fórmulas
Configuração do Banco de Dados e da tabela
Opções disponíveis na janela Configuração do Banco de Dados
OPÇÃO DESCRIÇÃO
Banco de Dados Determina o servidor de Banco de Dados que gerencia
os dados configurados na Fórmula. Este campo equivale
à propriedade DBServer da Fórmula
Tabela Determina o nome da tabela onde são guardados os

dados da Fórmula. Este campo equivale à propriedade
TableName da Fórmula
Tamanho máximo dos campos de Unidades Determina o tamanho máximo dos campos de Unidades
na tabela do Banco de Dados. O valor padrão deste
campo é 200. Este campo equivale à propriedade
DataSourceSize da Fórmula
Tamanho máximo dos campos de Valores Determina o tamanho máximo dos campos de Valores na
tabela do Banco de Dados. O valor padrão deste campo
é 200. Este campo equivale à propriedade ValueSize da
Fórmula
Caso seja necessário configurar estas opções posteriormente, ou mesmo reconfigurá-las, selecione a opção
Configurar Banco de Dados no menu contextual da Fórmula.
Fórmulas 458
Configurando o Banco de Dados
26.2 Templates
A primeira aba no Editor de Fórmulas chama-se Templates. Os Templates definem o tipo de dados que pode ser
armazenado em cada variável da Fórmula, além de suas restrições.
Aba Templates
Opções disponíveis na aba Templates
OPÇÃO DESCRIÇÃO
Nome Define o nome do Template
Tipo Define o tipo do Template
459 Fórmulas
OPÇÃO DESCRIÇÃO
Restrições Determina as restrições do Template
A barra de ferramentas da aba Templates contém as opções Adicionar , para a criação de um novo Template, e
Remover , para a exclusão do Template selecionado.
Ao clicar em Restrições , a janela da figura a seguir é mostrada.
Edição das restrições

As restrições permitem habilitar ou desabilitar a alteração dos valores da Fórmula em tempo de execução, ou então
estipular limites para esta alteração. As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Edição das Restrições
OPÇÃO DESCRIÇÃO
Limite Irrestrito O usuário pode alterar qualquer valor no Template. É
simbolizado pela letra U na aba Templates
Limite Restrito O usuário não pode alterar o valor do Template. É

simbolizado pela letra R na aba Templates
Limite Absoluto São definidos valores fixos como limites,

correspondendo ao valor mínimo e máximo do
Template. É simbolizado pela letra A na aba Templates
(e os valores mínimo e máximo configurados no campo)
Limite Percentual Valor percentual acima ou abaixo do valor pré-definido.

Por exemplo, colocando os limites entre 20% e 30%, para
o valor 100, os valores permitidos variam entre 80 e 130.
É simbolizado pela letra P na aba Templates (e os
valores configurados no campo)
Limite por diferença Valores fixos acima ou abaixo do valor pré-definido. 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 aba Templates (e os valores
configurados no campo)
Fórmulas 460
26.3 Unidades
A segunda aba no Editor de Fórmulas chama-se Unidades. As Unidades definem os Tags que são associados aos
Templates da Fórmula. É possível criar várias Unidades, ou seja, vários grupos de Tags que podem receber os valores
da Fórmula.
Aba Unidades
Opções disponíveis na aba Unidades
OPÇÃO DESCRIÇÃO
Nome Determina o nome do Template
Unidade Determina o Tag que é associado à Unidade
A barra de ferramentas da aba Unidades contém as opções Adicionar , para a criação de uma nova Unidade,
Remover , para a exclusão da Unidade selecionada, e Renomear , para a troca do nome da Unidade selecionada.
Para cada nova Unidade, a janela a seguir é mostrada para definir um nome.
Adição de uma Unidade
26.4 Conjunto de Valores

A terceira aba no Editor de Fórmulas chama-se Valores. Conjuntos de Valores são os valores transferidos para os
Tags, ou seja, para as Unidades.
Aba Valores
Opções disponíveis na aba Valores
OPÇÃO DESCRIÇÃO
Nome Determina o nome do Template
Valor Determina o valor dos campos para os Conjuntos de

Valores
461 Fórmulas
A barra de ferramentas da aba Valores contém as opções Adicionar , para a criação de um novo Conjunto de
Valores, Remover , para a exclusão do Conjunto de Valores selecionado, e Renomear , para a troca do nome do
Conjunto de Valores selecionado.
26.5 Criação de uma Fórmula

Instruções
Este exercício cria um objeto Fórmula para armazenar Conjuntos de Valores para a produção de uma determinada
peça. Esta peça tem três medidas: Diâmetro Externo, Diâmetro Interno e Altura. Esta Fórmula armazena os valores
para duas máquinas diferentes que produzem estas peças.
26.5.1 Procedimentos
1. Insira um objeto Fórmula na aplicação.
2. Configure o Banco de Dados e a tabela. Use um Banco de Dados existente no projeto, e nomeie a tabela como
"Produção".
Configurações do Banco de Dados e da tabela

3. Crie três Templates na Fórmula:
· Diâmetro Externo: Com restrição de valor absoluta entre 50 e 80
· Diâmetro Interno: Com restrição por diferença de valor de 10 e 10
· Altura: Com limite restrito
Templates
4. Na próxima etapa são definidas as Unidades relativas a esta Fórmula. Antes de criar as Unidades, no entanto,
deve-se criar os Tags usados nesta Fórmula. Para isto, insira em um Servidor de Dados uma Pasta chamada
"Formula" e dentro dela outras duas Pastas chamadas "Maquina1" e "Maquina2". Dentro destas Pastas crie três
Tags Internos para cada uma.
Fórmulas 462
Criando Tags
5. Crie na Fórmula duas Unidades chamadas "Maquina1" e "Maquina2". Associe cada campo destas Unidades aos
Tags criados anteriormente.
Associando os Tags às Unidades da Fórmula

6. Defina os Conjuntos de Valores a serem carregados posteriormente nos Tags. Crie quatro Conjuntos de Valores,
chamados de "Modelo1" até "Modelo4", e digite os valores mostrados na figura a seguir.
Configuração do Conjunto de Valores

7. Crie agora uma nova Tela chamada "Fórmulas".
8. Crie seis objetos SetPoint nesta Tela, que devem ser associados a cada um dos Tags da Fórmula, e ajuste o
tamanho da Tela ao dos objetos. A Tela deve estar semelhante à figura a seguir.
463 Fórmulas
Tela de Fórmula
NOTA
Às vezes, pode ocorrer um erro na Tela que faz com que as imagens desapareçam. Para solucionar esta questão,
deve-se desabilitar a opção Esconder extensões do MS-DOS para arquivos registrados. Esta opção está disponível
no Windows Explorer.
9. Crie um botão na Tela com o título "Carregar valores". Este botão mostra uma caixa de diálogo com os valores
existentes e as Unidades para as quais estes podem ser carregados, podendo ser selecionada qualquer opção.
Para tanto, crie o seguinte script neste botão.
Application.LoadFormulaDlg_
"Formula1", "Maquina1, Maquina2",_
"Modelo1, Modelo2, Modelo3, Modelo4"
End Sub
Onde Formula1 é o nome do objeto Fórmula criado e o método LoadFormulaDlg é um método do Viewer. Ao ser
executado este método, a caixa de diálogo da figura a seguir é mostrada.
Caixa de diálogo do método LoadFormulaDlg

10. Na divisão da direita são apresentadas as duas Unidades criadas na Fórmula, assim como os Conjuntos de
Valores. A opção Modo Silencioso inibe a possibilidade de o usuário alterar valores gravados em disco, que são
carregados para os Tags.
Fórmulas 464
11. Através deste botão, pode-se ver a aplicação funcionando com as Fórmulas e os Tags recebendo os valores do
disco. Este é um dos métodos para carregar valores de uma Fórmula, mas também existem métodos em que o
usuário não necessita selecionar os valores ou as Unidades em uma caixa de diálogo.
12. Crie agora um objeto SetPoint na Tela e um botão com o título "OK". Junto com o SetPoint, coloque um texto de
identificação com o título "Modelo:". No botão deve ser criado o seguinte script.
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo1"
Screen.Item("Texto16").Value
End Sub
Onde Texto16 é o nome do último SetPoint inserido na Tela. Este comando carrega o Conjunto de Valores
especificado no SetPoint para a Unidade Maquina1. Ao ser executado, este método busca pelo Conjunto de Valores
em disco. Caso encontre, carrega-o seguindo o padrão de restrições definido no Template da Fórmula. Os campos
com restrições abertas podem ter seus valores modificados pelo usuário. Para que o usuário não seja interrogado
sobre as mudanças de valores nos campos carregados, deve-se utilizar o modo silencioso.
Alteração do valor
No entanto existe uma alternativa, o método LoadFormulaValuesQuiet, do Viewer. É feita uma opção pelo modo
silencioso na Tela, utilizando para isto, o objeto Caixa de Seleção.
1. Crie um objeto Caixa de Seleção na Tela.
2. Coloque um texto de identificação ao seu lado, com o texto "Silencioso".
3. Volte ao script do botão OK e mude o código para o seguinte:
If Screen.Item("CheckBox1").Value = true Then
Application.LoadFormulaValuesQuiet_
Else
End If
End Sub
Onde CheckBox1 é o nome da Caixa de Seleção criada. Isto faz com que se o objeto estiver habilitado, seja utilizado
o método LoadFormulaValuesQuiet. Caso contrário, é utilizado o método LoadFormulaValues.
1. Repita os últimos procedimentos desde a criação do SetPoint para os itens da Maquina2, modificando os scripts
necessários. Ao final das alterações, a Tela deve estar semelhante à figura a seguir.
465 Fórmulas
Tela final da Fórmula
2. Execute a aplicação e observe os resultados.
Fórmulas 466
CAPÍTULO
Relatórios
27
O Relatório é um componente ActiveX chamado ActiveReport, que permite a visualização e impressão de valores
instantâneos de variáveis do sistema e dados armazenados em Banco de Dados (Alarmes, Históricos, Consultas e
Fórmulas). Estes dados podem ser impressos tanto em formato texto como em formato gráfico, sendo este último
feito através do objeto E3Chart.
NOTAS
· O objeto Relatório NÃO está disponível na versão 64 bits do Elipse Power. Entretanto, o Relatório pode ser
editado na versão 32 bits do Elipse Power Studio, presente na instalação 64 bits.
· Um Elipse Power Viewer 32 bits conectado a um Servidor 64 bits imprime Relatórios normalmente.
Para utilizar o Relatório, siga os procedimentos a seguir.

1. Clique com o botão direito no item Relatórios do Organizer e selecione a opção Inserir Relatório em.
Inserindo um Relatório
2. Caso necessite, configure as propriedades deste objeto.
27.1 Objeto Consulta

Este objeto permite que seja especificada a origem dos dados do Banco de Dados que são visualizados no Relatório.
Após ter criado o Relatório no projeto, este cria o objeto Consulta. Para mais informações a respeito deste objeto,
consulte o capítulo Consultas.
27.2 Componentes
Um Relatório contém várias Seções. Cada Seção do Relatório contém um grupo de controles que são processados e
impressos ao mesmo tempo, como uma unidade.
467 Relatórios
Seções do Relatório
O Relatório define tipos de Seção, que são explicados nos tópicos a seguir.
27.2.1 Detail
A Seção Detail é o corpo do Relatório, que imprime uma vez para cada registro da fonte de dados.
27.2.2 Group Header e Group Footer

Um Relatório pode ter múltiplos grupos aninhados. Cada grupo possui uma Seção Header e uma Seção Footer. A
Seção Header imprime antes de qualquer Seção Detail no grupo. A Seção Footer imprime depois de todas as Seções
Detail do grupo. Seções de grupo são inseridas imediatamente antes e depois da Seção Detail.
O número de vezes que uma Seção de grupo pode imprimir depende de como os dados são agrupados. O Relatório
inicia um novo grupo (Header, Detail e Footer) para cada mudança nos dados que são reunidos no grupo.
27.2.3 Page Footer

A Seção Page Footer imprime uma vez na base de cada página do Relatório. Usada para imprimir totais de páginas,
números de páginas ou qualquer outra informação que necessite ser impressa uma vez na base de cada página.
27.2.4 Page Header

A Seção Page Header imprime uma vez o topo de cada página do Relatório. É a primeira Seção que imprime na
página, exceto quando esta página contém a Seção Report Header. Usada para imprimir totais de páginas, números
de páginas, títulos de páginas ou qualquer outra informação que necessite ser impressa uma vez no topo de cada
página.
27.2.5 Report Footer

A Seção Report Footer imprime no final do Relatório. É usada para imprimir uma soma de um relatório, totais gerais
ou qualquer outra informação que necessite ser impressa somente uma vez no final do Relatório.
Relatórios 468
27.2.6 Report Header
Um Relatório pode ter uma Seção Report Header que imprime no início do Relatório. É geralmente utilizada para
imprimir títulos de relatório, tabelas de somas, gráficos ou qualquer outra informação que necessite aparecer
somente uma vez no início do Relatório.
NOTA
Uma Seção Report Header pode estender-se por múltiplas páginas. Para isto, insira um objeto Quebra de Página
em seu conteúdo.
O Relatório possui vários objetos que podem ser agregados e que são acessados através da barra de ferramentas.
Clique com o botão direito do mouse no Relatório para mostrar um menu contextual. As opções deste menu variam
de acordo com o local do clique do mouse.
Na área do Relatório, somente as opções Insert e Delete Section estão habilitadas, conforme a figura a seguir.
Menu da área do
Relatório
Em um objeto no Relatório, somente as opções Insert, Delete, Cut, Copy, Paste, Bring to Front, Send to Back,
Alignment e Format Border estão habilitadas, conforme a figura a seguir.
Menu de objeto do
Relatório
Em mais de um objeto selecionado no Relatório, todas as opções do menu estão habilitadas, conforme a tabela a
seguir.
469 Relatórios
Opções disponíveis no menu contextual do Relatório
OPÇÃO DESCRIÇÃO
Insert Permite inserir um novo componente do Relatório. As
opções disponíveis são Group Header/Footer: Adiciona
um novo par de cabeçalhos ou rodapés de grupo no
Relatório, Page Header/Footer: Adiciona um novo par
de cabeçalhos ou rodapés de página ou Report
Header/Footer: Adiciona um novo par de cabeçalhos ou
rodapés no Relatório
Delete e Delete Section Apaga a Seção, objeto ou grupo selecionado. Esta opção
não é aplicada na Seção Detail do Relatório
Reorder Groups Reorganiza os grupos selecionados. Esta opção é válida

quando vários grupos de Seção (pares de cabeçalho ou
rodapé) são adicionados no Relatório. Esta opção não é
aplicada na Seção Detail do Relatório
Cut Recorta o objeto, grupo ou Seção selecionado
Copy Copia o objeto, grupo ou Seção selecionado
Paste Cola o objeto, grupo ou Seção na Seção corrente do

Relatório
Bring to Front O objeto, grupo ou Seção selecionado é enviado para a

primeira posição na ordem de sobreposição
Send to Back O objeto, grupo ou Seção selecionado é enviado para a

última posição na ordem de sobreposição
Align Alinha o objeto, grupo ou Seção selecionado. As opções

disponíveis são Lefts: Alinhamento esquerdo, Centers:
Alinhamento centralizado, Rights: Alinhamento direito,
Tops: Alinhamento no topo, Middles: Alinhamento
central, Bottoms: Alinhamento mesma altura, To grid:
Alinhamento conforme a grade ou Center in Section:
Alinhamento centralizado na Seção
Size Determina o tamanho do objeto, grupo ou Seção

selecionado. As opções disponíveis são Make same
width: Mesma largura, Make same Height: Mesma
altura ou Make same size: Mesmo tamanho
Horizontal Spacing Determina o espaçamento horizontal do objeto no

Relatório. As opções disponíveis são Make Equal:
Espaçamento igual entre os objetos, Increase: Incrementa
o espaçamento do objeto em um passo ou Decrease:
Decrementa o espaçamento do objeto em um passo
Vertical Spacing Determina o espaçamento vertical do objeto. As opções

disponíveis são Make Equal: Espaçamento igual entre os
objetos, Increase: Incrementa o espaçamento do objeto
em um passo ou Decrease: Decrementa o espaçamento
do objeto em um passo
Format Border Determina o formato da borda do objeto do Relatório.

Para o objeto Quadro o nome da opção é Format Pane
Border
Properties Mostra a Janela de Propriedades. Esta opção só está

disponível para os objetos Campo de Dados, E3Chart e
Quadro
Split Horizontally Divide o painel selecionado horizontalmente. Esta opção

só está disponível para o objeto Quadro
Relatórios 470
OPÇÃO DESCRIÇÃO
Split Vertically Divide o painel selecionado verticalmente. Esta opção só
está disponível para o objeto Quadro
Delete Pane Apaga o painel selecionado. Esta opção só está

disponível para o objeto Quadro
Quando a opção Format Border ou Format Pane Border é selecionada, a caixa de diálogo da figura a seguir é
mostrada.
Opções de borda do objeto

Opções disponíveis para a borda de um objeto
OPÇÃO DESCRIÇÃO
Presets Determina o estilo da borda externa de um objeto
Line Styles Determina o estilo da linha da borda de um objeto
Preview Prévia de configuração de um objeto
Color Determina a cor da borda de um objeto
Shadow Habilita ou desabilita a sombra de um objeto
Através da barra de ferramentas do Relatório é possível acessar os recursos descritos nos próximos tópicos.
27.3.1 Preview
Através desta opção, pode-se visualizar uma prévia da impressão do Relatório. Assim é possível verificar
configurações de margem e figuras, entre outras.
471 Relatórios
Prévia de impressão do Relatório
Configurações da Prévia de Impressão
OPÇÃO DESCRIÇÃO
Tabela de Conteúdo Mostra uma tabela com o conteúdo do Relatório
Imprime o Relatório, abrindo a Tela de
Imprime o Relatório configuração de impressão
Copia Conteúdo Selecionado Copia o conteúdo selecionado
Procurar Texto Procura um texto específico no Relatório
Visualização de Página Simples Permite visualizar o Relatório em uma página

simples
Visualização de Múltiplas Páginas Permite visualizar o Relatório em múltiplas páginas
Menos Zoom Diminui o zoom na página
Mais Zoom Aumenta o zoom na página
Permite selecionar uma porcentagem de zoom na

Porcentagem de Zoom
página
Página Anterior e Próxima Página Move para a página anterior ou para a próxima
página, respectivamente
27.3.2 Report Settings

Através desta opção, é possível configurar as especificações do Relatório, tais como configurações de página,
impressão, grade e estilo do Relatório.
A aba Page Setup configura as especificações referentes à página do Relatório.
Relatórios 472
Configurações de página do Relatório
Opções de configuração Page Setup (página)
OPÇÃO DESCRIÇÃO
Top Margin Determina a margem do topo da página
Bottom Margin Determina a margem do conteúdo da página
Left Margin Determina a margem esquerda da página
Right Margin Determina a margem direita da página
Gutter Determina a margem da página
Mirror Margins Habilita ou desabilita a margem espelhada da página
A aba Printer Settings configura as especificações referentes à impressão do Relatório.
473 Relatórios
Configurações de impressão do Relatório
Opções de configuração Printer Settings (Impressora)
OPÇÃO DESCRIÇÃO
Paper Size Determina o tamanho do papel
Width Determina a largura do papel
Height Determina a altura do papel
Orientation Determina a orientação do papel na impressora. As

opções disponíveis são Printer Default: Configurações
de acordo com a impressora padrão, Portrait: Layout da
página na vertical ou Landscape: Layout da página na
horizontal
Collate Ordena a impressão
Duplex Duplica a impressão
PaperBin Determina as configurações e o tipo de papel para a

impressão
A aba Grid Settings determina as configurações referentes às grades do Relatório.
Relatórios 474
Configurações da grade do Relatório
Opções de configuração Grid Settings (grade)
OPÇÃO DESCRIÇÃO
Show Grid Habilita ou desabilita a grade
Align Controls to Grid Habilita ou desabilita o alinhamento dos controles na

grade
Grid Columns Determina o número de colunas na grade
Grid Rows Determina o número de linhas na grade
Ruler Units Determina o tipo de unidade da régua. As opções

disponíveis são Inches (polegadas) ou Centimeters
(centímetros)
A aba Styles determina as configurações referentes ao estilo do Relatório.
475 Relatórios
Configurações de estilo do Relatório
Opções de configuração Styles (estilos)
OPÇÃO DESCRIÇÃO
New / Delete / Lista Determina o estilo do Relatório. Pode-se inserir um novo
estilo clicando em New, apagar um estilo clicando em
Delete ou utilizar os estilos existentes na lista
Font / Colors / Misc Determina as especificações do estilo do Relatório, como

por exemplo fontes, cores de fundo e frente e
orientação, entre outras
27.3.3 Script Editor

O Editor de Scripts (Script Editor) é utilizado para criar scripts nos Relatórios do Elipse Power. A linguagem utilizada
para criar os scripts no Relatório é a Active Scripting, que interage com o Visual Basic. Quando o Editor de Scripts
está aberto, disponibiliza os métodos e eventos dos objetos e componentes do Relatório. Para utilizar este recurso,
clique em Script Editor , disponível na barra de ferramentas do Relatório.
Editor de Scripts
Relatórios 476
Na opção Object é necessário especificar o objeto onde se deseja criar o script e na opção Events, o evento do
Relatório em que ocorre a ação.
27.3.4 Carregar Arquivo RPX

Importa a configuração do Relatório de um arquivo externo.
27.3.5 Salvar Arquivo RPX

Exporta a configuração do Relatório para um arquivo externo.
27.3.6 Objetos
Esta seção contém informações sobre os objetos que podem ser usados em um Relatório.
27.3.6.1 Caixa de Seleção

O objeto Caixa de seleção insere um dado no Relatório que pode ou não estar ligado ao Banco de Dados. Seu valor
é do tipo Booleano.
Caixa de seleção
Após ser inserido no Relatório, este objeto é chamado de "CheckBox".
27.3.6.2 Campo de Dados

O objeto Campo de Dados é utilizado para inserir um dado do Banco de Dados no Relatório. Este dado é indicado
através da propriedade DataField.
Campo de Dados
Após ser inserido no Relatório, este objeto é chamado de "Field".
27.3.6.2.1 Exemplo de Utilização

O exemplo a seguir demonstra como mostrar a média por dia de um campo da consulta no Relatório. Para tanto, siga
1. Insira um novo GroupHeader/Footer no Relatório.
2. Configure a propriedade DataField do GroupHeader para "=Day(E3TimeStamp)". Isto determina que o cálculo da
média é feito por dia.
3. Insira um Campo de Dados no GroupHeader com a propriedade DataField igual a "=Day(E3TimeStamp)".
4. Insira um Campo de Dados no GroupFooter com a propriedade DataField igual ao nome do campo que é
calculada a média.
5. Configure as seguintes propriedades do Campo de Dados do GroupHeader:
· SummaryFunc: 1 - ddSFAvg
· SummaryGroup: GroupHeader1
· SummaryRunning: 1 - ddSRGroup
· SummaryType: 3 - ddSMSubTotal
27.3.6.3 Código de Barras

O objeto Código de Barras permite gerar uma figura que converte uma sequência de números e caracteres em um
código de barras. Este código de barras é uma representação numérica ou alfanumérica, utilizada para facilitar
diferentes processos. Este código é decifrado através de scanners, canetas ou equipamentos de leitura óptica.
477 Relatórios
Código de
barras
Após ser inserido no Relatório, este objeto é chamado de "Barcode".
27.3.6.4 E3Chart
O objeto E3Chart é um componente ActiveX utilizado para exibir um gráfico mostrando Tags variando em tempo real
e também mostrar dados históricos gravados em um Banco de Dados.
E3Chart
NOTA
O E3Chart não pode ser adicionado na Seção Detail do Relatório.
Existem algumas diferenças de funcionamento entre o E3Chart na aplicação e no Relatório. Na aplicação, o E3Chart
consegue plotar gráficos em tempo real, histórico e misto. Já quando este objeto é utilizado em um Relatório, não é
permitida sua utilização com dados em tempo real ou mistos, somente com dados históricos.
Note que nenhum objeto do Relatório pode ser acessado externamente, ou seja, ao se criar o Relatório pelo
aplicativo, não é possível acessar suas propriedades nem tampouco as de seus objetos via scripts do aplicativo. Por
isto, as alterações nos objetos, incluindo o E3Chart, devem ser realizadas diretamente no Elipse Power Studio ou em
eventos do próprio Relatório.
Para mais informações sobre este objeto, consulte o capítulo E3Chart.
27.3.6.5 Elipse
O objeto Elipse permite o desenho de círculos e elipses, utilizando toda a largura ou a altura e definindo o centro do
círculo no centro do retângulo.
Elipse
Após ser inserido no Relatório, este objeto é chamado de "Shape".
27.3.6.6 Figura
O objeto Figura permite mostrar imagens que estejam armazenadas em arquivos, tanto em arquivos externos como
em arquivos de recurso da aplicação.
Relatórios 478
Figura
Após ser inserido no Relatório, este objeto é chamado de "Image".
27.3.6.7 Linha
O objeto Linha liga dois pontos quaisquer. Permite o desenho de retas, através de dois pontos especificados na sua
criação ou em polígonos.
Linha
Após ser inserido no Relatório, este objeto é chamado de "Line".
27.3.6.8 Quadro
O objeto Quadro é composto de linhas e colunas onde são inseridos textos ou gráficos. Os Quadros dos Relatórios
são usados para organizar e apresentar informações. Pode-se também usar Quadros para criar disposições de
página, ou criar textos, gráficos e tabelas animadas como em uma página em HTML.
Quadro
Após ser inserido no Relatório, este objeto é chamado de "Frame".
27.3.6.9 Quebra de Página

O objeto Quebra de Página é um ponto em que uma página termina e outra começa no Relatório. Por exemplo,
pode-se forçar uma quebra de página para assegurar que o título de um capítulo comece sempre em uma nova
página. Ao trabalhar com documentos que contenham diversas páginas e inserir quebras de página manuais, talvez
seja necessário reinseri-las com frequência à medida que se edita o documento. Também pode-se impedir que uma
quebra de página ocorra em um parágrafo ou em uma linha de tabela, ou ainda assegurar que uma quebra de
página não seja inserida entre dois parágrafos, como entre um título e o parágrafo seguinte.
Quebra de Página
27.3.6.10 Retângulo
O objeto Retângulo permite o desenho de retângulos, utilizando toda a largura ou altura do objeto. Criado a partir
de dois vértices.
479 Relatórios
Retângulo
27.3.6.11 Retângulo Arredondado

O objeto Retângulo Arredondado é um retângulo criado a partir de dois vértices, com cantos arredondados a partir
de um fator de arredondamento.
Ao ser inserido ou editado, exibe um pequeno ponto próximo ao seu canto superior esquerdo, que permite modificar
o fator de arredondamento.
Retângulo arredondado
27.3.6.12 Texto
O objeto Texto possibilita a criação de um texto. Ao definir a área na Tela, pode-se digitar diretamente o texto
desejado, que aceita também múltiplas linhas.
Texto
Após ser inserido no Relatório, este objeto é chamado de "Label".
27.4 Criando um Relatório no Elipse Power

Este exemplo contempla a criação de um Relatório no Elipse Power para extração de dados de um Histórico.
27.4.1 Definição de Áreas

O Relatório padrão, criado quando é inserido um novo Relatório a um projeto, tem as seguintes áreas:
· Page Header: Área mostrada em todas as páginas do Relatório, como cabeçalho
· Detail Area: Área repetida tantas vezes quantas forem necessárias, é o corpo do Relatório
· Page Footer: Rodapé da página, trabalha do mesmo modo que o Page Header
Existem ainda dois tipos de Áreas:

· Report Header/Footer: Áreas que são impressas uma única vez, não importando o tamanho do Relatório em
páginas. Esta área vem como abertura ou fechamento do Relatório
· Group Header/Footer: Um grupo é utilizado para dividir no Relatório conjuntos de valores iguais de uma mesma
variável. Esta área se repete sempre que um grupo é apresentado. No exemplo aqui demonstrado não é utilizada
nenhuma construção deste tipo. Esta área sempre envolve uma área de detalhes
Estas duas áreas podem ser acessadas clicando com o botão direito do mouse no Relatório e selecionando a opção
Insert.
27.4.2 Configuração da Consulta

Para a extração de dados de um Banco de Dados, é necessário configurar a consulta do Relatório. Podem existir
várias consultas diferentes para o mesmo Relatório, mas apenas uma pode estar ativa em determinado momento.
Para tanto, deve-se seguir estes procedimentos:
Relatórios 480
1. Configure a propriedade DataSource com o nome do Banco de Dados onde é executada a consulta. Neste caso,
"ServidorDB".
2. Determine a propriedade Table com a tabela de consulta, que neste caso é "Dados".
3. Configure a propriedade Name para manter o nome original, ou seja, "Consulta1".
27.4.3 Configuração dos Campos

Neste exemplo são criadas quatro temperaturas armazenadas em um Histórico e estas temperaturas são o objeto de
interesse do Relatório. Sendo assim, os valores lidos do Histórico são impressos através do Relatório.
Para ler dados de um Banco de Dados, a área ideal é a Detail Area, visto que esta área é repetida automaticamente
quantas vezes seja necessário. Desta maneira, devem ser inseridos cinco Campos de Texto nesta área. Estes campos
podem ser ligados a um Campo de Dados, que é configurado através da propriedade DataField. Aqui, são usados os
seguintes valores:
· Field1: E3Timestamp
· Field2: Temperatura1 (como está no Banco de Dados)
· Field3: Temperatura2
27.4.4 Visualização
É possível executar a visualização do Relatório criado clicando-se em Preview , disponível na área de edição.
Para tanto, é necessário direcionar o servidor de Banco de Dados do projeto para o arquivo MDB da pasta onde foi
salvo o exemplo.
27.5 Exemplos de Utilização

A seguir são mostrados alguns exemplos de utilização dos recursos dos Relatórios.
27.5.1 Configurando o Caminho de um Bitmap na Impressão

Para utilizar este recurso, escreva o script a seguir no evento OnFormat das Seções PageHeader ou ReportHeader.
Sub OnFormat
Report.Sections("ReportHeader")._
Controls("Image2").Picture = _
LoadPicture("c:\correio\teste.bmp")
End Sub
27.5.2 Configurando o Valor de um Código de Barras na Seção Detail

Para utilizar este recurso, escreva o script a seguir no evento OnFormat da Seção Detail.
Sub OnFormat
Report.Sections("Detail").Controls("BarCode1")
Caption = Right(Report.Field("E3TimeStamp"), 8)
End Sub
27.5.3 Capturando uma Tela e Gerando uma Prévia de Impressão

Para utilizar este recurso, digite o script a seguir.
Sub Rect_Click()
'Esta chamada de método também pode ser realizada
'utilizando-se Application.CaptureScreen()
Screen.Frame.CaptureScreen("c:\correio\teste.bmp")
Application.LoadReport("[Relatório3]").PrintPreview()
End Sub
27.5.4 Gerando um Menu Exportar

Para utilizar este recurso, escreva o script a seguir.
Sub Retangulo3_Click()
Set report = Application.LoadReport("[Relatório3]")
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!"
481 Relatórios
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
27.5.5 Como Criar Relatórios Mostrando Página N de M

Para criar um Relatório que a cada página imprime um indicativo de Página N de M onde N é a página atual e M o
total de páginas, crie dois Textos e dois Campos de Dados.
Os dois Textos correspondem aos textos Página e de, que devem ser inseridos na propriedade Caption. Os dois
Campos de Dados correspondem aos valores N e M, com as seguintes propriedades:
Campo N
· Name: txtPageNumber
· SummaryType: 4 - ddSMPageCount
Campo M
· Name: txtPageCount
· SummaryType: 4 - ddSMPageCount
27.5.6 Como Criar Relatórios Imprimindo somente Médias de Valores a

cada 5 Minutos
Para isto, deve-se criar um novo grupo no Relatório. O grupo criado tem uma Seção Header e uma Seção Footer. O
layout geral é o seguinte:
· PageHeader: Contém o título das colunas
· GroupHeader: Permanece vazio, porém a propriedade DataField tem o valor igual a "CLng(E3TimeStamp*288)",
pois o campo E3TimeStamp é a data e hora do dado no formato gregoriano, de dias desde 1/1/1900, em que a
parte inteira é o número de dias e a parte fracionária as horas e os minutos. Multiplicando por 288 tem-se um
número inteiro correspondente ao total de cinco minutos desde 1/1/1900. A função CLng converte para um
número inteiro de 32 bits eliminando a parte fracionária, de modo que não apareçam os minutos e segundos
intermediários. O grupo criado é impresso cada vez que este número inteiro mudar, ou seja, a cada cinco
minutos. Verifique as propriedades NewColumn e NewPage, que devem estar configuradas com o valor 0 -
ddNPNone
· Detail: Contém os Campos de Dados para os campos da tabela. A propriedade Visible está em Falso, de modo
que cada uma das aquisições que compõem a média de cinco minutos são computadas, porém não impressas
· GroupFooter: Contém os campos a seguir, que representam as médias dos Campos de Dados:
· DataField: Nomes dos campos da tabela, tal como na Seção Detail
· SummaryFunc: 1 - ddSFAvg
· SummaryType: 1 - ddSGrandTotal
Relatórios 482
A única exceção é para o campo Data/Hora, que é um Campo de Dados padrão com a propriedade DataField igual
a "=CLng(E3TimeStamp*288)/288".
· ReportFooter: Em branco ou outro valor qualquer
Se a consulta for entre a zero hora de um dia e outro, o resultado é composto por 288 linhas impressas com a média
dos campos a cada cinco minutos.
483 Relatórios
CAPÍTULO
Segurança
28
Através desta opção, é possível controlar o acesso a Domínios, Elipse Power Viewers, Telas e Alarmes em uma lista
de usuários e grupos. Conforme a opção configurada, a aplicação permite ou não o acesso aos usuários cadastrados.
As permissões de acesso são configuradas por usuário ou por grupos de usuários. Os grupos podem ser criados
contendo apenas usuários ou também outros grupos. Para acessar as configurações de usuários, grupos ou
permissões, siga este procedimento:
1. Clique no menu Arquivo - Usuários para mostrar uma caixa de diálogo para configuração das permissões, dos
usuários e dos grupos na aplicação.
Janela Permissões de Usuário
28.1 Usuários
A aba Usuários permite configurar as informações referentes aos usuários que têm ou não acesso à aplicação. Para
utilizar este recurso, clique no menu Arquivo - Usuários e selecione a aba Usuários.
Segurança 484
Aba Usuários
Opções disponíveis na aba Usuários
OPÇÃO DESCRIÇÃO
Nome Indica o usuário corrente
Novo Cria um novo usuário
Editar Edita as propriedades do usuário selecionado
Remover Remove o usuário selecionado
Grupos disponíveis Mostra os grupos de usuários disponíveis na aplicação
Pertence a Mostra os grupos aos quais o usuário pertence
Adicionar Adiciona grupos da lista Grupos disponíveis para a lista

Pertence a
Remover Remove grupos da lista Pertence a
Ao clicar em Novo ou Editar, a caixa de diálogo da figura a seguir é mostrada.
485 Segurança
Janela Adicionar Usuário
NOTA
O valor Herdado nas opções disponíveis desta janela indica que o valor daquela opção é herdado do grupo ao qual
o usuário pertence ou do sistema.
Opções disponíveis na janela Adicionar Usuário

OPÇÃO DESCRIÇÃO
Nome Determina o nome deste usuário
Autenticação do Windows Esta opção permite adicionar um usuário existente no

domínio de rede do Windows. O nome deste usuário
deve estar no formato DOMÍNIO\USUÁRIO. Ao
selecionar esta opção, todas as demais opções da janela
são desabilitadas, exceto as opções Este usuário é um
administrador e Esta conta está desabilitada
Segurança 486
OPÇÃO DESCRIÇÃO
Autenticação do E3 Esta opção cria este usuário no Domínio corrente do
Elipse Power
Senha Determina a senha deste usuário. Veja a nota a seguir
Confirme a senha Confirmação da senha anteriormente informada. Veja a

nota a seguir
Nome completo Determina o nome completo deste usuário
Este usuário é um administrador Habilita este usuário como administrador
Não permitir mudança de senha Indica que este usuário não pode alterar a senha. Esta
alteração só pode ser executada por um administrador
Permitir mudar senha expirada Permite que este usuário troque imediatamente a senha
expirada
Expiração de senha Indica se a senha deste usuário tem ou não um prazo de

validade. Antes de terminar este prazo, uma caixa de
diálogo é mostrada indicando quantos dias restam para
expirar e oferecendo a possibilidade de trocar a senha.
Após este período, a senha expira e deve ser trocada.
Definir este valor como 0 (zero) permite que a senha
deste usuário expire ao final do dia atual. NOTA: Caso
esta opção esteja habilitada, configure no item Dias para
expiração o prazo para que a senha expire e, se o valor
configurado é igual a 0 (zero), recomenda-se desabilitar
a opção Duração mínima de senha
deste usuário seja usada antes que tenha que ser
trocada. O valor do item Duração mínima em dias deve
estar no intervalo entre 1 (um) e 730. Definir este valor
como 0 (zero) permite que este usuário altere a senha
imediatamente. NOTA: Caso a opção Expiração de
senha esteja configurada para um valor diferente de 0
(zero), o valor desta opção não pode exceder o valor
configurado no item Dias para expiração
Tamanho mínimo da senha Indica se a senha deve ter um tamanho mínimo de

caracteres. Caso esta opção esteja habilitada, configure
no item Mínimo de caracteres um valor mínimo de
caracteres para a senha
Senha alfanumérica Indica que a senha deste usuário deve conter letras e
números
Mínimo de caracteres numéricos na senha Indica se a senha deve ter um número mínimo de
caracteres numéricos. Caso esta opção esteja habilitada,
configure no item Mínimo de caracteres numéricos um
valor mínimo de caracteres numéricos para a senha
Mínimo de letras na senha Indica se a senha deve ter um número mínimo de letras.
Caso esta opção esteja habilitada, configure no item
Mínimo de letras um valor mínimo de letras para a
senha
Mínimo de caracteres especiais na senha Indica se a senha deve ter um número mínimo de
caracteres especiais. Caso esta opção esteja habilitada,
configure no item Mínimo de caracteres especiais um
valor mínimo de caracteres especiais para a senha
Caracteres maiúsculos e minúsculos Indica que a senha deste usuário deve conter caracteres
maiúsculos e minúsculos
Conta desabilitada Indica que a conta deste usuário está desabilitada
487 Segurança
OPÇÃO DESCRIÇÃO
Conta bloqueada Indica que a conta deste usuário está bloqueada. Esta
opção é habilitada automaticamente caso a senha expire
ou se este usuário digitar a senha errada várias vezes
Forçar troca de senha Indica que este usuário deve trocar a senha quando
executar o próximo login
Não diferenciar maiúsculas de minúsculas Indica que a validação da senha é realizada sem
diferenciar maiúsculas e minúsculas. Não é recomendado
habilitar esta opção
Histórico de senhas Indica se as últimas senhas deste usuário são

armazenadas e não podem ser utilizadas. Caso esta
NOTA
No caso da edição de um usuário existente, modificar o campo Senha implica em limpar o conteúdo do campo
Confirme a senha e vice-versa, mas apenas na primeira vez em que se edita qualquer um destes campos.
Ao efetuar o login do usuário, usando o método Login do Viewer ou pelo menu Arquivo - Login, abre-se a caixa de
diálogo da figura a seguir.
Janela de login
Ao selecionar o modo de autenticação Windows, os campos Nome do usuário e Senha são desabilitados e
preenchidos com o nome e a senha do usuário logado no domínio de rede. Para selecionar outro usuário pertencente
ao domínio de rede, clique em Outro usuário. Selecionando o modo de autenticação E3, preencha as informações de
usuário e senha de um usuário do Domínio do Elipse Power nos campos Nome do usuário e Senha,
respectivamente.
Quando a opção Este usuário é um administrador é habilitada para um usuário, este usuário pode, em tempo de
execução, alterar todas as configurações mostradas na aba Usuários.
Estes privilégios são acessados via script através do método UserAdministration do Viewer, que habilita a caixa de
diálogo dos usuários em tempo de execução.
NOTA
Apenas o administrador tem acesso ao método UserAdministration do Viewer.
Ao clicar em Remover, a aplicação mostra uma caixa de mensagem questionando se realmente deseja-se remover o
usuário.
Segurança 488
É possível que um usuário pertença a um grupo, podendo assim compartilhar as configurações deste grupo. Para
tanto, na lista Grupos disponíveis são mostrados os grupos disponíveis na aplicação que podem conter o usuário
selecionado, e na lista Pertence a, a lista dos grupos aos quais o usuário selecionado já pertence. Para adicionar um
usuário a um grupo, siga estes procedimentos:
1. Selecione o usuário que deseja inserir no grupo específico.
2. Na lista Grupos disponíveis, selecione o grupo ao qual o usuário deve pertencer.
3. Clique em Adicionar para adicionar o grupo, que aparece na lista Pertence a.
4. Para remover um grupo, selecione-o na lista Pertence a e clique em Remover.
28.2 Grupos
A aba Grupos permite que sejam configuradas as informações referentes aos grupos. Cada grupo define
características que são comuns para todos os membros. Um grupo também pode pertencer a outros grupos. Só não
é permitido pertencer a outro grupo que já pertença a este, ou seja, criar uma referência circular.
Para utilizar este recurso, clique no menu Arquivo - Usuários e selecione a aba Grupos.
Aba Grupos
Opções disponíveis na aba Grupos
OPÇÃO DESCRIÇÃO
Nome Indica o grupo corrente
Novo Cria um novo grupo
Editar Edita as propriedades do grupo selecionado
Remover Remove o grupo selecionado
Grupos disponíveis Mostra os grupos disponíveis na aplicação
Pertence a Mostra os grupos aos quais o grupo selecionado

pertence
489 Segurança
OPÇÃO DESCRIÇÃO
Adicionar Adiciona grupos da lista Grupos disponíveis na lista
Pertence a
Remover Remove grupos da lista Pertence a
Ao clicar em Novo, a janela da figura a seguir é mostrada, permitindo selecionar o tipo de grupo a ser criado.
Janela Tipo do Grupo

A opção Grupo do Windows permite selecionar um grupo de usuários já existentes em um domínio do Windows, de
forma que os usuários já cadastrados possam logar em uma aplicação. A janela da figura a seguir é aberta.
Janela Editar Grupo do Windows

Opções disponíveis na janela Editar Grupo do Windows
OPÇÃO DESCRIÇÃO
Nome do grupo Digite o nome do grupo do domínio do Windows, no
formato DOMÍNIO\GRUPO
Procurar Abre a janela Procurar Grupos do Windows, descrita a

seguir
Segurança 490
OPÇÃO DESCRIÇÃO
Membros não cadastrados no Elipse Power Lista com todos os usuários do grupo do domínio do
Windows ainda não cadastrados no Elipse Power
Membros cadastrados no Elipse Power Lista com todos os usuários do grupo do domínio do
Windows já cadastrados no Elipse Power
Cadastrar Move o usuário selecionado na lista Membros não

cadastrados no Elipse Power para a lista Membros
cadastrados no Elipse Power
Atualizar Força a atualização das informações sobre os usuários

do grupo do Windows indicado na opção Nome do
grupo e preenche as listas Membros não cadastrados
no Elipse Power e Membros cadastrados no Elipse
Power com os respectivos usuários do grupo
Remover Move o usuário selecionado na lista Membros

cadastrados no Elipse Power para a lista Membros não
cadastrados no Elipse Power
Ao clicar em Procurar, a janela da figura a seguir é aberta.
Janela Procurar Grupos do Windows

Nesta janela, digite o nome do domínio do Windows no campo Nome do domínio e clique em Procurar para
executar a busca. Na lista de grupos encontrados no domínio, selecione o grupo desejado e clique em OK para
adicionar este grupo na opção Nome do grupo da janela Editar Grupo do Windows.
A opção Grupo do Elipse Power abre a janela da figura a seguir.
491 Segurança
Janela Adicionar Grupo
NOTA
O valor Herdado nas opções disponíveis desta janela indica que o valor daquela opção é herdado do grupo ao qual
o grupo pertence ou do sistema.
Opções disponíveis na janela Adicionar Grupo

OPÇÃO DESCRIÇÃO
Nome do grupo Determina o nome deste grupo
Não permitir mudança de senha Indica que um usuário deste grupo não pode alterar a
senha. Esta alteração só pode ser executada por um
administrador
Permitir mudar senha expirada Permite que um usuário deste grupo troque
imediatamente a senha expirada
Expiração de senha Indica se a senha de um usuário deste grupo tem ou não

um prazo de validade. Antes de terminar este prazo, uma
caixa de diálogo é mostrada indicando quantos dias
restam para expirar e oferecendo a possibilidade de
trocar a senha. Após este período, a senha expira e deve
ser trocada. Definir este valor como 0 (zero) permite que
a senha deste usuário expire ao final do dia atual. NOTA:
Caso esta opção esteja habilitada, configure no item Dias
para expiração o prazo para que a senha expire e, se o
valor configurado é igual a 0 (zero), recomenda-se
desabilitar a opção Duração mínima de senha
Segurança 492
OPÇÃO DESCRIÇÃO
de um usuário deste grupo seja usada antes que tenha
que ser trocada. O valor do item Duração mínima em
dias deve estar no intervalo entre 1 (um) e 730. Definir
este valor como 0 (zero) permite que um usuário deste
grupo altere a senha imediatamente. NOTA: Caso a
opção Expiração de senha esteja configurada, o valor
desta opção não pode exceder o valor configurado no
item Dias para expiração
Tamanho mínimo da senha Indica se a senha de um usuário deste grupo deve ter um
tamanho mínimo de caracteres. Caso esta opção esteja
habilitada, configure no item Mínimo de caracteres um
valor mínimo de caracteres para a senha
Senha alfanumérica Indica que a senha de um usuário deste grupo deve

conter letras e números
Mínimo de caracteres alfanuméricos na senha Indica se a senha de um usuário deste grupo deve ter um
número mínimo de caracteres numéricos. Caso esta
opção esteja habilitada, configure no item Mínimo de
caracteres numéricos um valor mínimo de caracteres
numéricos para a senha
Mínimo de letras na senha Indica se a senha de um usuário deste grupo deve ter um
número mínimo de letras. Caso esta opção esteja
habilitada, configure no item Mínimo de letras um valor
mínimo de letras para a senha
Mínimo de caracteres especiais na senha Indica se a senha de um usuário deste grupo deve ter um
número mínimo de caracteres especiais. Caso esta opção
esteja habilitada, configure no item Mínimo de
caracteres especiais um valor mínimo de caracteres
especiais para a senha
Caracteres maiúsculos e minúsculos Indica que a senha de um usuário deste grupo deve
conter caracteres maiúsculos e minúsculos
Não diferenciar maiúsculas de minúsculas Indica que a validação da senha de um usuário deste
grupo é realizada sem diferenciar maiúsculas e
minúsculas. Não é recomendado habilitar esta opção
Histórico de senhas Indica se as últimas senhas de um usuário deste grupo

são armazenadas e não podem ser utilizadas. Caso esta
Ao clicar em Remover, a aplicação mostra uma caixa de mensagem perguntando se realmente deseja-se excluir o
grupo selecionado.
É possível que um grupo de usuários pertença a outro, podendo assim compartilhar as configurações. Para tanto, na
lista Grupos disponíveis são mostrados os grupos disponíveis na aplicação que podem conter o grupo selecionado,
e no item Pertence a, a lista dos grupos aos quais o grupo selecionado pertence. Para adicionar um grupo a outro
específico, siga estes procedimentos:
1. Selecione o grupo que deseja inserir em um grupo específico.
2. Na lista Grupos disponíveis, selecione o grupo ao qual o grupo deve pertencer.
3. Clique em Adicionar para adicionar o grupo, que aparece na lista Pertence a.
4. Para remover um grupo, selecione-o na lista Pertence a e clique em Remover.
493 Segurança
NOTA
É importante verificar a hierarquia entre usuários e grupos. Se o usuário tem uma opção desabilitada, mas esta
mesma opção está habilitada no grupo, vale a opção do usuário, que possui este item desabilitado. A opção do
grupo só é respeitada se a mesma opção do usuário estiver marcada como neutra ou herdada.
28.3 Permissões
A aba Permissões permite configurar as permissões dos usuários e grupos para Domínios, Elipse Power Viewers,
Telas e Alarmes. Uma verificação de permissão consiste em uma informação que um membro de um grupo tem sobre
um comando que atua sobre um objeto específico.
Aba Permissões
Opções disponíveis na aba Permissões
OPÇÃO DESCRIÇÃO
Usuários/Grupos Esta opção lista os usuários ou grupos de usuários
configurados na aplicação
Segurança 494
OPÇÃO DESCRIÇÃO
Itens para segurança Os itens para segurança disponíveis são Telas: Permite
ao usuário habilitar ou desabilitar o acesso às Telas. Em
uma aplicação, todos os usuários ou grupos têm acesso
à Tela de abertura, Alarmes: Habilita ou desabilita o
reconhecimento de alarmes e a remoção de alarmes
desvinculados para o usuário ou grupo. Em um projeto,
é possível exibir as informações de alarmes para vários
assinantes das informações através de um objeto de
visualização em Tela, como por exemplo o E3Alarm,
Domínios: Permite configurar permissões para executar,
parar ou editar um Domínio e ter acesso remoto a um
Domínio, entre outras permissões e Viewer: Permite ao
usuário utilizar o Elipse Power Viewer em modo Viewer
Control ou Viewer Only, de acordo com as
configurações
Usuários É um filtro das opções de configuração. Habilitando esta

opção, é possível visualizar somente os usuários
cadastrados na aplicação
Grupos É um filtro das opções de configuração. Habilitando esta

opção, é possível visualizar somente os grupos
cadastrados na aplicação
Permissões Mostra as permissões dos usuários ou grupos quanto

aos itens de segurança (Domínios, Elipse Power Viewers,
Telas e Alarmes)
Desabilitar a verificação de permissões Desabilita qualquer verificação de permissões. Veja a

nota a seguir sobre o comportamento desta opção
NOTA
A opção Desabilitar a verificação de permissões deve ser utilizada com cuidado, pois implica nos seguintes
comportamentos:
· O login sempre funciona, mesmo que a senha esteja errada ou que seja utilizado um nome de usuário inexistente
· As ações sempre são permitidas, mesmo para usuários anônimos
Para cada item de segurança existe uma série de permissões que podem ser configuradas para cada usuário ou
grupo. As opções disponíveis estão descritas nas tabelas a seguir.
Opções disponíveis para Telas
OPÇÃO DESCRIÇÃO
Abrir Tela Habilita a abertura de Telas
Opções disponíveis para Alarmes

OPÇÃO DESCRIÇÃO
Reconhecer alarmes Habilita o reconhecimento de alarmes
Remover alarmes desvinculados Habilita a remoção de alarmes não vinculados à Fontes

de Alarme
Arquivar/Desarquivar alarmes Habilita o arquivamento e o desarquivamento de alarmes
Opções disponíveis para Domínios

OPÇÃO DESCRIÇÃO
Executar Domínio Habilita a execução de um Domínio
Parar Domínio Para um Domínio
495 Segurança
OPÇÃO DESCRIÇÃO
Editar Domínio Habilita a edição de um Domínio
Executar como serviço Habilita a execução de um Domínio como um serviço
Configurar usuários/grupos Permite configurar usuários e grupos de usuários
Acesso remoto ao Domínio Habilita o acesso remoto a um Domínio
Acesso remoto de escrita ao Domínio Habilita o acesso remoto de escrita a um Domínio
Escrever pelo Studio em propriedades em tempo de Habilita a escrita na coluna de valores das propriedades
execução no WatchWindow em tempo de execução
NOTA
A partir da versão 6.0, aplicações criadas em versões anteriores são abertas no Elipse Power Studio com a
permissão Escrever pelo Studio em propriedades em tempo de execução desabilitada por padrão.
Opções disponíveis para Elipse Power Viewers

OPÇÃO DESCRIÇÃO
Acesso de escrita ao servidor Habilita o acesso de escrita ao servidor
Cada item da lista de permissões pode estar configurado com um dos estados da tabela a seguir.
Opções da lista de permissões
ESTADO DESCRIÇÃO
Permitido O comando selecionado na lista de permissões é
permitido para o usuário ou grupo selecionado,
independente dos grupos aos quais pertence
Não Permitido O comando selecionado na lista de permissões não é

permitido para o usuário ou grupo selecionado,
independente dos grupos aos quais pertence
Permitido pelo Grupo O comando selecionado na lista de permissões é

permitido para o usuário ou grupo selecionado, se é
permitido nos grupos aos quais o usuário ou grupo
pertence
Não Permitido pelo Grupo O comando selecionado na lista de permissões não é

permitido para o usuário ou grupo selecionado, se não
é permitido em pelo menos um dos grupos aos quais o
usuário ou grupo pertence
Não Informado O usuário ou grupo selecionado utiliza as definições dos

grupos aos quais pertence e não há nada informado
nos grupos, portanto o comando é permitido
NOTA
Para configurar os estados possíveis para cada item de segurança na lista de permissões, pode-se utilizar as
seguintes opções:
· Clique com o botão direito do mouse no item ou use o atalho de teclado SHIFT + F10, que corresponde à tecla de
aplicação ou de menu , para selecionar uma das opções, Permitir comando, Não permitir comando ou Usar a
informação do grupo.
· Clique duas vezes no item ou utilize a barra de espaço do teclado para alternar entre os estados Permitido, Não
permitido ou Não informado.
No caso de Telas, é possível que a configuração de permissão seja realizada por Tela especificamente. No caso de
Alarmes, esta configuração pode ser realizada por Área.
Segurança 496
NOTA
Em uma aplicação, todos os usuários têm acesso à Tela de abertura. Caso deseje que a aplicação sempre inicie com
a tela de login do usuário, crie um usuário sem permissão específica na Tela inicial. Assim, toda vez que a aplicação é
iniciada, pede-se o login do usuário e após, mostra-se a Tela de abertura.
Com relação a permissões para um usuário anônimo, devem ser observadas as seguintes situações:
· Se não há usuário criado, a verificação de permissões não está habilitada ou não há usuário com restrição para
uma determinada operação, então não é exigida identificação, ou seja, o usuário é logado como anônimo
· Se há usuário criado, a verificação está habilitada e há pelo menos um usuário que não possa executar
determinada operação, então para esta operação é exigida identificação, ou seja, não é permitido o acesso como
usuário anônimo
NOTA
A nomenclatura e descrição das opções de restrição podem ser acessadas através da opção Legenda.
Caso haja alguma restrição para executar, parar, editar um Domínio ou configurar usuários ou grupos, é necessário
que um usuário esteja logado no Elipse Power. Para tanto, utilizam-se as opções Login ou Logout, disponíveis no
menu Arquivo.
Login ou Logout do usuário

A opção Login abre uma caixa de diálogo para o login no Elipse Power Studio. O usuário permanece logado até que
seja realizado outro login ou logout.
A opção Logout executa o logout no Elipse Power Studio. Caso não haja um usuário logado, esta opção está
desabilitada.
28.4 Proteção de Arquivos

Protege o conteúdo de um arquivo de projeto ou de biblioteca contra a edição, visualização ou execução não
autorizada. Para utilizar este recurso, siga estes procedimentos:
1. Clique com o botão direito do mouse no nome do projeto ou da biblioteca no modo Explorer e selecione a
opção Proteção. No modo Domínio, clique com o botão direito do mouse no nome do projeto ou da biblioteca,
no item Configuração - Arquivos, e selecione a opção Proteção.
2. A caixa de diálogo da figura a seguir é mostrada.
497 Segurança
Proteção de arquivos
Esta janela possui dois tipos de proteção, Proteção de Edição e Proteção de Execução.
A Proteção de Edição protege um arquivo contra alterações e visualizações não autorizadas. Este recurso é utilizado
para evitar que determinada biblioteca ou projeto seja alterado acidentalmente, ou que sejam copiados
procedimentos de conhecimento específico do desenvolvedor. A opção Adicionar proteção permite configurar uma
senha de proteção para a aplicação, conforme a figura a seguir.
Adicionar proteção
A opção Alterar senha altera a senha de proteção do Elipse Power Studio para um arquivo, conforme a figura a
seguir.
Segurança 498
Alteração de senha de proteção
A opção Remover proteção remove a proteção de edição de um arquivo. Para isto, clique nesta opção, digite a senha
e clique em OK para que a aplicação abra uma caixa de mensagem informando se a ação foi executada corretamente.
A Proteção de Execução é utilizada para proteger um arquivo contra execução não autorizada. Para isto, é necessário
solicitar a gravação de uma senha no dispositivo de proteção, que é realizada pela Elipse Software. Isto protege o
desenvolvedor de cópias não autorizadas do projeto, por exemplo. Para isto, no momento do pedido de licença do
E3 Server, é necessário fornecer a senha de execução. Este processo é realizado posteriormente à compra do
servidor.
A opção Adicionar proteção permite configurar uma senha de proteção para a aplicação, conforme a figura a seguir.
Adicionar proteção
A opção Alterar senha altera a senha de proteção de execução para um arquivo, conforme a figura a seguir.
Alteração de senha de proteção

A opção Remover proteção permite remover a proteção de execução de um arquivo. Para isto, clique na opção,
digite a senha e clique em OK para que a aplicação abra uma caixa de mensagem informando se a ação foi executada
corretamente.
Quando um arquivo de projeto ou de biblioteca é aberto no Elipse Power Studio, este inicializa mostrando um ícone
cinza , com um cadeado indicando que está protegido e seu conteúdo não pode ser acessado. Para acessar o
conteúdo do arquivo, clique com o botão direito do mouse no projeto ou na biblioteca e selecione a opção Abrir
com senha. Após informar a senha e a aplicação liberar o acesso, o ícone muda para colorido , indicando a
acessibilidade dos arquivos.
499 Segurança
O conteúdo de arquivos de projeto ou de biblioteca protegidos é criptografado. Quando um projeto é protegido, as
propriedades DocString e Domain são bloqueadas.
IMPORTANTE
As proteções implementadas não podem ser desfeitas caso as senhas sejam perdidas. Portanto, ao proteger um
arquivo, mantenha as senhas armazenadas em local seguro. Isto garante que seja possível usar este arquivo sempre
que necessário.
Segurança 500
CAPÍTULO
Elipse Power Viewer e WebViewer
29
O Elipse Power Viewer é o ambiente de visualização do Elipse Power. Nele, é possível visualizar a execução da
aplicação criada no Elipse Power Studio.
O WebViewer é um componente ActiveX que faz o Internet Explorer comportar-se como um Elipse Power Viewer, o
que permite a visualização e controle de aplicações Elipse Power via Internet. Desta forma, é possível visualizar e
interagir com um processo de chão de fábrica através do Internet Explorer, que pode estar em qualquer computador
da rede que tenha acesso ao E3 Server.
Depois de instalado, o WebViewer vai funcionar exatamente como o Elipse Power Viewer, executando o download da
aplicação (Telas, bitmaps, etc.) para a máquina local. Todas as funcionalidades do Elipse Power Viewer (E3Chart,
E3Alarm, etc.) são suportadas pelo WebViewer.
WebViewer em execução (visualização de uma aplicação)

NOTA
Tanto o Elipse Power Viewer quanto o WebViewer aceitam as mesmas opções de zoom descritas no tópico Zoom
do capítulo Telas e Objetos de Tela. Além disto, a qualidade gráfica das Telas pode ser modificada, em tempo de
execução, utilizando-se o menu contextual tanto do Elipse Power Viewer quanto do WebViewer e selecionando uma
das opções do menu Qualidade (todas as telas). Para mais informações, consulte a propriedade RenderQuality do
Viewer no Manual de Referência e Scripts do Elipse Power.
29.1 Viewer Only (Modo Somente Leitura)

O modo Viewer Only (modo Somente Leitura, ou de acesso restrito) é uma maneira de controlar o acesso que o
Elipse Power Viewer tem ao servidor (Domínio), em oposição ao modo Viewer Control, que não possui restrições de
acesso.
Através da configuração da permissão de usuários (capítulo sobre Segurança), e de acordo com o tipo de licença de
Elipse Power Viewer em uso (capítulo sobre Domínios), o servidor determina se o Elipse Power Viewer está no
modo Control (normal) ou Only (restrito). Quando está no modo Only, são aplicadas diversas restrições quanto às
ações que podem ser escritas no servidor. Neste modo estão bloqueados (seja por erro de script ou por gerar
mensagem de erro):
· Escritas em geral em propriedades de objetos do servidor através do Elipse Power Viewer por Associações
· Escritas em geral em propriedades de objetos do servidor através de scripts do Elipse Power Viewer
· Métodos SetValue e ToggleValue do Viewer (incluindo-se aí os Picks Carregar e Inverter Valor)
501 Elipse Power Viewer e WebViewer

· Chamadas de métodos de objetos do servidor através de scripts do Elipse Power Viewer (exceções a seguir)
· Administração de usuários através do Elipse Power Viewer (uso do método UserAdministration do Viewer)
· Reconhecimento de alarmes pelo E3Alarm
· Uso dos métodos LoadFormulaDlg, LoadFormulaValues e LoadFormulaValuesQuiet do Viewer
Permanecem permitidos neste modo:

· Leituras de propriedades de objetos do servidor, tanto por Associações como por scripts
· Chamadas de métodos considerados não restritos de objetos do servidor em scripts do Viewer:
· Item (todos os objetos)
· Refresh (Grupo OPC)
· FindUnit, FindValue, GetValueData e GetUnitData (Fórmula)
· GetAlarm (Fonte de Alarmes)
· GetE3QueryFields, GetADORecordset e GetAsyncADORecordSet (Consulta)
· GetObject (Servidor de Aplicações)
· Mudanças do estado de Advise de Tags do servidor
· Mudança da própria senha (método ChangePassword do Viewer)
29.1.1 Mudanças no Modo do Elipse Power Viewer

Para que o usuário acesse o Elipse Power no modo Somente Leitura, pelo menos uma destas condições deve ser
verdadeira:
· Licença em uso do tipo Viewer Only
· Usuário logado sem permissão para o item Acesso de escrita ao servidor
É importante lembrar que, no caso de não haver usuário logado no Elipse Power Viewer (usuário anônimo), é
aplicada a restrição de acesso, desde que pelo menos um ou mais usuários tenham esta restrição.
Desta forma, cada vez que ocorre uma mudança de usuário o modo de acesso do Elipse Power Viewer pode ser
mudado (e consequentemente a propriedade IsReadOnly), de acordo com a combinação do que é permitido pela
licença em uso e a permissão do usuário logado.
A mudança do modo de acesso também pode acontecer caso ocorra a reconexão do Elipse Power Viewer, já que
esta pode provocar tanto a mudança de licença (de Viewer Control para Viewer Only, ou vice-versa) quanto a
mudança das permissões do usuário logado.
Caso haja algum usuário com acesso de escrita ao servidor bloqueado no momento da abertura do Elipse Power
Viewer, este entra automaticamente no modo Somente Leitura, independente da licença em uso, já que o usuário
anônimo sempre assume a restrição máxima configurada.
29.2 Execução do Elipse Power Viewer

A forma de se executar o Elipse Power Viewer é através de um servidor local, de um servidor na intranet ou de um
servidor na Internet. Os tópicos a seguir detalham estas formas.
29.2.1 Através do Elipse Power

O Elipse Power Viewer pode ser executado através da barra de ferramentas Padrão, utilizando as seguintes opções:
· Executar Aplicativo : Salva todas as configurações do projeto, executa o Domínio e o Elipse Power Viewer
· Rodar ou Parar Domínio : Executa ou para a execução do Domínio
· Executar ou Parar Elipse Power Viewer : Executa o Elipse Power Viewer ou para a sua execução caso já esteja
aberto
Quando o Elipse Power Viewer é executado, a aplicação mostra a janela a seguir, indicando o estado da conexão.
Elipse Power Viewer e WebViewer 502

Mensagem de estado de conexão
Quando a conexão com o servidor é perdida, o Elipse Power tenta restabelecê-la automaticamente, respeitando as
configurações do servidor. Para determinar qual servidor estabelece a conexão caso o Elipse Power Viewer falhe, é
necessário configurar a opção Servidores através do E3 Admin, conforme explicado no capítulo Domínios.
29.2.2 Através da Linha de Comando

O Elipse Power Viewer pode ser acessado via linha de comando da seguinte maneira:
Viewer [nome_do_servidor] [opções]
O argumento nome_do_servidor representa o nome da máquina onde o E3 Server está executando. Se este
argumento não é informado, uma caixa de diálogo é mostrada perguntando o caminho do servidor da aplicação,
como ocorre quando o Elipse Power Viewer é executado a partir do menu Iniciar (como mostrado no próximo
tópico).
As opções de configuração para a linha de comando são as seguintes:
· -screen ou /screen: Permite ao usuário informar uma Tela inicial válida, diferente da Tela inicial configurada no
Domínio
Viewer [nome_do_servidor] –screen <nome_da_tela>
· -noping ou /noping: Descarta a necessidade de se executar um comando ping para o servidor antes da
tentativa de conexão (tentativa de conexão direta)
Viewer [nome_do_servidor] –noping
· -readonly ou /readonly: Permite ao usuário especificar que o Elipse Power Viewer deve tentar conectar apenas
no modo Somente Leitura. Quando isto é realizado, o Elipse Power Viewer sempre utiliza uma licença do tipo
Viewer Only
Viewer [nome_do_servidor] –readonly
· -cachepath ou /cachepath: Permite especificar um diretório para a gravação do cache do Elipse Power Viewer.
Se não é especificado, é usado o diretório temporário do sistema (variável de ambiente TEMP)
Viewer [nome_do_servidor] –cachepath <diretorio>
· -useservers ou /useservers: Esta opção permite que o Elipse Power Viewer tente se conectar somente aos
servidores especificados na linha de comando. Se a opção não estiver presente (comportamento padrão), o
Elipse Power Viewer pode tentar descobrir servidores alternativos caso não consiga se conectar aos servidores
passados na linha de comando. Esta opção funciona apenas em rede local, portanto deve ser informada caso o
servidor que o Elipse Power Viewer deve acessar esteja fora da rede local
Viewer [nome_do_servidor] –useservers
· -params: Permite que o usuário especifique parâmetros de inicialização do Elipse Power Viewer. Esta opção não
pode vir imediatamente antes da lista de servidores. Os valores passados nesta opção podem ser recuperados
via script utilizando a propriedade Params do Viewer. Para mais informações sobre a utilização desta
propriedade, consulte o capítulo Viewer no Manual de Referência e Scripts do Elipse Power
Viewer -params <Nome1>=<Valor1> [<Nome2>=<Valor2>] ...
· -help: Mostra uma caixa de diálogo com exemplos de uso das opções de linha de comando do Elipse Power
Viewer, como na figura a seguir

Caixa de diálogo de ajuda do Elipse Power Viewer
29.2.3 Através do Menu Iniciar

Para executar uma aplicação cliente, pode-se utilizar o Elipse Power Viewer, disponível no menu Iniciar (Start) -
Programas (Programs) - Elipse Power - Elipse Power Viewer.
O Elipse Power então mostra a seguinte caixa de diálogo para que o caminho do servidor da aplicação seja
informado.

Janela Iniciando o Elipse Power Viewer
Se o E3 Server estiver na mesma máquina do Elipse Power Viewer, selecione a opção Servidor Local. Caso estejam
em máquinas diferentes, selecione a opção Servidor na rede e informe o nome ou o endereço IP da máquina com o
E3 Server. Se o E3 Server estiver disponível em uma porta diferente do padrão (6515), informe o número desta porta
no campo Servidor na rede após o endereço IP, separado por dois pontos. Para se conectar no modo Somente
Leitura, selecione a opção Iniciar o Viewer no modo apenas de leitura.
29.3 Logs do Elipse Power Viewer

O Elipse Power gera logs no formato ETL (Event Trace Log). Estes arquivos de log são gerenciados por uma
ferramenta da Elipse Software chamada Elipse Event Log Viewer, disponível com a instalação do Elipse Power. Com
esta ferramenta é possível visualizar os arquivos e gerenciar o espaço que estes ocupam em disco, entre outras
configurações. Para mais informações sobre a ferramenta Elipse Event Log Viewer, consulte o Manual do Usuário
do Elipse Event Log, disponível no menu Iniciar - Programas - Elipse Software - Elipse Event Log. O Elipse Event
Log Viewer pode ser aberto das seguintes formas:
· Pelo menu Iniciar - Programas - Elipse Software - Elipse Event Log - Log Viewer
· Pelo menu Ferramentas - Log Viewer do Elipse Power Studio
· Pelo item Atalhos - Log Viewer do menu do E3 Admin na Área de Notificação do Windows
29.4 Execução do WebViewer

Durante a instalação do WebViewer, os arquivos e3web.asp, e3web2.asp, docwrite.asp, docwrite2.asp e
e3downloader.cab ficam disponíveis para configuração pelo usuário. Estes arquivos estão localizados no diretório de
instalação do Elipse Power, na pasta web.
· e3web.asp e docwrite.asp: Têm a função de carregar e iniciar o ActiveX E3Downloader
· e3downloader.cab: ActiveX que é enviado para a máquina cliente e executa a instalação do e3webviewer-x86-
ptb.exe
· e3web2.asp e docwrite2.asp: Têm a função de carregar e iniciar o ActiveX do WebViewer que mostra a
aplicação em execução na máquina do Internet Explorer
A página docwrite2.asp vem configurada considerando-se que o E3 Server está executando no mesmo computador
que o servidor web. Porém, é possível alterar o código fonte desta página para atender à configuração desejada. Para
isto, altere a linha a seguir no arquivo docwrite2.asp:
var Domain = getDomain();
Para o seguinte código:

var Domain = "IP externo do servidor IIS";
Caso se queira permitir ao usuário informar uma Tela inicial válida, diferente da configurada no Domínio, deve-se
alterar o parâmetro Screen no arquivo docwrite2.asp, colocando em Nome_da_Tela um nome de Tela válido na
aplicação. Exemplo:
<param name="Screen" value="Nome_da_tela">

Caso se queira informar a necessidade de se executar o comando ping para o servidor antes de tentar a conexão,
deve-se alterar o parâmetro Ping no arquivo docwrite2.asp. O valor pode ser "True" ou "False". Exemplo:
<param name="Ping" value="True">
Se esta linha é omitida, o comando ping é executado.

Para especificar um diretório para a gravação do cache do Elipse Power Viewer, deve-se alterar o parâmetro
CachePath no arquivo docwrite2.asp. Se não é especificado, é usado o diretório temporário do sistema (variável de
ambiente TEMP). Exemplo:
<param name="CachePath" value="diretorio_para_cache">
Caso seja preciso que o WebViewer procure por outros servidores na rede se não conseguir conectar ao servidor
especificado no parâmetro Domain, deve-se alterar o parâmetro UseServers no arquivo docwrite2.asp. Se o parâmetro
não é informado, o WebViewer tenta se conectar apenas ao servidor especificado no parâmetro Domain, que é o
comportamento padrão do WebViewer (valor "True"). A alteração do valor para "False" só funciona para servidores e
WebViewers que estejam na mesma rede. Exemplo:
<param name="UseServers" value="False">
A configuração do WebViewer para abrir no modo Somente Leitura é realizada através do parâmetro StartReadOnly,
com os valores "True" ou "False", no arquivo docwrite2.asp. Se este item não existir, o valor assumido é
"False" (comportamento compatível com versões anteriores). Exemplo:
<param name="StartReadOnly" value="False">
Em ambos os casos, esta configuração só tem efeito na abertura do WebViewer. Se o parâmetro é mudado durante
a execução, a conexão ou reconexão do WebViewer não é afetada.
Para se navegar para uma página diferente do padrão após o carregamento do WebViewer, deve-se modificar o
atributo value do parâmetro URLToLoad do arquivo docwrite.asp para o endereço desejado. Exemplo:
<param name="URLToLoad" value="URL">
Se esta linha é omitida, a página e3web2.asp é carregada.

Para especificar se o instalador do WebViewer deve ou não instalar o ActiveX Control Pad (MS Forms), deve-se
modificar o parâmetro InstallACP do arquivo docwrite.asp com os valores "True" ou "False", respectivamente. Se este
item não existir, o valor assumido é "True" (o ActiveX Control Pad é instalado). Exemplo:
<param name="InstallACP" value="True">
NOTA
Caso o parâmetro InstallACP esteja configurado com o valor "False", as Telas da aplicação que utilizem MS Forms
podem apresentar erros durante o carregamento, se os objetos MS Forms não tenham sido previamente instalados
por outros aplicativos, como por exemplo o Microsoft Office.
Os servidores e o WebViewer podem tanto executar na mesma máquina quanto em máquinas diferentes. Os tópicos
a seguir mostram como estas situações se aplicam.
29.4.1 Internet Information Services

Tanto para a visualização na Internet como para visualização em Intranet ou máquina local, é necessária a instalação e
configuração do IIS (Internet Information Services), ou outro servidor de Internet.
O IIS é fornecido juntamente com o Windows. Para instalá-lo e configurá-lo, siga estes procedimentos:
1. Abra o menu Iniciar - Painel de Controle (Start - Control Panel) no Windows 7 SP1, ou abra o item Aplicativos -
Sistema do Windows - Painel de Controle (Apps - Windows System - Control Panel) na tela Inicial do Windows 8 e
Windows 8.1. No Windows 10, clique com o botão direito do mouse no menu Iniciar (Start) e selecione o item
Painel de Controle (Control Panel).
2. Clique em Programas e Recursos (Programs and Features).
3. Clique em Ativar ou desativar recursos do Windows (Turn Windows features on or off).

Serviços de Informações da Internet
4. Localize na lista o item Serviços de Informações da Internet (Internet Information Services) e clique em para
expandir todos os seus subitens.
5. Selecione, no mínimo, as opções a seguir e clique em OK.
· Ferramentas de Gerenciamento da Web (Web Management Tools)
· Console de Gerenciamento do IIS (IIS Management Console)
· Scripts e Ferramentas de Gerenciamento do IIS (IIS Management Scripts and Tools)
· Serviço de Gerenciamento do IIS (IIS Management Service)
· Serviços da World Wide Web (World Wide Web Services)
· Recursos de Desenvolvimento de Aplicativos (Application Development Features)
· ASP
· Extensões ISAPI (ISAPI Extensions)
· Filtros ISAPI (ISAPI Filters)
· Recursos Http Comuns (Common Http Features)
· Conteúdo Estático (Static Content)
· Documento Padrão (Default Document)
· Redirecionamento de HTTP (HTTP Redirection)
· Segurança (Security)
· Autenticação Básica (Basic Authentication)
· Filtragem de Solicitações (Request Filtering)
6. O IIS inicia a instalação.

7. Aguarde a finalização do processo para configurar o IIS.
Após a instalação do IIS, os arquivos e3web.asp, e3web2.asp, docwrite.asp, docwrite2.asp e e3downloader.cab devem
ser copiados para c:\inetpub\wwwroot. Esta pasta é criada na instalação do IIS. Além dos arquivos .asp, o instalador
do WebViewer também deve ser copiado para esta mesma pasta. Este instalador (e3webviewer-x86-ptb.exe) é
utilizado quando a máquina cliente acessar o servidor pela primeira vez, caso o Elipse Power não tenha sido
previamente instalado nesta máquina. Este arquivo pode ser obtido através de download no site da Elipse Software.
O IIS ainda necessita ser configurado para seu correto funcionamento. A configuração é diferente caso o IIS e o E3
Server estejam na mesma máquina ou em máquinas diferentes. Para configurá-lo, consulte o Guia de Instalação do
Elipse Power, no tópico Instalação do WebViewer.

29.4.2 Visualização na Aplicação Cliente
Se o servidor estiver utilizando o servidor web, por exemplo o IIS, digite na barra de endereços do Internet Explorer o
endereço ou IP do servidor (por exemplo, http://nomedoservidor/diretorio_virtual ou http://192.0.0.21/diretorio_virtual),
onde diretorio_virtual é o diretório criado na configuração do IIS, conforme o Guia de Instalação do Elipse Power.
No primeiro acesso ao servidor, o Internet Explorer inicia a instalação dos componentes, caso estes não tenham sido
previamente instalados, conforme explicado no começo deste capítulo. O componente é assinado pela Elipse
Software e o usuário deve aceitar a instalação para que se iniciem as configurações necessárias.
Instalação do WebViewer
Após a instalação, o WebViewer está aberto no browser, e visualizando a aplicação do servidor. Nos próximos
acessos não é mais necessário instalar os componentes e o tempo de conexão é mais rápido.
NOTA
A versão do cliente tem que ser a mesma do servidor. Para isto, o instalador (e3webviewer-x86-ptb.exe) no servidor
deve ser sempre o mais atual.

CAPÍTULO
Hot-Standby
30
O Hot-Standby permite a implementação do conceito de fail-over em um sistema supervisório. Este conceito consiste
na possibilidade de se ter dois servidores (principal e backup) atuando um como contingência do outro, ou seja, se o
servidor principal falhar, um servidor de backup entra em ação imediatamente, sem perda da continuidade do
processo. Este servidor em espera diz-se que está em Standby.
Assim, a ferramenta de Hot-Standby do Elipse Power tem como objetivo permitir que um servidor permaneça em
estado de espera (Standby), aguardando uma possível falha de um outro servidor (servidor ativo). A troca de servidor
ativo pode ser manual ou automática.
A troca manual é acionada através do menu do E3 Admin na Área de Notificações do Windows do computador em
Standby (opção Servidor - Ativar). A troca automática ocorre quando o servidor em Standby detecta que o servidor
principal não está mais executando. Um servidor pode assumir um dos seguintes estados:
· Servidor em Manutenção: Este estado é indicado na configuração do servidor do Domínio. Um servidor em
manutenção não toma parte em nenhum evento do Domínio
· Servidor Ativo: Apenas um servidor pode estar ativo em um Domínio em um determinado momento. O servidor
ativo é aquele que está executando o aplicativo (E3Run)
· Servidor Standby: Apenas um servidor pode estar em modo Standby em um Domínio em um determinado
momento. O servidor Standby executa o E3Run em modo Standby, o aplicativo permanece carregado, apenas
esperando um comando para entrar em operação. O servidor Standby monitora o servidor ativo e, se este não
estiver respondendo, o Standby é ativado
· Servidor Inativo: Um servidor permanece inativo quando está declarado no Domínio, mas não está selecionado
como servidor principal nem como backup. Mesmo inativo, este servidor monitora mudanças no arquivo de
Domínio, podendo passar para o estado Ativo ou Standby se o Domínio for reconfigurado
IMPORTANTE
Para executar uma aplicação redundante no Elipse Power, é necessário que todos os servidores executem a mesma
versão do software, e tenham uma cópia local atualizada dos arquivos do Domínio (arquivos .prj, .lib, etc.). O arquivo
.dom, por sua vez, é sincronizado automaticamente pelo E3 Server, isto é, mudanças realizadas no arquivo .dom em
um servidor são automaticamente copiadas para o arquivo .dom dos outros servidores do Domínio. Para isto, o
arquivo .dom deve obrigatoriamente existir no mesmo caminho em todos os servidores.
O Hot-Standby usa a conexão REC, portanto ele só funciona se o E3 Server estiver iniciado nas máquinas envolvidas.
Se o usuário de um Elipse Power Studio ou Hot-Standby é administrador da máquina remota onde o E3 Server está
executando, ele pode controlar o serviço remotamente usando o aplicativo services.msc, através da opção Action -
Connect to another computer.
30.1 Configurando
As configurações que devem ser realizadas para implementar o Hot-Standby são as seguintes:
1. Localize o caminho dos arquivos de Domínio (arquivos .dom, .prj, .lib, etc.) no computador principal e copie esta
pasta para o computador Standby. Caso tenha sido indicado um outro caminho para os arquivos de Domínio na
opção Pasta raiz dos arquivos do Domínio na aba Servidores, deve-se utilizar este caminho para a cópia.
2. Os arquivos de bancos de dados devem ser tratados de maneira diferenciada. Para mais informações, consulte o
tópico Utilizando Bancos de Dados com Hot-Standby.
3. Clique com o botão direito do mouse no ícone do E3 Admin na Área de Notificações do Windows e selecione
a opção Domínio - Opções.
509 Hot-Standby
E3 Admin
4. Na aba Servidores, adicione os servidores principal e backup. Configure as opções Nome do servidor e
Identificação do servidor na rede, conforme descrito no tópico Aba Servidores. Por exemplo:
· Nome do servidor: Servidor1
· Identificação do servidor na rede: \\Computer1
5. Na aba Hot-Standby, selecione a opção Habilitar. No campo Servidor principal, selecione o servidor principal
do projeto e, no campo Servidor de backup, selecione o servidor de backup. O Elipse Power busca o servidor
principal por ordem alfabética.
6. Defina a opção Endereços para PING de integridade de rede, conforme especificado no item Endereços para
PING de integridade da rede do tópico Domínios- Configurações - Aba Hot-Standby.
7. Habilite a opção Ativar backup em caso de falha local, conforme especificado no item Ativar backup em caso
de falha local do tópico Domínios - Configurações - Aba Hot-Standby.
8. Para confirmar as configurações, clique em OK.
9. Ao iniciar a execução do Elipse Power é mostrado, na Área de Notificações do Windows dos computadores
configurados no Hot-Standby, um ícone representado por uma barra amarela circulante , indicando que os
Domínios estão sendo carregados. Após alguns segundos, o Elipse Power reconhece o computador principal e
indica este estado, na Área de Notificações do Windows, com um ícone representado por uma seta verde . Este
ícone determina que este computador está em execução. No computador standby é mostrado um ícone
representado por duas barras amarelas , indicando que este computador está em modo Standby (modo de
espera).
30.2 Executando um Domínio Redundante

Para executar um Domínio redundante, é necessário apenas iniciar um dos seus servidores. Os outros servidores são
automaticamente iniciados por este primeiro servidor. Para iniciar um Domínio, crie um atalho para o E3 Admin com a
seguinte linha de comando:
E3Admin.exe –start <Caminho_do_Domínio>
Este servidor inicia os servidores do Domínio e depois é automaticamente fechado. Um Domínio pode ser iniciado
também através do Elipse Power Studio. Para tanto, abra o Domínio e clique em na barra de ferramentas Padrão.
30.3 Parando um Domínio Redundante

Um Domínio pode ser parado por qualquer um dos seus servidores, através do ícone na Área de Notificações do
Windows. Selecione a opção Domínio - Parar e o servidor Ativo e o Standby terminam o processo E3Run. O Domínio
pode ser reiniciado selecionando a opção Domínio - Executar. Se for selecionada a opção Domínio - Fechar, o
Domínio é parado e fechado, ficando os E3 Servers disponíveis para executar outros Domínios.
IMPORTANTE
As opções de parar e fechar um Domínio AFETAM TODOS OS SERVIDORES DO DOMÍNIO, e não apenas o servidor
onde o comando é executado.
Hot-Standby 510
30.4 Parando um dos Servidores do Domínio
A maneira correta de parar um dos servidores do Domínio é marcá-lo como Em manutenção na configuração
Domínio - Opções, aba Servidores, do Domínio. Se o servidor ativo for colocado em manutenção, o servidor Standby
passa para o estado ativo. Para recolocar o servidor no Domínio, desmarque a opção Em manutenção deste
servidor.
30.5 Tempo de Troca entre Servidores

O tempo padrão para o servidor de backup assumir, quando ocorre uma falha do servidor ativo, é de 15 segundos.
No entanto, é possível configurar este tempo através do item Tempo para ativação do servidor reserva, conforme
explicado no tópico Aba Hot-Standby.
Este tempo permite que o servidor anterior termine a execução do aplicativo, caso a falha seja apenas de rede. O
tempo configurado afeta diretamente o timeout do ping entre os servidores. Se este tempo estiver muito baixo, como
por exemplo uma troca em um segundo e um time-out de ping igual a 160 ms, podem ocorrer trocas espontâneas de
servidor, causadas por pequenas falhas de rede.
30.6 Reconexão de Elipse Power Viewers

Quando há uma troca de servidores, os Elipse Power Viewers entram em processo de reconexão, tentando
alternadamente conectar com o servidor backup e com o ativo. O usuário tem a opção de esperar o fim do processo
de reconexão com o Elipse Power Viewer atual, cancelar a reconexão (e fechar o Elipse Power Viewer) ou abrir uma
nova sessão Elipse Power Viewer com o novo servidor.
30.7 Utilizando Bancos de Dados com Hot-Standby

Pode-se ter dois servidores executando separadamente em uma mesma aplicação. Um deles permanece ativo,
enquanto o outro permanece em estado de espera (standby), aguardando uma possível falha.
O Hot-Standby garante a continuidade da aplicação, mas quando se utiliza bancos de dados, também é preciso
garantir a continuidade do acesso à base de dados.
Há duas maneiras de resolver este problema. Na primeira, ambas as aplicações acessam uma mesma base de dados.
Habilita-se o acesso ao banco de dados na aplicação, configurando o objeto DBServer em ambos servidores
(Principal e Standby) com os mesmos parâmetros de localização do banco de dados na rede. Para garantir a
continuidade do sistema, é importante que a base de dados esteja em uma máquina separada, acessível aos dois
servidores.
Na segunda maneira, a gravação dos dados é feita em bases diferentes. Neste caso, o ideal é ter-se os dois bancos
de dados executando localmente, em ambos os servidores. Assim, garante-se que o acesso ao banco de dados está
sempre disponível, pois a máquina que executa a aplicação também executa o banco de dados.
Uma opção interessante neste caso é a sincronização entre as diferentes bases de dados da aplicação principal e
secundária. A propriedade EnableSynchronization do objeto DBServer habilita este recurso na aplicação. Quando ela
está ativa, todos os dados gravados na base principal são atualizados na base em Standby quase instantaneamente.
NOTA
Se a aplicação principal não conseguir enviar os dados para o servidor em Standby, estes dados permanecem
armazenados localmente em disco, para posterior envio quando a comunicação entre os dois computadores for
restabelecida, assegurando assim a igualdade entre as tabelas geradas pela aplicação.
511 Hot-Standby
CAPÍTULO
Configurações Avançadas
31
Existem configurações do Elipse Power que podem ser realizadas diretamente no Registro do Windows, embora esse
procedimento não seja aconselhável. A Elipse Software possui uma ferramenta, chamada E3 Tweak, que realiza as
configurações de registro usando uma interface gráfica. O Manual do Usuário do E3 Tweak pode ser aberto pelo
menu Iniciar do Windows. O aplicativo E3 Tweak pode ser aberto das seguintes formas:
· Pelo menu Iniciar do Windows
· Pelo menu Ferramentas - E3 Tweak do Elipse Power Studio
· Pelo item Atalhos - E3 Tweak do menu do E3 Admin na Área de Notificação do Windows
Configurações Avançadas 512

CAPÍTULO
Biblioteca E3DataAccess
32
Esperando atender a demanda de desenvolvimento de aplicações que possam visualizar e modificar dados de um
servidor E3 ou Elipse Power, a Elipse Software desenvolveu um objeto COM na forma de uma biblioteca chamada
E3DataAccess. Através dos eventos, métodos e propriedades fornecidos por este objeto, qualquer aplicação escrita
em Visual Basic, Delphi ou .NET, entre outras linguagens, que suporte objetos COM pode criar uma interface de
comunicação com o E3 ou Elipse Power. Um detalhe importante é que cada instância da Biblioteca E3DataAccess
consome uma licença de Viewer e só pode estar conectada a um servidor E3 ou Elipse Power de cada vez.
Ao instanciar um objeto E3DataAccess, pode-se monitorar a propriedade Server, que define com qual servidor E3 ou
Elipse Power esta instância está conectada ou tentando se conectar. Após a conexão, o usuário tem acesso aos
métodos síncronos de leitura e escrita de Tags, busca de dados através de consultas e recebimento de eventos de
modificação de Associações, descritas nos tópicos a seguir.
32.1 Eventos
OnValueChanged(Path, Timestamp, Quality, Value)
Os parâmetros deste evento são os seguintes:
· Path: Caminho para a propriedade monitorada
· Timestamp: Estampa de tempo da propriedade referenciada no parâmetro Path
· Quality: Qualidade da propriedade referenciada no parâmetro Path
· Value: Valor da propriedade referenciada no parâmetro Path
Este evento pode ser capturado por qualquer aplicação que instancie esta biblioteca. A partir do momento em que o
método RegisterCallback é usado, o objeto COM começa a enviar as notificações de mudança para a propriedade
passada no parâmetro Path. Para que este objeto esteja apto a recebê-las, deve-se criá-lo com o protótipo declarado
a seguir.
Public Sub OnValueChanged(ByVal link As String, ByVal TimeStamp As Object, ByVal Quality As
Short, ByVal Value As Object)
Depois é necessário adicionar um handler ao evento do objeto COM. No Visual Basic, isto é realizado conforme o
protótipo a seguir.
AddHandler(e3.OnValueChanged, New
E3DataAccessLib._IE3DataAccessManagerEvents_OnValueChangedEventHandler(AddressOf OnValueChanged))
Assim, sempre que é gerado um evento pela Biblioteca E3DataAccess, a aplicação recebe uma chamada do método
OnValueChanged mostrando a Associação da propriedade modificada, a estampa de tempo da modificação, a
qualidade e o novo valor.
32.2 Métodos
Este tópico contém os métodos disponíveis na Biblioteca E3DataAccess.
BatchRegisterCallback(PathCollection)
Este método é usado para monitorar as modificações ocorridas em alguma propriedade de uma coleção de objetos
instanciados no servidor E3 ou Elipse Power. A partir do momento em que as Associações são registradas, a
aplicação passa a receber notificações das variações dos valores monitorados. O parâmetro PathCollection deve
fornecer os caminhos para as propriedades dos objetos a ser monitoradas, separados por vírgulas, como por
exemplo "Dados1.TagDemo1.Value,Dados1.TagDemo2.Value". Este método retorna Verdadeiro se as Associações
foram registradas corretamente ou Falso se não foi possível registrar as Associações.
BatchUnregisterCallback(PathCollection)
Este método é usado para remover as Associações passadas como parâmetro da lista de monitoramento, permitindo
que uma aplicação não receba mais eventos de modificação para aquelas Associações. O parâmetro PathCollection
deve fornecer os caminhos para as propriedades dos objetos que devem ser removidas da lista de monitoramento,
separadas por vírgula, como por exemplo "Dados1.TagDemo1.Value,Dados1.TagDemo2.Value". Este método retorna
513 Biblioteca E3DataAccess

Verdadeiro se as Associações foram removidas da lista de monitoramento corretamente ou Falso se não foi possível
remover as Associações da lista de monitoramento.
ClearCallbacks()
Este método remove todas as Associações registradas. Retorna Verdadeiro se a operação foi bem-sucedida ou False
se não foi possível remover todas as Associações.
Connect()
Este método conecta ao servidor ou servidores relacionados na propriedade Server.
Disconnect()
Este método executa uma desconexão do servidor atualmente conectado.
ExecuteQuery(Path, Names, Values, QueryResult)

Este método executa uma Consulta e retorna os resultados, se houver. O parâmetro Path indica o caminho para um
objeto Consulta a ser executado no servidor E3 ou Elipse Power, como por exemplo "Dados.Consulta1". O parâmetro
Names é um array com os nomes das variáveis a serem configuradas na Consulta referenciada no parâmetro Path. O
parâmetro Values é um array com os valores das variáveis referenciadas pelo parâmetro Names. O parâmetro
QueryResult é uma variável que recebe uma matriz com os valores retornados pela Consulta referenciada no
parâmetro Path. Este método retorna Verdadeiro se a Consulta foi executada corretamente e Falso se não foi possível
encontrar ou executar a Consulta especificada no parâmetro Path.
GetValue(Path, Timestamp, Quality, Val)

Este método retorna o valor de uma propriedade de um objeto em um servidor E3 ou Elipse Power. O parâmetro
Path fornece o caminho para um objeto a ser monitorado. O parâmetro Timestamp é uma variável que recebe a
estampa de tempo da Associação referenciada pelo parâmetro Path. O parâmetro Quality é uma variável que recebe a
qualidade do valor da Associação referenciada pelo parâmetro Path. O parâmetro Val é uma variável que recebe o
valor da Associação referenciada pelo parâmetro Path. Este método retorna Verdadeiro se a Associação foi
encontrada e os valores retornados corretamente ou Falso se não foi possível encontrar a Associação e buscar os
valores.
Login(Login, Password)
Este método executa um login no servidor E3 ou Elipse Power usando o usuário e a senha indicados nos parâmetros
Login e Password, respectivamente. Este método retorna Verdadeiro se o login foi bem-sucedido ou Falso em caso de
erro.
Logout()
Este método executa um logout do servidor E3 ou Elipse Power do usuário indicado no método Login.
ReadValue(Path, Timestamp, Quality, Val)

Este método lê o valor de uma propriedade de um objeto em um servidor E3 ou Elipse Power. O parâmetro Path
fornece o caminho para um objeto a ser lido. O parâmetro Timestamp é uma variável que recebe a estampa de tempo
da Associação referenciada pelo parâmetro Path. O parâmetro Quality é uma variável que recebe a qualidade do valor
da Associação referenciada pelo parâmetro Path. O parâmetro Val é uma variável que recebe o valor da Associação
referenciada pelo parâmetro Path. Este método retorna Verdadeiro se a leitura foi bem-sucedida ou Falso se não foi
possível encontrar a Associação ou retornar o valor.
RegisterCallback(Path)
Este método é usado para monitorar as modificações ocorridas em alguma propriedade de um objeto instanciado no
servidor E3 ou Elipse Power. A partir do momento em que a Associação é registrada, a aplicação passa a receber
notificações das variações do valor monitorado. O parâmetro Path fornece o caminho para a propriedade do objeto a
ser monitorada, como por exemplo "Dados1.TagDemo1.Value". Este método retorna Verdadeiro se a Associação foi
registrada corretamente ou Falso se não foi possível registrar a Associação.
Biblioteca E3DataAccess 514

ResetCommSettings()
Este método configura todas as propriedades de conexão do objeto E3DataAccess para seus valores padrão.
SetValue(Path, Timestamp, Quality, Val)

Este método configura o valor de uma propriedade de um objeto em um servidor E3 ou Elipse Power. O parâmetro
Path fornece o caminho para um objeto a ser modificado. O parâmetro Timestamp fornece a estampa de tempo da
Associação referenciada pelo parâmetro Path. O parâmetro Quality fornece a qualidade do valor da Associação
referenciada pelo parâmetro Path. O parâmetro Val fornece o valor da Associação referenciada pelo parâmetro Path.
Este método retorna Verdadeiro se a Associação foi encontrada e os valores configurados corretamente ou Falso se
não foi possível encontrar a Associação e configurar os valores corretamente.
UnregisterCallback(Path)
Este método é usado para retirar a Associação passada como parâmetro da lista de monitoramento, permitindo que
uma aplicação não receba mais eventos de modificação para aquela Associação. O parâmetro Path fornece o caminho
para a propriedade que deve ser removida da lista de monitoramento, como por exemplo "Dados1.TagDemo1.Value".
Este método retorna Verdadeiro se a Associação foi removida da lista de monitoramento corretamente ou Falso se
não foi possível remover a Associação da lista de monitoramento.
WriteValue(Path, Timestamp, Quality, Val)

Este método escreve um valor em uma propriedade de um objeto em um servidor E3 ou Elipse Power. O parâmetro
Path fornece o caminho para um objeto a ser escrito. O parâmetro Timestamp é a estampa de tempo para a
Associação referenciada pelo parâmetro Path. O parâmetro Quality é a qualidade do valor para a Associação
referenciada pelo parâmetro Path. O parâmetro Val é o valor para a Associação referenciada pelo parâmetro Path.
Este método retorna Verdadeiro se a escrita foi bem-sucedida ou Falso se não foi possível encontrar a Associação ou
escrever o valor.
32.3 Propriedades
As propriedades disponíveis na Biblioteca E3DataAccess estão descritas a seguir.
ActiveServer
Esta propriedade é somente de leitura e retorna o nome do servidor ativo no momento.
AutoConnect
Esta propriedade configura se o usuário não controla explicitamente a conexão e a desconexão (Verdadeiro) ou se
o usuário controla explicitamente a conexão e a desconexão (Falso).
ConnectionState
Esta propriedade é somente de leitura e retorna o estado da conexão. Os valores possíveis para esta propriedade
são 0: Desconectado, 1: Conectando, 2: Conectado ou 3: Desconectando.
ConnectionTimeoutMs
Esta propriedade indica o tempo máximo para conexão com um servidor.
DomainState
Esta propriedade é somente de leitura e retorna o estado do Domínio. Os valores possíveis para esta propriedade
são 0: Desconhecido, 1: Em Hot-Standby, 2: Parado ou 3: Executando.
HeartBeatCheckMs
Esta propriedade indica o intervalo, em milissegundos, entre as mensagens de heartbeat para o servidor. Este valor
deve ser maior do que o valor da propriedade HeartBeatMs, tipicamente o dobro do tempo.
515 Biblioteca E3DataAccess

HeartBeatMs
Esta propriedade indica o tempo máximo, em milissegundos, para envio de uma mensagem de heartbeat para o
servidor. Configurar esta propriedade com o valor 0 (zero) desabilita o envio desta mensagem de heartbeat (não
recomendado).
IsReadOnly
Esta propriedade é somente de leitura e indica se a conexão com o Domínio é somente de leitura.
PingTimeoutMs
Esta propriedade indica o tempo máximo de espera para um comando ping. Configurar esta propriedade com o
valor 0 (zero) desabilita o comando ping.
Server
Esta propriedade indica o nome do servidor ou servidores E3 ou Elipse Power para conexão. No caso de mais de
um servidor, separe os valores por vírgula.
StartReadOnly
Esta propriedade configura se a conexão com o servidor inicia em modo somente leitura ou não.
User
Esta propriedade é somente de leitura e indica o nome do usuário atualmente logado no servidor E3 ou Elipse
Power.
Biblioteca E3DataAccess 516

CAPÍTULO
Dúvidas mais Frequentes
33
Este capítulo destina-se ao esclarecimento das dúvidas mais frequentes encontradas no Elipse Power. Também são
mostrados os erros que podem ocorrer e quais as soluções para eles.
33.1 Alarmes
Foi encontrado um erro no número de colunas do arquivo CSV na importação de um Alarme do tipo
<nomedotipo>. Deseja continuar a importação dos demais Alarmes, ignorando os erros?
POSSÍVEIS 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 número mínimo de colunas esperado, de acordo com cada tipo. Colunas
extras são desprezadas. Para saber a maneira correta de criar um arquivo CSV para alarmes, veja o tópico Criando
um arquivo CSV manualmente no capítulo Elipse Power Studio.
SOLUÇÃO
Existem três possíveis respostas à pergunta feita na mensagem de erro:
· Sim: A importação dos Alarmes contidos no arquivo CSV prossegue, ignorando apenas este erro de número de
colunas. O Alarme cujas colunas estão incorretas não é importado
· Sim (Todos): A importação dos Alarmes prossegue, ignorando todos os demais Alarmes com erro no número de
colunas que possam existir no arquivo CSV
· Não: A importação é interrompida, mas os Alarmes já importados são preservados
Para que este erro não ocorra, o arquivo CSV deve ser criado de acordo com as recomendações do capítulo
Alarmes.
IMPORTANTE
Embora os arquivos de Tags e Alarmes tenham a mesma extensão (.csv), eles são internamente diferentes. Sendo
assim, um arquivo de Alarmes não serve para Tags e vice-versa.
Criei um arquivo CSV manualmente, contendo a configuração dos Alarmes. Como faço para
importá-lo?
Verifique as configurações regionais no Painel de Controle do Windows, e confirme se o caractere separador é o
mesmo utilizado no arquivo CSV. DICA: crie um Alarme no Elipse Power e utilize a ferramenta de exportação,
utilizando-o como modelo para a geração 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 configuração para o E3Browser é feita na aba
Fontes de Dados, na coluna Formato de cada campo. Para o E3Alarm, tal configuração é feita na aba Colunas,
clicando em Propriedades de cada campo.
Aparece a seguinte mensagem de erro: "Impossível criar assinaturas de Alarmes no Servidor de

Alarmes com filtro. Error code: (0x800706F7)". O que isto significa?
O nome do Servidor de Alarmes não foi especificado no E3Alarm, ou então está errado. Para que o E3Alarm consiga
capturar e exibir os Alarmes ativos, é necessário configurar o nome do Servidor de Alarmes a ser acessado. Para isto,
modifique o valor da coluna Servidor de Alarmes da Conexão desejada na aba Conexões da janela de propriedades
do objeto E3Alarm, ou através da Lista de Propriedades, acessando a propriedade AlarmServer.
Como apagar Tags associados a Alarmes e Áreas do objeto Configuração de Alarmes?

· Para apagar um Tag que está associado a um Alarme: Selecione o Tag desejado com o mouse e pressione a
tecla DELETE
517 Dúvidas mais Frequentes

· Para apagar um Alarme: Selecione o Alarme desejado com o mouse e pressione a tecla DELETE
· Para apagar uma Área: Selecione a Área desejada com o mouse e pressione a tecla DELETE
Como exibir as mensagens "Alta", "Média" e "Baixa" no campo Severidade de um Alarme ao invés
dos valores 0 (zero), 1 (um) e 2 (dois) em uma consulta SQL?
A sintaxe SQL para cada um dos bancos de dados suportados pelo Elipse Power é a seguinte:
· Access:
SELECT InTime, OutTime, Message, FormattedValue,
IIF(Severity = "0", "Alta",
IIF(Severity = "1", "Média", "Baixa"))
AS Severidade FROM Alarms;
· SQL Server:
Severidade = CASE Severity
WHEN 0 THEN 'Alta' WHEN 1 THEN 'Média'
WHEN 2 THEN 'Baixa' END FROM Alarms;
· Oracle:
DECODE(Severity, 0, 'Alta', 1, 'Média', 2, 'Baixa')
Severidade FROM Alarms;
33.2 Associações
Como criar um Tag Expressão no Elipse Power?
Associando a propriedade Value de um Tag Interno à expressão desejada. A expressão pode ser do tipo simples e
pode conter operadores aritméticos e lógicos envolvendo constantes e outros Tags.
Como mudar a cor de um objeto ao passar o mouse sobre ele?

Criando uma Associação Digital entre as propriedades ForegroundColor e MouseOver de um objeto. A propriedade
MouseOver é do tipo Booleana, e assume o valor Verdadeiro quando o mouse estiver sobre objeto e Falso quando o
mouse estiver fora da área do objeto.
Como criar uma aplicação multilíngue?

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 do método Msgbox. Depois, criar
uma tabela com todas as Strings da aplicação, onde a primeira coluna é o nome do Tag Interno criado no Viewer, e
cada coluna seguinte contém a String correspondente a um idioma. Esta tabela pode ser criada no Access, por
exemplo. Ao abrir o Viewer e definir o idioma, carregar os Tags Internos do Viewer com as Strings da tabela
correspondente ao idioma escolhido. Isto pode ser realizado 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 parâmetro passado para a Tela contendo o nome
' da coluna referente ao idioma selecionado
rs.MoveNext
Next
End Sub
Outra maneira é criar uma Associação por Tabela em todas as propriedades que possuem conteúdo a ser traduzido,
usando para todas as Associações a mesma fonte. Em cada faixa de valores da Associação, 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 método MsgBox, use o mesmo Tag como condição para escolher qual String é utilizada.
Dúvidas mais Frequentes 518

33.3 Bibliotecas
Ao abrir uma Tela, aparece uma mensagem dizendo que um objeto não pode ser carregado
corretamente
POSSÍVEL CAUSA
Foi apagado algum XControl da Biblioteca que estava sendo usada dentro desta Tela ou então foi removido do
Domínio a Biblioteca que contém este XControl.
SOLUÇÃO
No primeiro caso, se foi apagado o XControl, não há mais como recuperá-lo. Para corrigir o erro, apague o objeto
ElipseX que ficou dentro da Tela (pelo Organizer pode-se ver um ponto de interrogação sobre o ícone do objeto. Na
Tela aparece um quadrado preto com um "X"). No segundo caso, adicione a Biblioteca ao Domínio.
Ao abrir uma Tela, aparece uma mensagem de erro dizendo que não foi possível abrir uma
Biblioteca ActiveX
POSSÍVEL CAUSA
Alguns ActiveX utilizados nesta Tela não foram registrados e adicionados no computador.
SOLUÇÃO
Registre e adicione o ActiveX através da opção Adicionar ActiveX, disponível no menu Ferramentas. Para tanto,
deve-se ter o arquivo OCX que contém a Biblioteca.
Ao inserir um controle ActiveX na minha Tela ocorreu um erro 80040112. O que isto significa?
POSSÍVEL CAUSA
Este erro indica que o controle ActiveX inserido não está licenciado na máquina. Durante o instanciamento, o controle
procura no Registro do Windows por sua chave de licença (HKEY_CLASSES_ROOT\Licenses) e, caso não encontre,
retorna este erro. Existem chaves de licença para os controles ActiveX, tanto para ambientes de desenvolvimento
quanto para tempo de execução.
SOLUÇÃO
Para resolver este problema, é preciso adquirir a licença deste controle ActiveX e registrá-lo no computador.
Tenho duas Bibliotecas em meu Domínio, mas não 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 cópia da outra, permanecendo as duas com o mesmo
identificador. Por isto, é necessário remover uma delas do Domínio.
33.4 Domínios e Projetos

O que acontece com os eventos gerados pelo E3 Server enquanto o Domínio não está executando?
Sempre que o registro de eventos estiver habilitado, o E3 Server coloca os eventos gerados na lista interna de
eventos (em memória). Esta lista é esvaziada em três situações:
· Se existe um E3Run executando localmente (isto é, o E3 Server está em estado Hot), os eventos da lista são
enviados para o E3Run para serem gravados no Banco de Dados. Se a gravação funcionar, os eventos gravados
são removidos da lista
· Se existe outro E3 Server executando em estado Hot no Domínio, as mensagens são enviadas para este E3 Server
· Se o Domínio é fechado, todas as mensagens que ainda não foram gravadas são descartadas
Utilizei o E3 Admin via linha de comando e apareceu um erro. Por que isto ocorreu?
Muitas vezes, quando se utiliza o E3 Admin via linha de comando, pode-se configurar algum parâmetro errado, o que
acaba provocando uma mensagem de erro. As mensagens de erro que podem aparecer são as seguintes:

· O Domínio não pode ser aberto porque o arquivo 'nomedoarquivo.dom' é somente para leitura
· Esta mensagem aparece quando o arquivo de Domínio é somente de leitura (read-only)
· As opções não são válidas ou o nome do Domínio não está correto. Verifique as opções informadas e se o
Domínio existe
· Esta mensagem aparece quando for informada uma opção inexistente, um nome de Domínio inexistente ou
quando o arquivo do Domínio não for localizado, provavelmente por ter sido informado um caminho inválido
para o Domínio
· O nome do Domínio não foi informado
· Esta mensagem aparece quando forem usadas as opções -viewer ou -start sem o nome do Domínio. Para
maiores informações, consulte o capítulo Domínios
Como duas ou mais pessoas podem trabalhar ao mesmo tempo no mesmo Domínio?
Criando o Domínio pela rede, várias pessoas podem abri-lo em máquinas diferentes e trabalhar nele ao mesmo
tempo. As alterações salvas por uma pessoa são visíveis para todas as outras, assim que abrirem o objeto específico
alterado, ou então assim que atualizarem o projeto ou a Biblioteca alterados.
Qual o efeito de clicar na opção Atualizar do menu do projeto?

Todos os objetos do projeto são atualizados. Por exemplo, se várias pessoas estiverem trabalhando ao mesmo
tempo no mesmo Domínio, as alterações salvas por uma pessoa são visíveis para todas as outras, assim que abrirem
o objeto específico alterado ou quando atualizarem o projeto ou a Biblioteca alterados.
33.5 Domínios Remotos

Como funcionam as licenças dos Domínios Remotos?
Tanto o E3 Server executando o Domínio Cliente quanto o que executa o Domínio Servidor devem ter licenças
específicas para Domínios Remotos. Quando esta licença existe, o E3 Server Servidor passa a aceitar um número
ilimitado de conexões externas de outros Domínios. Da mesma forma, no caso do E3 Server Cliente, é possível
estabelecer um número ilimitado de conexões. Para maiores informações sobre as limitações do modo Demo do
Elipse Power, consulte o tópico Limitações do Modo Demonstração.
O que acontece quando a comunicação entre o Domínio Cliente e o Domínio Servidor cai?
Quando uma situação de erro ocorrer, todas as Associações da aplicação cliente referenciando o Domínio são
desconectadas (Displays, por exemplo, passam a mostrar o texto que indica erro de comunicação, conforme as
configurações do Elipse Power Viewer), assim como todos os comandos Application.GetObject referenciando o
Domínio Remoto falham, ou seja, causam erros de script. Quando o problema é resolvido, as Associações devem
reconectar-se automaticamente. Já os comandos Application.GetObject devem ser executados novamente.
Um Domínio Cliente pode visualizar Alarmes de outros Domínios Remotos?

Sim, pode-se visualizar e reconhecer alarmes em Domínios Remotos utilizando, na propriedade AlarmServer de um
objeto E3Alarm, a sintaxe DOMINIO_REMOTO:SERVIDOR_ALARME, onde DOMINIO_REMOTO é o apelido (alias)
dado ao Domínio Remoto na aba Domínios Remotos da configuração do Domínio e SERVIDOR_ALARME é o nome
do Servidor de Alarmes.
Um Domínio Cliente pode abrir Telas de outros Domínios Remotos?

Não.
Um Domínio Cliente pode usar usuários de outros Domínios Remotos?

Não.
Um Domínio pode se conectar a vários outros Domínios?

Sim, como pode-se ver na figura a seguir.

Conectar um Domínio a vários outros Domínios
Um Domínio pode se conectar a um Domínio em Hot-Standby?

Sim. Considere a arquitetura da figura a seguir.

Conectar um Domínio a um Domínio em Hot-Standby
Através dos Domínios Remotos esta arquitetura é possível. Tem-se um Domínio de Comunicação, em Hot-Standby,
comunicando com os dispositivos. Estes dados são lidos por um outro Domínio, também em Hot-Standby, que é o
servidor para os computadores clientes (Elipse Power Viewers).
Um E3 Server pode ser configurado como Domínio Remoto Servidor e Cliente ao mesmo tempo?
Não. Isto pode causar o surgimento de Associações circulares, ou seja, A » B » C » A, onde o Domínio A tem como
Cliente o Domínio B, o Domínio B tem como Cliente o Domínio C e o Domínio C tem como Cliente o Domínio A.
Mesmo que as Associações não sejam circulares, as escritas de Associações (ou outras operações síncronas) podem
causar travamentos (deadlocks) entre os E3 Servers. Para contornar esta situação, sugerimos que o aplicativo seja
modificado para que um Domínio funcione apenas como Cliente ou como Servidor, mas nunca como Cliente e
Servidor ao mesmo tempo.
Domínios Remotos podem ser configurados em máquinas que não pertencem a um domínio de
rede Microsoft?
Depende. O arquivo de Domínio é sempre aberto pelo E3 Server, que executa exclusivamente na conta SYSTEM. É
necessário então abrir o compartilhamento para o usuário SYSTEM, que chega na outra máquina com a mensagem
de Sessão Nula (Null Session). Esta Sessão Nula pode ser configurada para ser aceita como um usuário anônimo.
Portanto, configure o compartilhamento para o usuário anônimo conforme os artigos Configurando Domínios Remotos
em máquinas que não pertencem a um domínio de rede Microsoft e Configurando Domínios Remotos em máquinas que não
pertencem a um domínio de rede Microsoft (Windows XP/Windows XP).
Porém, há uma incompatibilidade identificada no sistema operacional Windows 7 ou superior. Para contornar esta
questão, recomendamos que os arquivos da aplicação remota sejam copiados e colados na mesma pasta do
computador local. Nas configurações de Domínio Remoto, configure o campo Arquivo de Domínio para que aponte
para o Domínio copiado, que está na mesma máquina do Elipse Power Studio. O campo Servidor principal deve ser
configurado com o nome do computador remoto. Deste modo, é possível utilizar o AppBrowser para criar todas as
Associações via Elipse Power Studio e, quando a aplicação é executada, estes valores são buscados na máquina
remota.

O protocolo DCOM do Windows é utilizado pelo Elipse Power para a comunicação entre Domínios
Remotos e Elipse Power Viewer?
Não, nestas interações o protocolo utilizado é o REC, proprietário da Elipse Software.
O que é o protocolo REC? Como posso visualizar o tráfego de dados no log do Elipse Power?
O REC é um protocolo desenvolvido pela Elipse Software para comunicação entre os diversos módulos do Elipse
Power. Os pacotes do REC não têm tamanho fixo. A quantidade de dados que passa pelo protocolo pode ser vista
nos mesmos logs do Elipse Power e é indicada pela quantidade de dados, em KB, enviados e recebidos.
Quais as configurações necessárias para o funcionamento do protocolo REC?

1. O servidor Elipse Power deve estar executando na máquina de destino.
2. Os Firewalls da máquina de destino e da máquina local devem permitir conexões TCP/IP na porta 6515.
3. Os parâmetros da conexão (time-out, ping, heartbeat) devem ser compatíveis com a velocidade, confiabilidade e
latência da rede entre a máquina local e a máquina de destino.
O que é heartbeat? Onde ele é configurado? Qual seu impacto no sistema?

O heartbeat é um mecanismo pelo qual o Domínio Cliente envia mensagens periodicamente para verificar se o
Domínio Servidor está com sua conexão ativa, aguardando uma resposta.
Para configurar o tempo de heartbeat, é preciso primeiramente que o Domínio esteja carregado. Depois de carregar o
Domínio, clique com o botão direito do mouse no ícone do E3 Admin na Área de Notificações do Windows e
selecione a opção Domínio - Opções. Na janela E3 Admin - Configuração do Domínio, selecione a aba Domínios
Remotos. Selecione o servidor desejado, clique em Avançado e configure o campo Período de heartbeat (ms).
Quando o dobro deste período é atingido sem que o Cliente tenha recebido nenhuma mensagem do Servidor, o
sistema interpreta que o Servidor falhou ou está fora da rede, e uma desconexão imediata é forçada. Caso o ping e o
heartbeat sejam desligados simultaneamente, a detecção de queda de conexão do Domínio Remoto se torna
extremamente lenta (quando houver falha no Servidor). Nestes casos, é possível que 40 segundos ou mais se passem
sem que o Domínio Cliente indique a perda da conexão. Recomendamos que ambos os Domínios permaneçam
ligados sempre que possível.
O que se deve fazer caso muitos erros de ping estejam ocorrendo na rede?
Caso isto aconteça, verifique a qualidade e performance da rede e siga os procedimentos do artigo Configurações de
rede do E3 para redes com alta latência, banda reduzida e/ou perda de pacotes. Entretanto, relembramos que a
configuração padrão dos Domínios Remotos, e do protocolo REC em geral, não é adequada para redes WAN (Wide
Area Network), apenas para redes LAN (Large Area Network).
O que são chamadas síncronas e chamadas assíncronas? Qual a melhor alternativa em relação à
performance?
Na comunicação síncrona, o emissor e o receptor devem ambos permanecer em sincronia, e uma solicitação só é
atendida após o resultado de uma escrita ou requisição. Na comunicação assíncrona, por outro lado, o envio de
dados é intermitente e não depende do resultado de nenhuma requisição para iniciar a próxima solicitação.
Quando uma chamada síncrona é gerada, o processo aguarda indefinidamente pelo retorno desta chamada. Já
quando uma chamada assíncrona é gerada, nenhum tipo de retorno é esperado.
Por exemplo, considere uma arquitetura de Domínios Remotos onde existe um Centro de Operação que se conecta a
diversos Domínios Remotos. Se um dos Domínios estiver travado e uma chamada síncrona é disparada para este
Domínio, todo o Centro de Operação trava.
Para evitar esta situação, configure a opção Tempo limite de chamada (ms), disponível no Elipse Power a partir da
versão 4.6, de modo individual para cada conexão de Domínios Remotos. Se uma chamada síncrona demorar mais
tempo que este valor de time-out, o canal é fechado e destrava o processo que originou a chamada.
33.6 Drivers de Comunicação

O que tenho que fazer para usar os bits de um Tag de Comunicação?
Para usar os bits de um Tag de Comunicação, deve-se habilitar a propriedade UseBitFields do Tag.

Como são contados os Tags Bloco e os bits dos Tags no Elipse Power?
A contagem considera os Tags de Comunicação e o tamanho dos Blocos de Comunicação. Os bits não entram na
contagem.
Qual a maneira mais fácil de piscar a cor de um objeto na Tela quando houver um erro de
comunicação?
Crie uma Associação Digital entre a propriedade ForegroundColor do objeto e a expressão NomeDoTag.Quality <
192, com a opção de pisca habilitada. A propriedade Quality representa o estado da qualidade do valor do Tag, no
padrão OPC, e pode variar de 0 a 255, sendo que a qualidade é boa apenas acima do valor 192.
Como sinalizar erros de comunicação na Tela?

Habilite a opção Erros de Comunicação do Viewer, na aba Erros de Comunicação.
Como trocar a cor padrão dos erros de comunicação em Setpoints e Displays?

Abra a Janela de Propriedades do Viewer e altere a cor desejada na aba Erros de Comunicação.
33.7 E3Alarm
Os Alarmes não aparecem no E3Alarm. Por que isto ocorre?
POSSÍVEIS CAUSAS
Para checar a configuração do E3Alarm, verifique se o nome do Servidor está configurado corretamente. Outra
possibilidade é a existência de mais de um Servidor de Alarmes no Domínio, o que pode gerar problemas. Mais uma
situação de erro seria um filtro configurado para uma Área de Alarme inexistente.
SOLUÇÃO
Certifique-se de que existe apenas um Servidor de Alarmes no Domínio e que todos os Alarmes estão configurados
corretamente. Confira também se a Área configurada existe.
Como criar 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 opção Reconhecer Alarme, localizada nas propriedades da coluna desejada no objeto E3Alarm, na aba
Colunas.
33.8 E3Browser
Como limitar o número de registros que aparecem no E3Browser?
Este item pode ser configurado na consulta do E3Browser. Habilite a caixa de seleção Retornar no máximo ...
registros, especificando o número máximo de registros a serem retornados. Outra opção é otimizar a consulta a ser
feita utilizando os filtros para restringir o período, a quantidade de colunas ou registros envolvidos, etc. Para isto, veja
o capítulo Consultas.
33.9 E3Chart
É possível não plotar o valor de um Tag quando a qualidade estiver ruim, em um E3Chart histórico?
Sim. Utilizando scripts é possível configurar o E3Chart da seguinte forma:
Set Pena = Screen.Item("E3Chart1").Pens
Pena.Item("Nome da Pena").ShowBadPoints = False
Observe, no entanto, que esta solução somente é válida para valores históricos. Em tempo de execução, o valor é
sempre plotado, independente da qualidade do Tag.

33.10 Histórico
Como não gravar os registros de Históricos por scan?
Configure a opção Intervalo entre registros (ms) na aba Histórico das propriedades do Histórico com o valor 0
(zero). Se desejar configurá-la por script, a propriedade a ser utilizada é ScanTime. Com isto, os valores não são
registrados automaticamente, sendo necessário executar o registro via script utilizando o método WriteRecord.
33.11 Impressora de Linha

O objeto Impressora de Linha tem uma impressora configurada mas, ao imprimir utilizando um
Elipse Power Viewer, a impressora não imprime. Por que isto ocorre?
POSSÍVEL CAUSA
O Elipse Power Viewer não tem acesso à impressora configurada no objeto Impressora de Linha.
SOLUÇÃO
Certifique-se que o Elipse Power Viewer tenha acesso à impressora configurada. Esta situação geralmente ocorre em
Elipse Power Viewers remotos que não tem acesso à impressoras instaladas no servidor.
33.12 Objetos de Tela

Não consigo rotacionar uma figura inserida através da Galeria. Por que isto ocorre?
Deve-se converter o objeto em símbolo. Isto permite que sejam utilizados os comandos e opções disponíveis aos
objetos que são nativos do Elipse Power, como por exemplo, o uso da Rotação.
33.13 Ordem da Tabulação

Qual a relação entre a ordem de criação dos objetos na Tela e a ordem de tabulação em tempo de
execução?
Quando um novo objeto é criado na Tela, atribui-se a este objeto a primeira posição na ordem de tabulação, e este é
ordenado em sequência decrescente em relação aos demais objetos da Tela. Para mais informações sobre este
assunto, consulte o tópico Ordem de Navegação entre os Objetos.
33.14 Relatórios
Como colocar a data e a hora atual em um Relatório do Elipse Power?
Existem pelo menos duas alternativas:
· Coloque um objeto Texto na Seção Page Header e, no evento OnFormat desta Seção, escreva o seguinte script
(Label1 é o nome do objeto Texto):
Report.Sections("PageHeader").Controls("Label1")._
Caption = Now
· Crie um Tag Demo do tipo CurrentTime. No cabeçalho ou no rodapé do Relatório, deve-se inserir um objeto
SetPoint e, na propriedade DataField, deve-se digitar o nome completo do Tag (por exemplo,
"Dados.TagDemo1.Value"). Configure o formato da data desejada. Isto pode ser feito clicando com o botão
direito do mouse no objeto e ajustando as suas propriedades, ou então 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 Relatório que mostra o resultado de uma Consulta que possui um filtro por data.
Quando o Relatório é gerado, a Consulta não retorna os valores configurados via script para estas
variáveis. Como solucionar este problema?
Verifique, no script que configura ou acessa este Relatório, se após os valores para as variáveis da Consulta terem
sido configurados não foi acionado o método LoadReport, já que este método carrega o Relatório com as
configurações realizadas no Elipse Power Studio. Utilize somente uma vez o método LoadReport no script,
carregando o Relatório para uma variável (através do comando Set).

Como executar corretamente um Relatório que utiliza o método CopyConfig para copiar para si as
configurações de um E3Chart em Tela?
O método CopyConfig não copia os valores de variáveis de consulta, sendo necessário executar este procedimento
via script dentro do gráfico. As Penas configuradas no E3Chart em Tela são do tipo Real.
Como criar um filtro por datas no Relatório?

Crie uma Consulta SQL no Relatório filtrando por data inicial e final. Na Tela onde se deseja gerar este Relatório,
deve-se executar a Consulta SQL configurada passando os valores de data inicial e final. O script do botão na Tela
onde é gerado o Relatório, por exemplo, pode ser implementado da seguinte forma:
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()
Como mostrar as datas utilizadas como filtro na Consulta na Seção Page Header do Relatório?
Primeiro, adicione dois SetPoints na Seção Page Header (um para mostrar a data inicial e outro para a data final) e
crie um script que passe os valores que foram carregados nos SetPoints da Tela (e transferidos para a Consulta) para
estes dois SetPoints. O script a ser criado na Seção Page Header, no evento OnBeforePrint do Relatório é o seguinte:
Set dados = Application.GetFrame().Screen
Report.Sections("PageHeader").Controls("Field5").Text = _
dados.Item("TextoDataInicial").Value
Report.Sections("PageHeader").Controls("Field6").Text = _
dados.Item("TextoDataFinal").Value
Depois, associe dois Tags Internos aos SetPoints da Tela onde são especificadas as datas. Associe estes Tags aos
SetPoints no Relatório.
Como imprimo dois Relatórios em impressoras diferentes?

Crie o seguinte script no evento OnReportStart do Relatório:
Sub OnReportStart
Report.Printer.DeviceName = "Nome da Impressora"
End Sub
Como utilizo o evento de script OnError para mostrar uma mensagem de erro quando falhar a
impressão do Relatório?
O evento OnError do Relatório não permite que sejam executados scripts dentro dele, servindo somente para seu uso
interno. Isto significa que não é possível alterar a mensagem de erro, nem executar algum outro procedimento a partir
deste evento.
33.15 Servidor de Banco de Dados Oracle

A seguir são listados os possíveis erros que podem ocorrer ao se testar a conexão com este Banco de Dados:
Error = ORA-01017: invalid username/password; logon denied
POSSÍVEL CAUSA
Mensagem gerada em log quando a senha ou o usuário está incorreto.
SOLUÇÃO
Verificar se o usuário existe e se a senha utilizada está correta.
Error = ORA-12154: TNS: não foi possível resolver nome de serviço
POSSÍVEL CAUSA
A conexão cliente utilizada não foi encontrada.

SOLUÇÃO
Verificar se a conexão utilizada está criada no computador e se ela está funcionando através dos utilitários de rede do
Oracle.
Error = ORA-02264: nome já usado por uma restrição existente
POSSÍVEL CAUSA
Já existe um objeto no Banco de Dados com este mesmo nome.
SOLUÇÃO
Para evitar este erro, crie e configure diferentes nomes de índices ou chaves primárias no Elipse Power.
Error = ORA-01403: dados não encontrados
POSSÍVEL CAUSA
Esta mensagem é gerada quando uma pesquisa interna do Elipse Power procura por objetos no Banco de Dados e
não os encontra (por exemplo, a tabela de Históricos não existe, deve ser criada).
SOLUÇÃO
Isto seria considerado um erro apenas se persistisse nos logs da aplicação.
Error = ORA-00001: restrição exclusiva (SYSTEM.E3INDEX) violada
POSSÍVEL CAUSA
Sempre que for feita uma tentativa de escrita de um registro onde o campo definido como chave primária tiver o
valor repetido, a escrita é recusada e a mensagem anterior é exibida. É interessante verificar que o nome da chave é
mostrado (neste caso, a chave SYSTEM.E3INDEX) no formato Usuário.NomeChave. Dependendo do projeto, este
erro é esperado, mas na grande maioria das vezes, é importante verificar se a chave é a mais adequada. Para ilustrar
esta afirmação, veja estes dois casos:
· Sistema de Telemedição de Energia: Visando gravar todos os dados de um dia, as rotinas usadas para coletar
dados admitem tolerâncias a mais ou a menos no horário a ser coletado. Assim, alguns dos registros têm de ser
escritos mais de uma vez. Neste caso, a ocorrência deste erro é esperada
· Manutenção de alarmes: Para este caso, pode haver mais de um erro por segundo no sistema. Se o campo
E3TimeStamp for usado como chave primária, pode haver a perda de algumas ocorrências de alarme, o que
prejudica a análise posterior dos eventos. Neste caso, re-estudar a chave-primária pode ser a solução adequada
SOLUÇÃO
Há duas maneiras de solucionar esta questão:
1. O usuário deve criar um índice único para os campos da chave.
2. O usuário deve verificar a aplicação para que ela não envie valores repetidos de chave para gravação.
33.16 Servidor de Banco de Dados SQL Server

A seguir são listados os possíveis erros que podem ocorrer ao se testar a conexão com este Banco de Dados:
ErrorLocal = Open Connection ErrorError #0x80004005 Description:[DBNETLIB]

[ConnectionOpen(Connection()).]SQL Server does not exist or access denied. (Source: Microsoft
OLE DB Provider for SQL Server) (SQL State: 08001)(NativeError:17)
POSSÍVEL CAUSA
Nome do Servidor errado na configuração do Servidor de Banco de Dados ou o usuário não tem acesso àquele
banco de dados.

SOLUÇÃO
Verificar o nome do servidor utilizado e se o usuário possui permissão para conectar-se àquele banco de dados.
ErrorLocal = Open Connection ErrorError #0x80040E4D Description: Login failed for user
'UsuarioErrado'.(Source: Microsoft OLE DB Provider for SQL Server) (SQL State: 42000)(NativeError:
18456)
POSSÍVEL CAUSA
Erro no nome do usuário ou senha.
SOLUÇÃO
Utilize um usuário cadastrado no banco de dados ou verifique a senha utilizada.
ErrorLocal = ExecuteSql ErrorError #0x80040E14 Description: There is already an object named

'E3Index' in the database. (Source: Microsoft OLE DB Provider for SQL Server) (SQL State: 42000)
(NativeError: 1750)
POSSÍVEL CAUSA
Já existe um objeto (tabela, chave, índice, etc.) no Banco de Dados com este mesmo nome.
SOLUÇÃO
Mudar o nome do objeto.
33.17 Servidor de Dados

A propriedade Retentive do Tag Interno não está funcionando, pois ela não guarda o último valor
ao parar o Domínio. O que pode estar errado?
A propriedade Retentive não tem este objetivo. Ela tem utilidade apenas em aplicações Hot-Standby, para manter o
valor do Tag Interno quando houver uma troca de servidor.
Como salvar o valor de um Tag Interno ao parar o Domínio?

Use o método Save do Servidor de Dados.
Como eu mostro a data e a hora atual do sistema em uma Tela da minha aplicação?
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 Formatação das propriedades do Display.
Como criar um temporizador no Elipse Power?

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 atribuição do valor Verdadeiro à propriedade Enabled inicia a
contagem do tempo. Para executar um script qualquer no término do temporizador, crie um evento associado à
propriedade Value do Tag Demo, que seja executado quando a propriedade alterar o seu valor. Neste script também
se deve desabilitar o Tag Demo, ou seja, atribuir à propriedade Enabled o valor False, para que ele não continue
variando. Recomenda-se usar o método Reset do Tag Demo antes de atribuir à propriedade Enabled o valor True.
33.18 Sobreposição de Animações nos Objetos

Criei uma Animação com Rotação ou Translação na Tela, mas decidi mudá-la, criando uma nova
Animação. No entanto, quando fui executar a aplicação, o objeto apareceu com a Animação inicial,
e não com a Animação corrente. Por que isto ocorre?
POSSÍVEL CAUSA
A nova Animação foi criada sem que a anterior tenha sido removida.

SOLUÇÃO
Para solucionar esta questão, siga estes procedimentos:
1. Selecione o objeto que deseja mudar a Animação.
2. Clique com o botão direito do mouse neste objeto e selecione a opção Remover animação.
3. Aplique a Animação desejada.
NOTA
Não tente remover a Animação do objeto através do Organizer, pois esta ação remove o objeto.
33.19 Stored Procedure

Como executo uma Stored Procedure no Elipse Power?
A maneira mais fácil é criando uma Consulta no Elipse Power com o comando para executar a Stored Procedure
desejada passando, se necessário, valores para ela. O comando que deve ser configurado nesta Consulta é o
seguinte:
Exec NomeDaStoredProcedure <%var1%>, <%var2%>, ...
A sintaxe para as variáveis deve ser o caractere "<" (menor que), o caractere "%" (percentual), o nome da variável, o
caractere "%" novamente e por fim o caractere ">" (maior que). Os valores var1 e var2 são as variáveis que a Stored
Procedure está esperando (por exemplo, a data inicial e final). Caso a Stored Procedure não esteja esperando
nenhuma variável, crie o comando SQL sem as variáveis. Para executar esta Consulta, utilize o método Execute.
NOTA
A propriedade CursorLocation da Consulta do Elipse Power deve estar configurada como 1 - clClient.
33.20 Elipse Power Viewer

Não consigo conectar um Elipse Power Viewer remoto ao Servidor. Por que isto está acontecendo?
POSSÍVEL CAUSA
Existe um firewall bloqueando o acesso ao servidor.
SOLUÇÃO
Deve-se liberar as portas utilizadas pelo Elipse Power. O procedimento para desbloquear uma porta no Firewall do
Windows está descrito a seguir.
NOTA
A porta padrão utilizada pelo Elipse Power é a 6515, mas este comportamento pode ser alterado conforme descrito
no tópico Elipse Power Viewer e WebViewer - Execução do Elipse Power Viewer - Através do Menu Iniciar.
Windows 7 SP1, Windows 8, Windows 8.1 e Windows 10

1. Vá ao menu Iniciar - Painel de Controle (Start - Control Panel).
2. Clique em Firewall do Windows (Windows Firewall).
3. Clique em Configurações Avançadas (Advanced Settings).
4. Clique com o botão direito do mouse no item Regras de Saída (Outbound Rules) e selecione a opção Nova Regra
(New Rule).
5. Na janela Tipo de Regra (Rule Type), selecione o item Porta (Port) e clique em Avançar (Next).
6. Na janela Protocolo e Portas (Protocol and Ports), selecione a opção TCP e, no item Portas remotas específicas
(Specific remote ports), digite o número da porta a ser liberada e clique em Avançar (Next).
7. Na janela Ação (Action), selecione o item Permitir a conexão (Allow the connection) e clique em Avançar (Next).
8. Na janela Perfil (Profile), deixe selecionadas as opções Domínio (Domain), Particular (Private) e Público (Public) e
clique em Avançar (Next).
9. Na janela Nome (Name), digite um nome e uma descrição (opcional) para a porta e clique em Concluir (Finish)
para salvar as alterações e fechar a janela.

Não consigo abrir um Elipse Power Viewer remoto pelo Internet Explorer. Por que isto está
acontecendo?
POSSÍVEIS CAUSAS
· O Elipse Power Viewer não foi instalado na máquina remota
· Existe um firewall bloqueando o acesso ao servidor
SOLUÇÃO
Pode-se instalar o Elipse Power Viewer na máquina remota ou então colocar o arquivo de instalação do Elipse
Power Viewer na pasta c:\inetpub\wwwroot do computador servidor. Assim, toda vez que se tentar abrir um Elipse
Power Viewer pelo Internet Explorer em um computador remoto onde o Elipse Power Viewer não foi previamente
instalado, a instalação é iniciada automaticamente.

Matriz Filial em São Paulo
Rua Mostardeiro, 322/Cj. 902, 1001 e 1002 Rua dos Pinheiros, 870/Cj. 141 e 142
90430-000 — Porto Alegre — RS 05422-001 — São Paulo — SP
Fone: (+55 51) 3346-4699 Fone: (+55 11) 3061-2828
Fax: (+55 51) 3222-6226 Fax: (+55 11) 3086-2338
E-mail: [email protected] E-mail: [email protected]
Filial no Paraná Filial em Minas Gerais

Av. Sete de Setembro, 4698/1708 Rua Antônio de Albuquerque, 156/705
80240-000 — Curitiba — PR 30112-010 — Belo Horizonte — MG
Fone: (+55 41) 4062-5824 Fone: (+55 31) 4062-5824
Filial no Rio de Janeiro Filial em Taiwan

Av. José Silva de A. Neto, 200/Bl. 4/Sl. 109B 9F., No.12, Beiping 2nd St., Sanmin Dist.
22775-056 — Rio de Janeiro — RJ 807 — Kaohsiung City — Taiwan
Fone Comercial: (+55 21) 2430-5912 Fone: (+886 7) 323-8468
Suporte Técnico: (+55 21) 2430-5963 Fax: (+886 7) 323-9656
Consulte nosso website para informações sobre um representante no seu estado
www.elipse.com.br
kb.elipse.com.br
forum.elipse.com.br
www.youtube.com/elipsesoftware
[email protected]
Gartner, Cool Vendors in Brazil 2014, April 2014.

Gartner does not endorse any vendor, product or service depicted in its
research publications, and does not advise technology users to select only
those vendors with the highest ratings. Gartner research publications
consist of the opinions of Gartner’s research organization and should not
be construed as statements of fact. Gartner disclaims all warranties,
expressed or implied, with respect to this research, including any warranties
of merchantability of fitness for a particular purpose.

Elipsepowermanual PTB

Enviado por

Direitos autorais:

Formatos disponíveis

Elipsepowermanual PTB

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Elipsepowermanual PTB

Enviado por

Direitos autorais:

Formatos disponíveis

Manual do Usuário do Elipse

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

1.1 Descrição Geral

1.1.2 Elipse Power Studio

1.1.3 Elipse Power Viewer

Arquitetura do Elipse Power

1.3 Diagrama de Blocos

Diagrama dos blocos que compõem o Elipse Power

1.4 Estrutura de Domínio

1.6 Estruturação de Dados

1.7 Ferramentas Elétricas

Realizar o descarte a cada Determina o intervalo, em minutos, horas, dias ou meses,

Gerar tabelas Gera a estrutura das tabelas no Banco de Dados

1.8 Limitações do Modo Demonstração

2.1 Iniciando um Projeto

Janela Iniciar o Elipse Power Studio

Criar um Domínio novo Requisita um nome e um caminho para este novo

Abrir um Domínio existente Ao clicar em Outros Arquivos, tem-se a opção de

2.2 Área de Trabalho

7 Elipse Power Studio

Elipse Power Studio 8

Comandos Mostra os itens que compõem a categoria selecionada

Descrição Breve descrição da opção selecionada

Aba Barras de Ferramentas

Aba Barras de ferramentas

9 Elipse Power Studio

Restaurar Restaura as opções padrão para o item selecionado na

Restaurar tudo Restaura as opções padrão tanto para a barra de

Renomear Muda o nome da barra de ferramentas selecionada. Esta

Remover Remove a barra de ferramentas selecionada. Esta opção

Mostrar legendas Mostra uma legenda nas opções da barra de

Restaurar Restaura o menu definido na opção anterior. Esta opção

Elipse Power Studio 10

Menus com sombra Define se um menu apresenta o efeito de sombreado ou

Office 2000 Configura a aparência do Elipse Power Studio com o

Office XP Configura a aparência do Elipse Power Studio com o

Office 2003 Configura a aparência do Elipse Power Studio com o

VS.Net 2005 Configura a aparência do Elipse Power Studio com o

Office 2007 (Prata) Configura a aparência do Elipse Power Studio com o

VS 2008 Configura a aparência do Elipse Power Studio com o

VS 2010 Configura a aparência do Elipse Power Studio com o

11 Elipse Power Studio

Incluir teclas de atalho Mostra ou não os atalhos de teclado na descrição de

Ícones grandes Habilita ícones grandes na barras de ferramentas Padrão

2.3.2 Outras Configurações

Elipse Power Studio 12

Abrir a Janela de Propriedades Abre a Janela de Propriedades de um objeto na

A aba Editor de Scripts destina-se à configuração do Editor de Scripts do Elipse Power.

13 Elipse Power Studio

Tamanho da margem Tamanho da margem da marcação do bloco de código

Numeração da linha Habilita a numeração de linha no editor de scripts

Tamanho da margem Tamanho da margem que contém a numeração de linha

Tamanho da tabulação Determina o número de espaços de tabulação

Fonte Determina o nome da fonte a ser usada no editor de

Tamanho Determina o tamanho da fonte a ser usada no editor de

Elipse Power Studio 14

2.4 Barra de Ferramentas

Abrir Projeto Abre um projeto existente (CTRL + O)

Salvar Salva um projeto (CTRL + S)