Escolar Documentos
Profissional Documentos
Cultura Documentos
I
6.2 Variáveis no Viewer ......................................................................................................................... 178
6.3 Objeto _top ....................................................................................................................................... 179
6.4 Pasta do Viewer ................................................................................................................................ 179
7 Telas e Objetos de Tela ......................................................................................................................... 181
7.1 Tela .................................................................................................................................................... 181
7.2 Barra de Ferramentas ...................................................................................................................... 183
7.3 Objetos de Tela ................................................................................................................................. 186
7.4 Configurações Gerais ....................................................................................................................... 190
7.5 Formatação de Cores ....................................................................................................................... 198
7.6 Formatação de Valores .................................................................................................................... 200
8 Associações ............................................................................................................................................ 204
8.1 Simples .............................................................................................................................................. 205
8.2 Bidirecional ....................................................................................................................................... 205
8.3 Digital ................................................................................................................................................ 206
8.4 Analógica .......................................................................................................................................... 207
8.5 Por Tabela ......................................................................................................................................... 208
8.6 Reversa .............................................................................................................................................. 209
8.7 Múltipla ............................................................................................................................................. 209
8.8 Edição de Associações ..................................................................................................................... 210
9 Bibliotecas .............................................................................................................................................. 214
9.1 Galeria ............................................................................................................................................... 214
9.2 Biblioteca do Usuário (ElipseX) ...................................................................................................... 215
9.3 Quando Criar um ElipseX ................................................................................................................ 225
10 ActiveX .................................................................................................................................................. 226
10.1 Objetos Microsoft Forms .............................................................................................................. 228
10.2 Elipse KeyPad ................................................................................................................................. 229
11 Servidor de Dados ............................................................................................................................... 231
11.1 Impressora de Linha ...................................................................................................................... 231
11.2 Pasta de Dados ............................................................................................................................... 233
11.3 Tag Contador .................................................................................................................................. 234
11.4 Tag Demo ....................................................................................................................................... 235
11.5 Tag Interno ..................................................................................................................................... 236
11.6 Tag Timer ........................................................................................................................................ 237
12 Banco de Dados ................................................................................................................................... 239
12.1 Access .............................................................................................................................................. 239
12.2 Oracle .............................................................................................................................................. 241
12.3 SQL Server ....................................................................................................................................... 244
12.4 PostgreSQL ..................................................................................................................................... 247
12.5 MySQL ............................................................................................................................................. 249
12.6 Objetos do Elipse E3 e Permissões .............................................................................................. 250
13 Consulta ................................................................................................................................................ 252
II
13.1 Criando uma Consulta ................................................................................................................... 253
13.2 Uso dos Filtros da Consulta em Scripts ....................................................................................... 260
13.3 Uso de Recordsets de uma Consulta em Scripts ........................................................................ 260
14 Consulta Hierarquia do Aplicativo ..................................................................................................... 261
14.1 Configuração .................................................................................................................................. 262
15 Alarmes ................................................................................................................................................. 265
15.1 Configuração de Alarmes ............................................................................................................. 265
15.2 Filtro de Alarmes ........................................................................................................................... 267
15.3 Fontes de Alarme ........................................................................................................................... 273
15.4 Servidor de Alarmes ...................................................................................................................... 282
16 E3Alarm ................................................................................................................................................ 292
16.1 Configurações ................................................................................................................................ 293
16.2 Características Específicas de Tempo de Execução .................................................................... 301
17 Storage .................................................................................................................................................. 308
17.1 Configurações ................................................................................................................................ 310
17.2 Configuração da Tabela ................................................................................................................ 311
17.3 Objeto Fields ................................................................................................................................... 321
17.4 Campo do Storage ......................................................................................................................... 321
18 Histórico ............................................................................................................................................... 323
18.1 Configurações ................................................................................................................................ 324
18.2 Objeto Fields ................................................................................................................................... 329
18.3 Objeto Indexes ............................................................................................................................... 331
18.4 Objeto PrimaryKey ........................................................................................................................ 332
19 E3Browser ............................................................................................................................................ 335
19.1 Objeto Consulta no E3Browser .................................................................................................... 336
19.2 Outras Configurações .................................................................................................................... 337
20 E3Chart ................................................................................................................................................. 341
20.1 Configurações ................................................................................................................................ 341
20.2 Exemplos de Utilização ................................................................................................................. 365
20.3 Características Específicas de Tempo de Execução .................................................................... 367
21 TrendAnalysis ...................................................................................................................................... 372
21.1 Aba Exibições ................................................................................................................................. 374
21.2 Aba Marcadores ............................................................................................................................. 380
21.3 Aba Conexões ................................................................................................................................. 381
21.4 Área de Exibições ........................................................................................................................... 381
21.5 Atalhos de Teclado ........................................................................................................................ 388
22 E3Playback ............................................................................................................................................ 391
22.1 Objeto E3Playback ......................................................................................................................... 391
22.2 Adicionar Playback ao Demo do Elipse E3 .................................................................................. 391
22.3 Interface de Usuário ...................................................................................................................... 394
22.4 Banco de Dados de Playback ........................................................................................................ 403
III
22.5 Configuração dos Objetos de Banco de Dados do Elipse E3 .................................................... 405
23 Fórmulas ............................................................................................................................................... 408
23.1 Configurações ................................................................................................................................ 408
23.2 Templates ....................................................................................................................................... 410
23.3 Unidades ......................................................................................................................................... 412
23.4 Conjunto de Valores ...................................................................................................................... 412
23.5 Criação de uma Fórmula ............................................................................................................... 413
24 Relatórios ............................................................................................................................................. 419
24.1 Objeto Consulta ............................................................................................................................. 420
24.2 Componentes ................................................................................................................................. 420
24.3 Configurações ................................................................................................................................ 421
24.4 Criando um Relatório no Elipse E3 .............................................................................................. 437
24.5 Exemplos de Utilização ................................................................................................................. 438
25 Segurança ............................................................................................................................................. 441
25.1 Permissões Padrão ........................................................................................................................ 442
25.2 Usuários .......................................................................................................................................... 444
25.3 Grupos ............................................................................................................................................. 453
25.4 Proteção de Arquivos .................................................................................................................... 456
26 Elipse E3 Viewer e WebViewer ........................................................................................................... 459
26.1 Viewer Only (Modo Somente Leitura) ........................................................................................ 459
26.2 Execução do Elipse E3 Viewer ....................................................................................................... 460
26.3 Logs do Elipse E3 Viewer .............................................................................................................. 463
26.4 Execução do WebViewer ............................................................................................................... 463
27 Hot-Standby ......................................................................................................................................... 467
27.1 Configurando ................................................................................................................................. 467
27.2 Executando um Domínio Redundante ........................................................................................ 468
27.3 Parando um Domínio Redundante .............................................................................................. 468
27.4 Parando um dos Servidores do Domínio .................................................................................... 469
27.5 Tempo de Troca entre Servidores ................................................................................................ 469
27.6 Reconexão de Elipse E3 Viewers .................................................................................................. 469
27.7 Utilizando Bancos de Dados com Hot-Standby ......................................................................... 469
28 Configurações Avançadas .................................................................................................................. 470
29 Biblioteca E3DataAccess ..................................................................................................................... 471
29.1 Eventos ............................................................................................................................................ 471
29.2 Métodos .......................................................................................................................................... 471
29.3 Propriedades .................................................................................................................................. 473
30 Dúvidas mais Frequentes ................................................................................................................... 475
30.1 Alarmes ........................................................................................................................................... 475
30.2 Associações .................................................................................................................................... 476
30.3 Bibliotecas ...................................................................................................................................... 477
30.4 Domínios e Projetos ...................................................................................................................... 478
IV
30.5 Domínios Remotos ........................................................................................................................ 478
30.6 Drivers de Comunicação ............................................................................................................... 481
30.7 Elipse E3 Viewer ............................................................................................................................. 482
30.8 E3Alarm .......................................................................................................................................... 483
30.9 E3Browser ....................................................................................................................................... 483
30.10 E3Chart ......................................................................................................................................... 483
30.11 Histórico ....................................................................................................................................... 483
30.12 Impressora de Linha .................................................................................................................... 483
30.13 Objetos de Tela ............................................................................................................................ 484
30.14 Ordem da Tabulação ................................................................................................................... 484
30.15 Relatórios ..................................................................................................................................... 484
30.16 Servidor de Banco de Dados Oracle .......................................................................................... 485
30.17 Servidor de Banco de Dados SQL Server ................................................................................... 486
30.18 Servidor de Dados ....................................................................................................................... 487
30.19 Sobreposição de Animações nos Objetos ................................................................................. 487
30.20 Stored Procedure ......................................................................................................................... 487
V
CAPÍTULO
Introdução
1
Desenvolvido pela Elipse Software, o Elipse E3 é uma poderosa plataforma para supervisão e controle de processos
totalmente voltada à operação em rede e aplicações distribuídas. O Elipse E3 é um sistema SCADA (Supervisory Control
and Data Acquisition) que oferece um avançado modelo de objetos, uma poderosa interface gráfica, além de uma
arquitetura que permite o rápido desenvolvimento de aplicações e máxima conectividade com dispositivos e outras
aplicações. A concepção incorpora as mais novas tecnologias em desenvolvimento de software, maximizando o
desempenho, a produtividade e a qualidade das aplicações e do próprio processo, minimizando perdas e custos.
Os sistemas construídos com o Elipse E3 geralmente partem da coleta de dados em tempo real de equipamentos de
aquisição de dados ou de controle, tais como CLPs (Controladores Lógicos Programáveis), UTRs (Unidades Terminais
Remotas), DAQs (Data Acquisition Boards ou Placas de Aquisição de Dados), controladores Multi-Loop ou Single-Loop,
centrais de incêndio e balanças, dentre outros dispositivos. Estes equipamentos normalmente possuem alguma
interface que permite a conexão ao software, tais como padrões seriais RS232, RS422 ou RS485; rádio ou modem
(linhas privadas ou discadas), TCP/IP ou UDP/IP, placas ligadas diretamente ao barramento do computador e outros.
O Elipse E3 lê e escreve dados dos equipamentos através de módulos (Drivers de Comunicação) que implementam
um protocolo, de domínio público ou privado, disponível em cada um destes equipamentos. Estes Drivers podem
ainda estar em um formato próprio da Elipse Software ou no formato OPC (OLE for Process Control).
De posse dos dados, é possível criar várias maneiras para exibir, analisar, controlar, comandar, gravar ou divulgar tais
informações, tais como:
· Telas: Permitem criar uma IHM (Interface Homem-Máquina) localmente, pela rede local ou Internet, com o intuito
de exibir o status atual ou passado dos dados em várias formas, com o auxílio de um editor gráfico e objetos
específicos
· Alarmes e Eventos: Monitoram o acontecimento de situações específicas
· Históricos: Armazenam os dados em bancos de dados relacionais
· Relatórios: Permitem visualizar e imprimir os dados, dentre outros módulos e possibilidades
Para mais informações sobre treinamentos e certificações de outros produtos da Elipse Software, tais como o Elipse
Power e o EPM, consulte a área de treinamentos ou a plataforma de ensino à distância.
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, ou standby, ou distribuir cargas de processamento entre
os computadores.
1 Introdução
editado por várias pessoas ao mesmo tempo ou que vários Elipse E3 Studios estejam conectados ao mesmo
servidor remoto, com múltiplas configurações.
1.1.4 E3 Admin
É o módulo responsável pela interface do E3 Server e de outros módulos do Elipse E3 com o usuário. Através deste
módulo 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, que
se chama Banco de Dados da Aplicaçã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 aplicações. 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 E3 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, ou 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, ou conexões, que um objeto pode criar com qualquer outro
objeto. 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 este estado de uma forma definida pelo usuário.
A estrutura do Domínio é restrita aos servidores e afins, como os computadores servidores, projetos, usuários e
senhas. A interface do cliente para operação e visualização, chamada Elipse E3 Viewer, pode se conectar diretamente
a qualquer servidor Elipse E3, com licenças suficientes de Elipse E3 Viewer. O Elipse E3 Viewer possui os seguintes
destaques especiais:
· Os projetos de uma 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 E3 Viewer no cliente, é possível utilizar a tecnologia Terminal Service. Este serviço
surgiu no Windows NT 4.0 e tem a função de 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 um servidor,
que é acessado remotamente. O Elipse E3 Viewer é executado em uma nova sessão de usuário criada no servidor,
que por sua vez transfere para o cliente os dados de vídeo e recebe de volta os eventos de mouse e teclado.
Introdução 2
Arquitetura do Elipse E3
É possível observar que, em todos os casos, o Elipse E3 Viewer continua sendo a interface de operação e
visualização. A diferença está no local de execução, que pode ser no cliente, a operação normal do Elipse E3 Viewer,
ou no servidor, com o operador fisicamente junto ao computador ou através dos Terminal Services. Com o Elipse E3
Viewer executando 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 E3 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 do cliente
quando existem poucos efeitos gráficos e visuais, além da possibilidade de operar o Elipse E3 em outros sistemas
operacionais não suportados pelo Elipse E3 Viewer, tais como Windows CE, 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 uma aplicação. Para utilizar
o protocolo RDP com múltiplos usuários, é necessário uma licença de Windows 2003 Server SP2, além do mesmo
número de Elipse E3 Viewers disponíveis no Servidor.
3 Introdução
Diagrama dos blocos que compõem o Elipse E3
Detalhadamente, o E3 Server é responsável por criar um processo de execução, ou E3Run, que efetivamente executa a
aplicação. Dentro do E3Run encontram-se outros servidores, que expõem serviços utilizados por outros módulos.
Introdução 4
· 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 E3 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 E3 Studio
5 Introdução
CAPÍTULO
Elipse E3 Studio
2
O Elipse E3 Studio é o ambiente de desenvolvimento do Elipse E3. Neste ambiente é possível criar e manter
Domínios, projetos e bibliotecas.
Para iniciar uma aplicação no Elipse E3 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
o computador deve estar na mesma rede local que outra com um E3 Server já previamente instalado, e com um
dispositivo de proteção presente.
Elipse E3 Studio 6
Área de trabalho do Elipse E3 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 E3.
A Área de Trabalho é onde os Editores são mostrados.
2.3 Configuração
O Elipse E3 permite personalizar alguns recursos do Elipse E3 Studio, tais como barras de ferramentas, teclado,
menus e mouse, entre outros.
2.3.1 Aparência
Para personalizar a aparência do Elipse E3 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.
7 Elipse E3 Studio
Aba Comandos
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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
E3 Studio
Elipse E3 Studio 8
Opções disponíveis na aba Barras de ferramentas
OPÇÃO DESCRIÇÃO
Barras de ferramentas Lista as barras de ferramentas disponíveis
Nova Cria uma nova barra de ferramentas. Esta opção não tem
efeito e é mantida no Elipse E3 por questões de
compatibilidade
Aba Menus
Esta aba configura os menus do Elipse E3.
Aba Menus
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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 E3 por questão de
compatibilidade
9 Elipse E3 Studio
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 E3),
Desdobrar, Deslizar, Fade ou [Default] (padrão do
Windows)
Aba Aparência
Esta aba altera a aparência das janelas e barras de ferramentas no Elipse E3 Studio.
Aba Aparência
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Aparência
OPÇÃO DESCRIÇÃO
Windows Nativo Configura a aparência do Elipse E3 Studio com o estilo
usado no esquema de cores do Windows atualmente
instalado
Elipse E3 Studio 10
OPÇÃO DESCRIÇÃO
Office 2010 (Prata) Configura a aparência do Elipse E3 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
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Opções
OPÇÃO DESCRIÇÃO
Mostrar descrições Habilita o Elipse E3 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
11 Elipse E3 Studio
Aba Geral
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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
Mostrar botão de fechar na aba ativa Permite fechar a aba ativa ao clicar no 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
Elipse E3 Studio 12
Aba Editor de Scripts
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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
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).
13 Elipse E3 Studio
Aba Arquivos
Toda vez que um projeto ou uma biblioteca é criado, o Elipse E3 grava internamente um código CRC dos dados deste
arquivo. Cada vez que um arquivo é aberto, é realizada 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 E3 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.
Elipse E3 Studio 14
COMANDO AÇÃO
Registrar Bibliotecas Registra todas as bibliotecas carregadas (CTRL + SHIFT
+ L)
Executar ou Parar Domínio Inicia ou para a execução do Domínio atual (SHIFT + F9)
Executar ou Parar Elipse E3 Viewer Executa ou para a execução do Elipse E3 Viewer atual
(CTRL + F9)
15 Elipse E3 Studio
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 .
Contar Filhos de Instâncias de ElipseXs Inclui na contagem os filhos internos das instâncias de
um XControl, XFolder ou XObject
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.
Elipse E3 Studio 16
Janela Criar Pacote de Bibliotecas
As opções disponíveis nesta janela estão descritas na tabela a seguir.
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
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.
17 Elipse E3 Studio
· 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 dos 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.
Elipse E3 Studio 18
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)
19 Elipse E3 Studio
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
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 na opção 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 na opção 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.
Elipse E3 Studio 20
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 E3
21 Elipse E3 Studio
Janela Procurar
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Procurar
OPÇÃO DESCRIÇÃO
Procurar por Texto a ser procurado
Diferenciar maiúsculas de minúsculas Procura pelo texto especificado exatamente como foi
escrito, diferenciando maiúsculas de minúsculas
Incluir Dados das Fórmulas Inclui na procura os dados no banco de dados das
Fórmulas
Elipse E3 Studio 22
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
Apenas Fontes Procura pelo texto especificado apenas nas fontes das
Associações dos objetos
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"
NOTAS
· O Elipse E3 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.
23 Elipse E3 Studio
Janela Resultados de Procura 1
As opções disponíveis nesta janela estão descritas na tabela a seguir.
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)
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 E3 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.
Elipse E3 Studio 24
Janela Substituir
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Substituir
OPÇÃO DESCRIÇÃO
Procurar por Texto a ser procurado para substituição
Diferenciar maiúsculas de minúsculas Realiza a substituição pelo texto exatamente como foi
escrito, diferenciando maiúsculas de minúsculas
25 Elipse E3 Studio
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
Incluir Dados das Fórmulas Inclui na substituição os dados no banco de dados das
Fórmulas
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.
Elipse E3 Studio 26
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
Relatório de versões
As opções desta caixa de diálogo são mostradas na tabela a seguir.
27 Elipse E3 Studio
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
NOTA
Estes campos são apenas para visualização, não é permitida a edição.
Mostra a janela de informações Mostra uma janela com informações detalhadas do erro
selecionado
Elipse E3 Studio 28
OPÇÃO DESCRIÇÃO
Executa a verificação Executa o processo de verificação no Domínio atual ou
no objeto selecionado no Organizer
29 Elipse E3 Studio
Objeto com erros selecionado no Organizer
A ferramenta Verificação de Domínio está disponível no menu Ferramentas do Elipse E3 Studio e também no menu
contextual dos objetos do Organizer. Neste caso, a verificação é realizada no objeto selecionado e nos 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 E3 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
As opções disponíveis nesta janela estão descritas na tabela a seguir.
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
Elipse E3 Studio 30
OPÇÃO DESCRIÇÃO
Remover Remove a linha selecionada da lista de objetos da janela
WatchWindow
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.
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
31 Elipse E3 Studio
ATALHO DE TECLADO DESCRIÇÃO
CTRL + Roda do mouse Aumenta ou diminui o zoom. Este atalho de teclado
também funciona em tempo de execução
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
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
Elipse E3 Studio 32
ATALHO DE TECLADO DESCRIÇÃO
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 + ALT + Tecla de seta para baixo Aumenta o tamanho do objeto selecionado
verticalmente para baixo em um passo dez vezes mais
rápido
CTRL + ALT + Tecla de seta à esquerda Move a Tela selecionada para a direita em um passo
dez vezes mais rápido
ALT + Tecla de seta à direita Move o objeto selecionado para a direita em um passo
dez vezes mais rápido
CTRL + ALT + Tecla de seta à direita Move a Tela selecionada para a esquerda em um passo
dez vezes mais rápido
33 Elipse E3 Studio
ATALHO DE TECLADO DESCRIÇÃO
CTRL + SHIFT + P Abre ou move o foco do teclado para a Lista de
Propriedades
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
CTRL + Sinal de mais (+) Cria um novo script no objeto e evento selecionado
Elipse E3 Studio 34
ATALHO DE TECLADO DESCRIÇÃO
F7 Compila o script 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 os 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.
35 Elipse E3 Studio
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 E3 estão nos grupos Visualização e Objetos de Servidor. Em Visualização estão os
objetos que executam no cliente. Já os objetos executados no servidor estão em Objetos de Servidor.
O modo Explorer mostra projetos, bibliotecas e pacotes de bibliotecas abertos no Elipse E3 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, no
respectivo modo.
Ao clicar em um objeto com o botão esquerdo do mouse, as 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
Elipse E3 Studio 36
OPÇÃO DESCRIÇÃO
Salvar Como Abre uma caixa de diálogo para que um projeto ou
biblioteca sejam salvos no local indicado
37 Elipse E3 Studio
OPÇÃO DESCRIÇÃO
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
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
Elipse E3 Studio 38
OPÇÃO DESCRIÇÃO
Desfragmentar Todos os Arquivos Desfragmenta todos os arquivos do grupo Arquivos,
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 dos arquivos, tamanho
desfragmentado e percentual de compactação
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 .
Resultado da desfragmentação de um
arquivo
Ao selecionar a opção Desfragmentar Todos os Arquivos no menu contextual do grupo Arquivos, a janela da figura
a seguir é mostrada ao final do processo de desfragmentação.
39 Elipse E3 Studio
Resultado da desfragmentação de todos os arquivos
Clique em Detalhes para visualizar detalhes de cada arquivo desfragmentado, conforme a figura a seguir.
Qualquer objeto do Elipse E3 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.
Elipse E3 Studio 40
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 E3. 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.
41 Elipse E3 Studio
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 E3, selecione um objeto IODriver e importe o arquivo criado através da
opção Importar, selecionando o modelo adequado. O Elipse E3 cria a estrutura de acordo com o arquivo CSV.
2.7.2 Objetos
A importação ou a exportação de objetos no Elipse E3 pode ser realizada a partir de qualquer tipo de objeto, exceto
projetos e bibliotecas. A operação a partir do objeto raiz é realizada sobre as propriedades e os 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.
Elipse E3 Studio 42
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 dos 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.
ObjectType;Name;Prop1;Prop2;Prop3
IODriver;;0;True;0
IOBlock;Bloco1;0;False;0
43 Elipse E3 Studio
IOBlockElement;Bloco1.Elemento1;0;False;0
IOBlockElement;Bloco1.Elemento2;0;False;0
IOBlock;Bloco2;0;False;0
IOBlockElement;Bloco2.Elemento1;0;False;0
IOTag;Tag1,0,True,0
Se desejar, o 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.
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.
Elipse E3 Studio 44
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 ou se as Associações dos objetos devem ou não ser
exportadas, entre outras configurações. 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
O formato é um texto facilmente modificável pelo usuário, e é 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 E3 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 é realizado 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 E3, 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
45 Elipse E3 Studio
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 seja 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
Elipse E3 Studio 46
SEÇÃO DESCRIÇÃO
collectionduplicated Define qual o procedimento quando uma coleção pré-
existente está sendo importada. 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 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
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 de dados. 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
47 Elipse E3 Studio
[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 E3.
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 é nomeada por um identificador, este deve estar definido na
seção Columns ou a coluna é ignorada.
Aba Configurações
Elipse E3 Studio 48
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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: Seleciona 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: Seleciona outro caractere
definido pelo usuário como separador de colunas
49 Elipse E3 Studio
Aba Importação
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Importação
OPÇÃO DESCRIÇÃO
Importação de objetos duplicados Especifica como o Elipse E3 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 E3 deve lidar com a ocorrência
de Associações duplicadas na importação. As opções
disponíveis são Questionar sobre o que fazer 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 E3 deve lidar com a ocorrência
de coleções duplicadas na importação. As opções
disponíveis são Questionar sobre o que fazer em cada
caso, Sempre sobrescrever a coleção existente ou
Sempre ignorar a coleção duplicada
Elipse E3 Studio 50
OPÇÃO DESCRIÇÃO
Importação de itens de coleção duplicados Especifica como o Elipse E3 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
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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
51 Elipse E3 Studio
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.
Aba Identificadores
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Elipse E3 Studio 52
Opções disponíveis na aba Identificadores
OPÇÃO DESCRIÇÃO
Nome da Classe Indica o nome da classe selecionada na opção
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
As opções disponíveis nesta aba estão descritas na tabela a seguir.
53 Elipse E3 Studio
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
Ao clicar em , abre-se uma janela para a seleção de propriedades, mostrada na figura a seguir.
Janela Propriedades
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Elipse E3 Studio 54
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
Listar todas as classes de objetos do Elipse E3 Se esta opção está selecionada, a caixa de seleção de
objetos mostra todas as classes existentes no Elipse E3,
independente de filtro ou objeto raiz
As propriedades em negrito nesta lista já foram inseridas na lista que define as colunas do arquivo CSV. Um duplo-
clique sobre uma propriedade adiciona ou remove esta propriedade, dependendo se 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. Estas propriedades são exportadas com o nome da propriedade principal, de acordo
com o objeto, seguido do nome da propriedade interna, separados por um ponto, como por exemplo
TextFont.Bold. No configurador de modelos, as propriedades internas aparecem separadas para o usuário, para que
a escolha possa ser realizada isoladamente.
55 Elipse E3 Studio
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.
Para executar a importação dos Tags OPC no Elipse E3 3.0 ou superior, 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.
Elipse E3 Studio 56
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
importação da configuração de alarmes no Elipse E3.
Para executar a importação dos Tags no Elipse E3, 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.
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.
57 Elipse E3 Studio
Janela de importação de Tags do Elipse SCADA
Elipse E3 Studio 58
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
importação da configuração de alarmes no Elipse E3.
Para executar a importação dos Tags no Elipse E3, 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.
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.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.
2. Clique em Exportar.
59 Elipse E3 Studio
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.
6. Na lista de tipos de arquivos, selecione a opção Arquivos do Elipse SCADA (*.e2f) e a seguir selecione o arquivo
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 E3. É 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 diretórios originais. O
Elipse E3 procura estes arquivos no mesmo diretório onde são encontrados pela aplicação do Elipse SCADA
NOTA
Recomenda-se inserir todos os arquivos no projeto como Recursos, para que o Elipse E3 Viewer possa executar o
download automaticamente pela rede. Isto evita a necessidade de instalar os arquivos manualmente nos clientes.
2.7.6 Associações
Para a importação ou a exportação de Associações no Elipse E3, 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
Elipse E3 Studio 60
· 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 das propriedades. 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 de nome inválido. Se é um índice inexistente, como por exemplo se 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.
No nome do objeto deve ser informado o caminho completo, no formato Objeto.Collection.Name, como no
exemplo a seguir.
61 Elipse E3 Studio
E3Chart1.Pens.Pena1
Elipse E3 Studio 62
Lista de Propriedades ordenada alfabeticamente
A Lista de Propriedades da figura a seguir mostra o objeto anterior com as propriedades ordenadas por categoria.
63 Elipse E3 Studio
NOTA
No caso de seleção múltipla de objetos, a Lista de Propriedades mostra apenas as propriedades comuns aos
objetos selecionados, com os 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
Pode-se configurar o valor de uma propriedade digitando diretamente na respectiva coluna Valor. À direita do nome
da propriedade existe um ícone que indica o estado atual. O ícone indica que o valor da propriedade é o padrão,
ou seja, o valor não foi modificado pelo usuário, e o ícone indica que o valor da propriedade foi modificado pelo
usuário. Neste caso, 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 o valor
padrão, caso tenha sido modificado pelo usuário
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).
Elipse E3 Studio 64
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 E3 que podem ser utilizados para compor o texto que é
o resultado do uso do AppBrowser. De acordo com o 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.
65 Elipse E3 Studio
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.
Elipse E3 Studio 66
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.
67 Elipse E3 Studio
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 E3 Studio a um servidor. Esta opção permite
configurar em qual servidor de Domínio o Elipse E3 Studio deve se conectar, e permite também informar se o Elipse
E3 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
Elipse E3 Studio 68
OPÇÃO DESCRIÇÃO
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 cair, Domínio ou de licença, o Elipse E3 Studio é desconectado do
outro servidor. A última configuração é guardada no Registro do Windows e, da próxima vez em que o Elipse E3
Studio é aberto, este se conecta aos servidores de Domínio e de licenças utilizados da última vez.
Se o servidor de licenças não está disponível, ou se não há mais licenças disponíveis, então o Elipse E3 Studio
permanece em modo Demo. Um Elipse E3 Studio sem licença, em 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 E3 Studio, Licença no servidor local ou Licença em <Nome_Servidor>.
Ao especificar 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 E3 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 E3 Studio
em uso naquele servidor.
Se o servidor de Domínio não possui uma licença, e um Elipse E3 Studio se conecta a este servidor usando a licença
de outro, então o servidor de Domínio passa temporariamente de modo Demo para modo Elipse E3 Studio,
voltando para o modo Demo assim que a sessão do Elipse E3 Studio é fechada.
NOTA
Quando o Elipse E3 Studio está utilizando uma licença emprestada de outro servidor, este deve forçosamente
permanecer aberto enquanto a aplicação está em execução. Se é fechado enquanto a aplicação está executando, a
licença de Elipse E3 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 conecta 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\projeto.dom. Desta forma, o
Elipse E3 Studio e o E3 Server remoto podem acessar os arquivos utilizando o mesmo caminho.
69 Elipse E3 Studio
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 E3 é 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 E3, 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 E3 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 E3
· Iniciar, parar ou monitorar o processo de tempo de execução, ou 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 os modos de 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 E3, 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 E3 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
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
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 estão listadas na tabela a seguir.
Opções de linha de comando do E3 Admin
OPÇÃO DESCRIÇÃO
-close ou /close Para e fecha o Domínio em execução, quando existir. Esta
opção deve ser utilizada sozinha
71 Domínios
OPÇÃO DESCRIÇÃO
-viewer ou /viewer Executa o Elipse E3 Viewer para a aplicação
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 E3.
3.4 E3IoServer
O E3IoServer é o processo responsável pela execução dos Drivers de Comunicação. Os Servidores de I/O são
criados, mantidos e monitorados pelo processo E3Run.
Domínios 72
3.5 Elipse E3 Studio
O Elipse E3 Studio é o ambiente de desenvolvimento e configuração de aplicações. Permite abrir e editar arquivos
.prj ou .lib. O Elipse E3 Studio é multi-usuário, isto é, vários Elipse E3 Studios podem modificar os mesmos arquivos
ao mesmo tempo. O Elipse E3 Studio utiliza uma conexão REC para se comunicar com o E3 Server.
3.7 Componentes
Um Domínio é constituído dos arquivos descritos nas seções seguintes.
73 Domínios
Criando um novo Domínio
A seguir, o usuário deve decidir se deseja incluir projetos ou bibliotecas abertos no novo Domínio criado.
Uma vez que o Assistente tenha sido acessado, a tela inicial é aberta. Para continuar, clique em Avançar.
Domínios 74
Tela inicial do Assistente de Aplicações
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 Elipse 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.
75 Domínios
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.
NOTA
A opção Biblioteca de componentes do Elipse 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.
Domínios 76
Opções de Domínio
Clique em Avançar para prosseguir.
77 Domínios
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 .
Domínios 78
Clique em Avançar para prosseguir.
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.
79 Domínios
3.9 Configurações
Através do menu do E3 Admin na Área de Notificações do Windows, é possível atualizar, executar, parar ou fechar um
Domínio diretamente através das opções Atualizar , Executar , Parar e Fechar , respectivamente.
Além disto, um 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 .
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.
Domínios 80
Aba Domínios Remotos
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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
81 Domínios
OPÇÃO DESCRIÇÃO
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 do computador onde o Domínio está executando para que tudo funcione
localmente. Neste caso, para que a configuração funcione no Elipse E3 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
está em execução, Links já resolvidos como locais continuam sempre locais, mesmo que o alias seja reconfigurado
para conectar em um computador remoto 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
Domínios 82
Aba Grupos de Viewers
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Grupos de Viewers
OPÇÃO DESCRIÇÃO
Nome Lista os nomes de todos os grupos de Elipse E3 Viewers
Permitir conexões de Viewer Control Quando selecionada, permite conexões do tipo Viewer
Control para o grupo
83 Domínios
OPÇÃO DESCRIÇÃO
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
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 E3 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 E3 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 E3 Viewers tem sempre uma limitação de licenças adicional a ser aplicada na
conexão do Elipse E3 Viewer.
A configuração de grupos de Elipse E3 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 E3 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 E3 Viewers é o seguinte:
· Se o grupo de Elipse E3 Viewers não permitir conexões do tipo Viewer Control nem do tipo Viewer Only, a
conexão é negada
· Se o grupo de Elipse E3 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 E3 Viewers permitir apenas conexões do tipo Viewer Only, a conexão é permitida e
somente de leitura, mesmo para acessos do tipo Viewer Control
Domínios 84
Aba Hot-Standby
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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
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 pela própria aplicação
através do método Application.ReportFailure. A troca de
servidores só é executada se o servidor de backup está
sem falhas
85 Domínios
OPÇÃO DESCRIÇÃO
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. Esta opção permite que vários endereços de
rede sejam registrados. As opções disponíveis 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 nesta
opção 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
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 E3 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
Domínios 86
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.
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, arquivos .dom, .prj e .lib, e a
mesma árvore de diretórios.
87 Domínios
Aba Penas Automáticas
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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,
no formato opc.tcp://[servidor]:[porta]
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
Domínios 88
OPÇÃO DESCRIÇÃO
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
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
NOTA
Ao clicar em Aplicar, as alterações realizadas nesta aba são aplicadas na próxima vez que o Domínio é executado.
Caso o Domínio já esteja em execução, as alterações são aplicadas imediatamente, não há necessidade de parar o
Domínio atual e reiniciá-lo.
89 Domínios
Aba Projetos
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Projetos
OPÇÃO DESCRIÇÃO
Nome Esta opção lista os nomes dos projetos no sistema
Domínios 90
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 o item Habilitado na opção 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.
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.
91 Domínios
Opções disponíveis no grupo Pool de Processos IOServer
OPÇÃO DESCRIÇÃO
Pool habilitado Habilita ou desabilita o pool de processos de Servidores
de I/O. 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
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 E3 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 do Servidor de I/O no capítulo Drivers.
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
Servidor de I/O
Domínios 92
OPÇÃO DESCRIÇÃO
Balões do servidor Habilita ou desabilita a exibição de uma janela com
avisos ativos do E3 Server no Elipse E3 Viewer, como
por exemplo problemas na licença. Esta janela pode ser
fechada ou minimizada, mas é aberta periodicamente
enquanto houver avisos ativos
Usar provedor OLE DB Oracle por padrão Habilita ou desabilita o uso do provedor OLE DB Oracle
por padrão em novos objetos de Bancos de Dados. Se
esta opção é alterada enquanto o Domínio está em uso
no Elipse E3 Studio, é preciso fechar e abrir novamente
este Domínio para que esta alteração tenha efeito. Em
tempo de execução, é necessário executar o Domínio
novamente para que esta alteração tenha efeito
93 Domínios
Eventos Manuais são eventos definidos por uma aplicação. Estes eventos são gerados em scripts criados por
usuários, através da chamada ao método Application.TrackEvent. Estes eventos podem ser gerados tanto no Elipse E3
Viewer quanto no E3Run.
O Elipse E3 Viewer é apenas um gerador de eventos manuais. Utilize o método Application.TrackEvent para enviar um
evento para o E3 Server.
O diagrama a seguir mostra como os diferentes processos do Elipse E3 geram e tratam eventos de sistema.
Diagrama de processos
Cada E3 Server mantém uma lista interna dos eventos que devem ser registrados em um banco de dados. Estes
eventos podem vir das seguintes fontes:
· Eventos gerados por Elipse E3 Viewers usando o método Application.TrackEvent
· Eventos gerados internamente por um E3 Server
· Eventos gerados por um E3 Server em modo 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 em um banco de dados. Os eventos são colocados na fila de eventos do E3 Server Hot,
juntamente com os demais eventos do sistema, isto é, o E3 Server 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 E3 Server Hot.
O E3Run grava em um banco de dados os registros enviados pelo E3 Server Hot. O E3 Server informa o nome do
Banco de Dados e da tabela onde os dados são gravados.
Para configurar o registro de eventos do Elipse E3, 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 94
Aba Registro de Eventos
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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 E3. Ao selecionar
Banco de Dados do aplicativo esta opção, a opção Nome da tabela deve ser
obrigatoriamente preenchida
Selecionar automaticamente um Banco de Dados no Habilite esta opção para deixar que o E3Run selecione
aplicativo um objeto Banco de Dados para gravar os dados. Se
uma aplicação possui apenas um Banco de Dados, este
objeto é usado. Se possuir mais de um Banco de Dados,
recomenda-se selecionar a opção Usar este Banco de
Dados
95 Domínios
OPÇÃO DESCRIÇÃO
Usar este Banco de Dados Habilite esta opção para especificar o Banco de Dados
onde são gravados os eventos. Se o nome do Banco de
Dados foi informado incorretamente, os eventos
permanecem armazenados na fila de eventos do E3
Server, em memória, até que seja indicado um Banco de
Dados válido
Marque abaixo os eventos que devem ser registrados Lista os eventos disponíveis no sistema para serem
registrados
Se o E3Run tem que selecionar entre vários Bancos 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 desabilita o projeto que contém o
Banco de Dados que estava sendo usado para gravar eventos, o E3Run automaticamente seleciona outro Banco de
Dados que esteja disponível na aplicação e continua com este Banco de Dados até que o Banco de Dados anterior
seja reativado. Isto implica que, se houver mais de um Banco de Dados em um projeto, é possível que alguns eventos
sejam gravados em um Banco de Dados e outros eventos em outro Banco de Dados. Por isto recomenda-se indicar
um Banco de Dados específico quando houver mais de um Banco de Dados em um projeto.
Ao selecionar um evento na lista e pressionar a tecla F2, abre-se uma caixa de diálogo para edição de um evento,
mostrada na figura a seguir.
Domínios 96
Visualização das macros disponíveis para o evento selecionado
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 de um usuário ou grupo afetado por um evento
· %NEWNAME%: Insere o novo nome do usuário ou grupo 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
· %SESSION%: Insere o nome da aplicação onde o usuário estava logado, ou seja, Elipse E3 Viewer, Elipse E3
Studio ou E3 Server
· %CAUSE%: Informação adicional sobre um evento
Por exemplo, se a mensagem do evento Falha de Login é alterada para o texto a seguir:
"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 E3 Viewer que está executando
no computador CLIENT004, o seguinte evento é gerado:
"Falhou login do usuário Admin no computador CLIENT004 (usando um Viewer): login ou senha
incorretos"
97 Domínios
3.9.7.3 Troca de Senha
A senha do usuário '%USER%' foi alterada na máquina '%MACHINE%'
Mensagem gerada sempre que um usuário troca de senha utilizando o método ChangePassword no Elipse E3 Viewer.
As macros disponíveis nesta mensagem são:
· %USER% contém o nome do usuário cuja senha foi trocada
· %MACHINE% contém o nome do computador onde a senha deste usuário foi trocada
Domínios 98
3.9.7.9 Domínio Atualizado
Domínio atualizado pelo usuário '%USER%' no %SESSION% na máquina '%MACHINE%'
Mensagem gerada sempre que um Domínio é atualizado ao clicar em Executar Aplicativo no Elipse E3 Studio, isto
é, quando são aplicadas no E3Run as alterações realizadas em arquivos de projeto e bibliotecas. As macros
disponíveis nesta mensagem são:
· %USER% contém o nome do usuário que efetuou um login no Elipse E3 Studio, ou "Anônimo" se não havia
nenhum usuário logado
· %SESSION% contém "Studio"
· %MACHINE% contém o nome do computador onde o Elipse E3 Studio estava executando
99 Domínios
3.9.7.15 Usuário Renomeado
O usuário '%NAME%' foi renomeado para '%NEWNAME%' por '%USER%' na máquina '%MACHINE
%'
Mensagem gerada sempre que um usuário é renomeado. As macros disponíveis para esta mensagem são:
· %NAME% contém o nome do usuário que foi renomeado
· %NEWNAME% contém o novo nome de usuário
· %USER% contém o nome do usuário que executou esta operação
· %MACHINE% contém o nome do computador onde este usuário foi renomeado
Domínios 100
3.9.7.21 Diretivas de Grupo
Os direitos do grupo '%NAME%' foram modificados por '%USER%' na máquina '%MACHINE%'
Mensagem gerada sempre que os direitos de um grupo são modificados. As macros disponíveis para esta mensagem
são:
· %NAME% contém o nome do grupo cujos direitos foram modificados
· %USER% contém o nome do usuário que executou esta operação
· %MACHINE% contém o nome do computador onde os direitos deste grupo foram modificados
101 Domínios
EVENTO MENSAGEM PADRÃO EXEMPLO DE %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
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'
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'
Domínios 102
OPÇÃO TIPO DE DADOS EXEMPLO DE MENSAGEM
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'
NOTA
Ao alterar a senha de um usuário no Elipse E3 Studio, usando o item Usuários da janela Usuários e Grupos 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' na máquina 'nomemaquina'. 'A senha do usuário foi alterada'".
Expiração de senha Booleano e Inteiro 'Tempo (em dias) até que a senha
expire' modificado de 'Padrão' para
'1'
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'
103 Domínios
OPÇÃO TIPO DE DADOS EXEMPLO DE MENSAGEM
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'
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.
Usar este Banco de Dados Booleano e String 'Usar este Banco de Dados'
modificado de 'DB1' para 'DB2'
Domínios 104
OPÇÃO TIPO DE DADOS EXEMPLO DE MENSAGEM
Caracteres maiúsculos e minúsculos Booleano 'A senha deve conter letras
maiúsculas e minúsculas' modificado
de 'Desabilitado' para 'Habilitado'
Expiração de senha Booleano e Inteiro 'Tempo (em dias) até que a senha
expire' modificado de 'Desabilitado'
para '1'
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
'Desabilitado' para '1'
Aviso de expiração de senha Booleano e Inteiro 'Tempo (em dias) para avisar o
usuário antes que a senha expire'
modificado de 'Desabilitado' para '1'
105 Domínios
Aba Segurança
O grupo Segurança contém as opções descritas na tabela a seguir.
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
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
Domínios 106
OPÇÃO DESCRIÇÃO
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
107 Domínios
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 da aba Segurança não se aplicam aos usuários do Windows, apenas aos usuários do Domínio do Elipse
E3.
NOTA
O Servidor OPC UA só está disponível nas versões 64 bits do Elipse E3.
Domínios 108
Aba Servidor OPC UA
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Servidor OPC UA
OPÇÃO DESCRIÇÃO
Habilitar servidor OPC UA Habilita ou desabilita o Servidor OPC UA
Opção padrão para exposição de objetos ao servidor Define como objetos ElipseX são expostos em um
OPC UA Servidor OPC UA. Os valores possíveis para estão opção
são eeExpose: Expõe objetos ElipseX para leitura e
escrita, eeExposeAsReadOnly: Expõe objetos ElipseX
somente para leitura (padrão) ou eeDontExpose: Não
expõe objetos ElipseX
Porta utilizada no ponto de conexão Número da porta TCP/IP para conexão de Clientes OPC
UA ao Servidor OPC UA. O valor padrão desta opção é
48010
URL para conexão de clientes OPC UA Mostra um exemplo da URL usada por Clientes OPC UA
para conexão com o Servidor OPC UA
109 Domínios
OPÇÃO DESCRIÇÃO
Segurança dos Pontos de Conexão Permite selecionar um ou mais políticas de segurança
para conexão ao Servidor OPC UA. Por padrão, as
opções Basic256Sha256, Aes128Sha256RsaOaep e
Aes256Sha256RsaPss são selecionadas. Para cada uma
destas políticas de segurança, estão disponíveis os
modos de segurança Sign (padrão), SignAndEncrypt ou
Sign + SignAndEncrypt. As políticas de segurança
Basic256 e Basic128Rsa15 foram descontinuadas e não
devem ser utilizadas, são mantidas apenas por questões
de compatibilidade. Selecionar a opção Nenhum permite
que qualquer Cliente OPC UA acesse o Servidor OPC UA,
sem restrições
Aba Servidores
Domínios 110
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Servidores
OPÇÃO DESCRIÇÃO
Nome Lista com os nomes dos servidores no sistema
Identificação do servidor na rede Digite o nome do servidor na rede. Deve ser o nome do
computador com ou sem as barras duplas invertidas no
início, como por exemplo \\server ou server
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
111 Domínios
Janela Exportação de Usuários
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 aba Permissões.
· 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 E3 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 E3 Studio
· E3 Tweak
· Elipse E3 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 E3. Para mais informações sobre esta aplicação, consulte o Manual do Usuário do Elipse Event Log.
Se já há um Domínio executando localmente, o item Elipse E3 Viewer deste menu abre um Elipse E3 Viewer para
o Domínio local. Do contrário, ou se a tecla SHIFT está pressionada, abre-se a janela inicial do Elipse E3 Viewer, onde
é possível selecionar o servidor e outras opções, como descrito no tópico Elipse E3 Viewer e WebViewer - Execução
do Elipse E3 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.
Domínios 112
Janela E3 Admin - Licenças
As opções disponíveis nesta janela estão descritas na tabela a seguir.
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
113 Domínios
OPÇÃO DESCRIÇÃO
Tags do Storage Indica o número de Tags do Storage
Para mais informações sobre as limitações do modo Demo do Elipse E3, consulte o tópico Limitações do Modo
Demonstração.
NOTAS
· 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 E3 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.
· Se o tempo de expiração de dispositivos de proteção do tipo Softkey ou Hardkey com TimeHASP é menor do
que quarenta e oito horas, o E3 Admin passa a mostrar mensagens de expiração na Área de Notificações do
Windows a cada hora, e quando o tempo de expiração é menor do que vinte e quatro horas, o E3 Admin passa a
mostrar mensagens de expiração na Área de Notificações do Windows a cada minuto.
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 .
Domínios 114
OPÇÃO DESCRIÇÃO
Computador Mostra o nome do computador conectado ao E3 Server
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 .
115 Domínios
OPÇÃO DESCRIÇÃO
Relógio Mostra a hora local do servidor
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.
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.
Domínios 116
Janela E3 Admin - Impressora
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela E3 Admin - Impressora
OPÇÃO DESCRIÇÃO
Nome da impressora Lista o nome das impressoras disponíveis
117 Domínios
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.
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.
Domínios 118
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.
119 Domínios
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. A 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
Domínios 120
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, que corresponde ao
comportamento das versões anteriores à versão 3.2
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 E3 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 no computador Cliente, e digitar o caminho desta cópia
no campo Arquivo de Domínio. Desta forma, o Elipse E3 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 E3. Não é possível, por exemplo, conectar-se a um Domínio que esteja executando a versão
2.5 do Elipse E3.
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 E3, consulte o tópico Limitações do Modo
Demonstração.
121 Domínios
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 E3 Viewer quanto do Servidor.
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 Associações ou o
método 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 Associações, 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
Domínios 122
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 ganhar acesso aos objetos remotos. Isto é
realizado através da permissão Acesso remoto ao Domínio, também no item Domínio da aba Permissões de um
usuário.
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 é 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 Domínio utilizando um usuário anônimo.
3.11.5 Hot-Standby
A conexão remota a um Domínio suporta Domínios com Hot-Standby nativamente. Para isto, apenas especifique os
nomes dos servidores, principal e backup, nos itens respectivos do grupo Servidores e opções de conexão 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 enquanto o Domínio Cliente está em execução, este se
desconecta e reinicia a conexão com os novos servidores.
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 ocorre, 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 é resolvido, os Links devem conectar-se automaticamente. Já os comandos de
Application.GetObject devem ser executados novamente.
123 Domínios
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 124
CAPÍTULO
Drivers
4
O Elipse E3 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.
Drivers 126
OPÇÃO DESCRIÇÃO
Configurar o Driver Abre a janela de configurações extras do Driver de
Comunicação
NOTAS
· A opção Ativar 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.
4.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.
127 Drivers
4.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 .
4.1.2 Funcionamento
O E3IoServer é o módulo do Elipse E3 responsável pela comunicação com um equipamento. É no processo do
Servidor de I/O 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 no objeto. Estes objetos são discutidos nos tópicos seguintes.
Por padrão, o Elipse E3 cria um Servidor de I/O para cada Driver de Comunicação em tempo de execução. Baseado
no tempo de varredura, a propriedade Scan de cada Tag de Comunicação, 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 Servidor de I/O 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 E3 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 Servidor de I/O, o Elipse E3 automaticamente realiza uma reinicialização daquele módulo, de
forma a normalizar o funcionamento. Por outro lado, o Servidor de I/O 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 Servidor de I/O 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 Servidor de I/O 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 de um Driver de Comunicação,
denominada Gerenciador de Drivers, no menu contextual do E3 Admin na Área de Notificações do Windows, na
opção Servidor - Drivers .
Drivers 128
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.
129 Drivers
OPÇÃO DESCRIÇÃO
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
Drivers 130
Tabela com três eventos e apenas um campo de dados
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.
131 Drivers
4.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 0 (zero), e sem
banda morta, ou seja, com a propriedade DeadBand igual a 0 (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.
Drivers 132
DRIVERS POR PROCESSO NÚMERO MÁXIMO DE PROCESSOS COMPORTAMENTO DO POOL
N M À medida que os Drivers da aplicação
são ativados, o Elipse E3 os adiciona
a um processo de Servidor de I/O 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 da aplicação exceda N × M
NOTAS
· Ao agrupar Drivers em um mesmo processo de Servidor de I/O, perde-se o isolamento entre estes Drivers. Desta
forma, se ocorrer uma falha em um destes Drivers, o Servidor de I/O é fechado e todos os Drivers que executavam
naquele Servidor de I/O têm de ser reiniciados.
· Existe um limite no número de Drivers que podem executar em um processo de Servidor de I/O. 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 Servidor de I/O, sob pena de exceder os limites do sistema operacional.
133 Drivers
Inserindo uma Pasta de Comunicação
Drivers 134
Inserindo um Tag de Comunicação
2. A janela da figura a seguir é mostrada, perguntando quantos Tags 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 Tags
de Comunicação são criados com um nome padrão.
135 Drivers
4.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.
Drivers 136
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.
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 mais informações, consulte o Manual de Referência e Scripts do Elipse
E3.
137 Drivers
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 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 mais informações, consulte o Manual de Referência e
Scripts do Elipse E3.
NOTA
O Servidor OPC no Elipse E3 é 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.
4.2.1 Características
Para usar o Servidor OPC do Elipse E3 não é necessária nenhuma configuração extra, basta executar o Domínio para
que qualquer Cliente OPC possa se comunicar com o Elipse E3. Para conectar-se ao Servidor OPC do Elipse E3 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 E3 Viewer) não são acessíveis pelo Servidor OPC.
Drivers 138
Por ser baseado na mesma tecnologia de associações usada nas Associações internas entre objetos, o Servidor OPC
do Elipse E3 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.
4.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.
139 Drivers
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 de Comunicação 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
Informações Sobre o Servidor Mostra uma janela com informações sobre o Servidor
OPC selecionado
NOTAS
· A opção Ativar 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 Bloco OPC 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 em um Driver de Comunicação OPC.
4.3.1 Configuração
A identificação dos outros objetos pertencentes ao Driver de Comunicação OPC pode ser inserida manualmente, ou
então ser trazida automaticamente do Servidor OPC. Para isto, abra a Janela de Propriedades de um Driver de
Comunicação OPC, clicando com o botão direito do mouse no objeto e selecionando a aba OPC Driver.
Drivers 140
Aba OPC Driver
Informe o Endereço e ID do Servidor e clique em Selecionar. A janela da figura a seguir é mostrada.
141 Drivers
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 E3 tenta procurar as especificações do Driver
de Comunicação OPC tanto pelo Registro do Windows
quanto pelo enumerador padrão OPC (OPCENUM)
Tentar apenas enumerador padrão (serviço OPCENUM) O Elipse E3 tenta procurar as especificações do Driver
de Comunicação OPC apenas pelo enumerador padrão
OPC (OPCENUM)
Clicando em OK, o Elipse E3 Studio mostra os dados do Driver de Comunicação OPC, indicando os caminhos e o
nome do Servidor OPC. Para ativar a comunicação do Driver de Comunicação OPC, clique em Ativar Comunicação .
Drivers 142
Opções habilitadas quando o
Driver está ativo
A opção Informações Sobre o Servidor mostra uma janela com informações mais detalhadas sobre o Servidor
OPC selecionado.
143 Drivers
Mensagem referente à importação de Tags OPC
As opções disponíveis nesta caixa de diálogo são as seguintes:
· Sim: O Elipse E3, ao executar a localização dos Tags de Comunicação OPC, tenta automaticamente detectar quais
Tags de Comunicação OPC são do tipo Bloco e, neste caso, qual o número de Elementos de Bloco OPC. Para isto,
o Elipse E3 precisa ler o valor de cada um e, dependendo do Servidor OPC e do número de Tags de
Comunicação OPC, pode ser uma operação demorada
· Não: O Elipse E3 não lê os valores dos Tags de Comunicação OPC ao realizar a operação de busca. Esta
operação é mais rápida, porém não cria automaticamente Tags de Comunicação OPC de tipo Bloco e os
respectivos Elementos de Bloco OPC
· Cancelar: Cancela a importação
Drivers 144
Opções disponíveis na janela Importação de Tags OPC
OPÇÃO DESCRIÇÃO
Nome dos Itens Filtra os Tags de Comunicação OPC a partir do nome dos
itens especificados. Podem ser utilizados caracteres
curingas, tais como * (asterisco) ou ? (ponto de
interrogação)
Para executar a importação, selecione o Tag de Comunicação OPC desejado e arraste-o para o Driver de
Comunicação OPC ou Grupo de Tags OPC desejado. Para desativar a comunicação do Driver de Comunicação OPC,
clique em Desativar Comunicação .
Nesta janela é possível usar a combinação de teclas CTRL + Clique do mouse para selecionar Tags de Comunicação
OPC não consecutivos e SHIFT + Clique do mouse para selecionar um intervalo de Tags de Comunicação OPC.
Algumas das propriedades do Driver 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
Propriedades e execute os devidos ajustes. Para mais informações, consulte o Manual de Referência e Scripts do Elipse
E3.
4.3.1.1 Funcionamento
A comunicação do Driver de Comunicação OPC do Elipse E3 com um Servidor OPC é realizada por um processo
separado. Este processo, quando o Driver de Comunicação OPC é ativado pelo Elipse E3 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. No menu Iniciar (Start) do Windows, clique em Todos os aplicativos (All apps), selecione o item Ferramentas do
Windows (Windows Tools) e selecione o item Serviços de Componente (Component Services), ou digite dcomcnfg
em um 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.
145 Drivers
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
necessidade de criar scripts para isto. Caso necessite configurar alguma propriedade, localize-a na Lista de
Propriedades e execute os devidos ajustes. Para mais informações, consulte o Manual de Referência e Scripts do Elipse
E3.
Drivers 146
Inserindo uma Pasta OPC
147 Drivers
2. Abre-se uma janela perguntando quantos Tags de Comunicação OPC devem ser criados no Grupo de Tags OPC, e
qual o nome. Este nome é autoincrementado e, se esta opção é deixada em branco, os Tags de Comunicação OPC
são criados com um nome padrão.
Drivers 148
Janela Inserindo OPCTagBlock
3. É mostrada uma caixa de diálogo para determinar o número de Elementos de Bloco OPC neste objeto. Nesta
opção é possível indicar o mapeamento de todos os Elementos de Bloco OPC ou somente de um determinado
intervalo de Elementos de Bloco OPC.
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
Propriedades e execute os devidos ajustes. Para mais informações, consulte o Manual de Referência e Scripts do Elipse
E3.
Tabela 5 12 77 55 1 3 42 20 8 89
Índice 0 1 2 3 4 5 6 7 8 9
NOTA
O Elipse E3 pode criar automaticamente os Elementos de Bloco OPC. Para mais detalhes, consulte a opção Importar
Tags, no tópico Configuração.
149 Drivers
1. Clique com o botão direito do mouse no Bloco de Comunicação OPC e selecione a opção Inserir - Elemento de
Bloco OPC.
Drivers 150
Inserindo um Driver de Comunicação OPC UA em modo Domínio
Ao inserir um Driver de Comunicação OPC UA em uma aplicação no Elipse E3 Studio, abre-se o Editor do objeto,
conforme a figura a seguir.
151 Drivers
OPÇÃO DESCRIÇÃO
Importar Tags Importa Tags de Comunicação OPC UA para um Driver
de Comunicação OPC UA
Informações Sobre o Servidor Mostra uma janela com informações sobre o Servidor
OPC UA selecionado
NOTA
A opção Ativar 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 Bloco OPC UA 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.
Algumas das propriedades de um Driver de Comunicação OPC UA 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 mais informações, consulte o Manual de Referência e
Scripts do Elipse E3.
4.4.1 Configuração
Para configurar um Driver de Comunicação OPC UA, clique com o botão direito do mouse no objeto e selecione o
item Selecionar Servidor .
Drivers 152
Janela Servidores OPC UA
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 OPC
UA também pode suportar diferentes formas de identificação e autenticação de usuários.
Atualmente, o Elipse E3 permite a conexão apenas pelo modo TCP Binário. Para este modo, o Elipse E3 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 E3 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 E3 podem ser selecionados.
Ao selecionar um ponto de conexão compatível com o Elipse E3, 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 E3 utiliza uma conexão
anônima com o Servidor. Caso contrário, o Elipse E3 envia os valores destas propriedades para o Servidor OPC UA,
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 OPC UA,
pela rede, pelos computadores onde executam o Cliente OPC UA e o Servidor OPC UA e até mesmo pelas operações
realizadas pelo Cliente OPC UA. Este ajuste deve ser realizado caso a caso e os valores padrão destas propriedades
são apenas sugestões.
No Elipse E3 Studio, a comunicação com um Driver de Comunicação OPC UA pode ser ativada ao selecionar a opção
Ativar Comunicação no menu contextual do objeto ou na respectiva barra de ferramentas. A ativação é executada
automaticamente pelos objetos Consulta ao selecionar Servidores OPC UA, Tags de Comunicação OPC UA, ou executar
a visualização dos resultados de uma Consulta na aba Visualizar.
Ao selecionar a opção Importar Tags , a janela da figura a seguir é mostrada, caso não haja um objeto Assinatura
OPC UA configurado neste Driver de Comunicação OPC UA.
153 Drivers
Mensagem em referência à importação de Tags OPC UA
Clique em Sim para criar uma Assinatura OPC UA e abrir a janela da figura a seguir, onde é possível selecionar Tags
de Comunicação OPC UA para importação.
Drivers 154
Ao selecionar a opção Contagem de Tags , a janela da figura a seguir é mostrada, permitindo visualizar a
quantidade de Tags de Comunicação OPC UA disponíveis em um Driver de Comunicação OPC UA.
155 Drivers
4.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 OPC UA podem ser inseridas dentro de outras. Em
tempo de execução, se a Pasta OPC UA é desabilitada, todo o 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.
Drivers 156
Inserindo um Tag de Comunicação OPC UA
2. Abre-se uma janela perguntando quantos Tags de Comunicação OPC UA devem ser criados na Assinatura OPC UA,
e qual o nome. Este nome é autoincrementado e, se esta opção é deixada em branco, os Tags de Comunicação
OPC UA são criados com um nome padrão.
NOTA
Na versão atual, o Elipse E3 só permite que vetores de uma dimensão (arrays) sejam mapeados para Blocos de
Comunicação OPC UA, embora o padrão OPC UA suporte matrizes n-dimensionais como tipos de dados.
157 Drivers
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.
Drivers 158
Janela Configurando o Bloco Novo
4. Informe o tamanho do Bloco de Comunicação OPC UA 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 OPC UA 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 mais informações, consulte o Manual de Referência e
Scripts do Elipse E3.
159 Drivers
Algumas das propriedades do Elemento de Bloco OPC UA 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 mais informações, consulte o Manual de Referência e Scripts do Elipse
E3.
Aba Campos
As opções disponíveis na aba Campos estão descritas na tabela a seguir.
Drivers 160
Opções disponíveis na aba Campos
OPÇÃO DESCRIÇÃO
Dados Brutos A Consulta retorna os dados como são armazenados no
Servidor OPC UA, semelhante à consulta
CompressedDataStartEndTime do objeto Storage.
Neste modo, apenas um Tag de Comunicação OPC UA
pode ser consultado por vez, retornando também a
qualidade do valor
Ao clicar em Adicionar Campo , a janela a seguir é mostrada, permitindo selecionar os Tags de Comunicação OPC
UA existentes no Servidor OPC UA.
161 Drivers
Seleção de Tags OPC UA
As abas Variáveis e Visualizar têm o mesmo comportamento descrito no capítulo Consultas.
4.4.8 Certificados
Durante a instalação do Elipse E3, é instalado um certificado relativo à instância do Cliente OPC UA do Elipse E3. Este
certificado é necessário sempre que é utilizada uma conexão com o Servidor OPC UA 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 E3, 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 de Comunicação OPC UA
tentar estabelecer uma conexão com um Servidor OPC UA.
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 OPC UA do Elipse E3 pode ser negada.
· Este certificado corresponde à instância do Cliente OPC UA, e não ao Cliente OPC UA do Elipse E3, ou seja, este
certificado NÃO pode ser copiado de um computador para outro. Cada instalação tem um certificado único.
· O Cliente OPC UA do Elipse E3 aceita qualquer certificado válido de Servidor OPC UA, ou seja, não é necessária
nenhuma configuração para que o Cliente OPC UA do Elipse E3 aceite uma determinada instância de Servidor OPC
UA.
Drivers 162
RedundantServerDataType, SamplingIntervalDiagnosticsDataType, EnumValueType, NetworkGroupDataType
e EndpointUrlListDataType
NOTA
Estruturas definidas por Servidores OPC UA específicos, não compatíveis com o padrão OPC UA, não são lidas pelo
Elipse E3.
Nos campos da consulta, o texto dos caminhos dos Tags de Comunicação OPC UA do Servidor OPC UA 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 o í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)
O Elipse E3 não suporta Identificadores de Nós OPC UA (NodeIds) que não sejam do Servidor OPC UA onde é
executado o browse dos Tags de Comunicação OPC UA (Servidores Gateway). Estes Tags de Comunicação OPC UA,
portanto, não são mostrados na janela de seleção de Servidores OPC UA. 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).
4.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.
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
163 Drivers
QUALIDADE CAMPO QUALIDADE DESCRIÇÃO
64 - 127 Incerta A qualidade do valor é incerta pelas
razões indicadas no campo
Substatus
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.
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
Drivers 164
SUBSTATUS DESCRIÇÃO LIMITE
SEM LIMITE BAIXO ALTO CONSTANTE
Ú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
165 Drivers
SUBSTATUS DESCRIÇÃO LIMITE
SEM LIMITE BAIXO ALTO CONSTANTE
Ú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
Drivers 166
SUBSTATUS DESCRIÇÃO LIMITE
SEM LIMITE BAIXO ALTO CONSTANTE
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
NOTA
Servidores que não suportam o Substatus devem retornar 0 (zero).
NOTA
Servidores que não suportam o Substatus devem retornar 0 (zero).
167 Drivers
ESPECIFICAÇÃO DESCRIÇÃO
Limite Inferior O valor está limitado em algum valor inferior
NOTA
Servidores que não suportam o campo Limite devem retornar 0 (zero).
Drivers 168
CAPÍTULO
Quadros
5
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 E3 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.
169 Quadros
OPÇÃO DESCRIÇÃO
dockRemaining Este Divisor ocupa o espaço restante após o
posicionamento do Divisor Irmão
Cada Divisor corresponde à visualização de uma Tela ou Quadro do 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.
Quadros 170
Divisores do Quadro
6. Para configurar os Divisores de um Quadro, clique com o botão direito do mouse no Divisor desejado no
Organizer e selecione a opção Propriedades.
Configurações do Quadro
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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ó é habilitada se o Divisor não tem nenhum filho.
Esta opção equivale à propriedade SplitLink
171 Quadros
OPÇÃO DESCRIÇÃO
Habilitar barra de rolagem na Tela Inicial Habilita a exibição de uma barra de rolagem na Tela ou
Quadro selecionado
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 realize os devidos ajustes. Para mais informações, consulte o Manual de Referência e Scripts do
Elipse E3.
Quadros 172
CAPÍTULO
Viewer
6
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 a aplicação 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.
NOTAS
· A qualidade gráfica das Telas pode ser modificada, em tempo de execução, utilizando-se o menu contextual do
Elipse E3 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 E3.
· 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 E3 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
Scripts do Elipse E3.
6.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.
173 Viewer
6.1.1 Aba Visualizador
Através da aba Visualizador, são configuradas diversas opções do Viewer, conforme a figura a seguir.
Aba Visualizador
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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 E3 Studio abra o AppBrowser,
onde se pode especificar a Tela inicial de visualização.
Esta opção equivale à propriedade InitialScreen 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
Viewer 174
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
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
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 dos itens selecionados, mas este item só tem efeito caso o usuário selecione
explicitamente o item Usar Padrão do menu Alinhamento (Esta Tela).
175 Viewer
6.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
descritas na tabela a seguir.
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 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 ou 2
- Minimized: A Tela inicia minimizada
Viewer 176
OPÇÃO DESCRIÇÃO
Borda Habilita uma borda na janela do Viewer. Esta opção
equivale à propriedade WindowBorder do objeto Viewer
Opção de mover Indica se a janela pode ser movida. Esta opção equivale
à propriedade WindowMovable 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
Configurações avançadas
As opções disponíveis nesta janela estão descritas na tabela a seguir.
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
177 Viewer
OPÇÃO DESCRIÇÃO
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 uma resolução definida pelo usuário, em
pontos por polegada (DPI), nas opções Horizontal e
Vertical
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
Viewer 178
É 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.
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.
179 Viewer
Inserindo uma Pasta do Viewer
NOTA
Uma aplicação que contenha Pastas do Viewer não pode ser aberta em versões do Elipse E3 anteriores à versão 3.1.
Viewer 180
CAPÍTULO
Telas e Objetos de Tela
7
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.
7.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.
Configurar como Tela inicial do Divisor Habilita a Tela como Tela Inicial do Divisor onde é aberta
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 E3 Viewer e do tamanho
dos outros Divisores.
O Elipse E3 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.
Editar Pontos de Conexão Permite editar pontos de conexão entre objetos. Esta
opção somente está habilitada em objetos XControl
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
Alinhamento Inferior Alinha dois ou mais objetos entre si, tendo como
referência a coordenada inferior do último objeto
selecionado
Alinhamento Central Vertical Alinha dois ou mais objetos verticalmente pelo centro
entre si, tendo como referência o último objeto
selecionado
Atualizar Domínio e Executar Viewer com a Tela Atual Atualiza o Domínio, executa o Elipse E3 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
Executar ou Parar Domínio da barra de ferramentas
Padrão
As primitivas do editor gráfico disponíveis no Elipse E3 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 das propriedades, caso seja necessário.
7.3.2 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 os Pontos de Conexão, como na figura a seguir.
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.
7.3.4 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é o 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.
7.3.5 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.
7.3.6 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.
2. Clique na Tela para criar o vértice de origem do objeto e arraste o mouse diagonalmente até o vértice final.
7.3.7 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 formatos de arquivo suportados são BMP (Bitmap, extensão .bmp), GIF (Graphics
Interchange Format, extensão .gif), JPEG (Joint Photographic Experts Group, extensão .jpg), ICO (Windows Icon Format,
extensão.ico), WMF (Windows Metafile, extensão .wmf), EMF (Enhanced Metafile, extensão .emf), PNG (Portable Network
Graphics, extensão .png) e TIFF (Tagged Image File Format, extensão .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é o vértice final.
3. O Elipse E3 Studio abre uma caixa de diálogo para seleção do arquivo de imagem, conforme a figura a seguir.
7.3.8 Linha
Permite o desenho de retas, ligando dois pontos especificados na 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é o ponto final.
7.3.9 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
quantas forem necessárias para completar o desenho desejado.
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.
7.3.11 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é o vértice final,
até o desenho atingir o tamanho e a posição desejados.
7.3.13 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.
2. Clique na Tela para criar o vértice de origem do objeto e arraste o mouse diagonalmente até o 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 SetPoint.
7.3.14 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.
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.
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.
7.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.
7.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.
7.4.5 Camadas
O Elipse E3 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 E3 Studio) quanto em
tempo de execução (no Elipse E3 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
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 Visualizar Todas as Camadas, equivalente ao valor &hFFFFFFFF em hexadecimal, ou Visualizar Nenhuma
Camada, equivalente ao valor &h0 em hexadecimal, conforme a figura a seguir.
7.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 as 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
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Preenchimento
OPÇÃO DESCRIÇÃO
Estilos Mostra todos os estilos de preenchimento disponíveis
para o objeto selecionado
7.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.
Para manter o enquadramento de uma Tela na área visível, utilize a opção Toda Tela do menu Zoom.
7.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 E3 Studio, e não em tempo de execução.
No Elipse E3 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.
7.4.10 Mover
Permite mover o conteúdo de uma Tela que contenha barras de rolagem no Elipse E3 Studio ou no Elipse E3 Viewer,
em tempo de execução. Para utilizar este recurso no Elipse E3 Studio, siga estes procedimentos:
NOTAS
· Tanto no Elipse E3 Studio quanto no Elipse E3 Viewer, a opção Mover está sempre disponível ao utilizar o botão
do meio do mouse.
· No Elipse E3 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.
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.
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.
7.4.13 Rotacionar
Permite rotacionar um objeto de Tela tendo como origem o 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 dos 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.
NOTAS
· Para objetos de Tela do tipo Figura que utilizem o formato Bitmap, ou seja, arquivos com a 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 padrão.
7.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 as 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.
7.4.16 Travar
Ao selecionar esta opção, o Elipse E3 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 .
7.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.
NOTAS
· 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.
Aba Personalizado
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
Estes elementos também podem ter o 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.
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.
\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.
-1 "Positivo";"Negativo";"Zero","Texto" Negativo
0 "Positivo";"Negativo";"Zero","Texto" Zero
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
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
987 B 1111011011
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.
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
Ao especificar a fonte de uma Associação, o texto aparece em azul caso esta corresponda a uma expressão válida. Se
a expressão contém 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.
A coluna 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
Associações 204
nome do contexto (os valores possíveis podem ser consultados na descrição do método Context, no Manual de
Referência e Scripts do Elipse E3) e Caminho pode ser o caminho de um objeto existente na hierarquia inferior do
objeto de contexto, ou uma propriedade deste mesmo objeto. Os nomes dos contextos não são sensíveis a
maiúsculas e minúsculas.
NOTA
Ao especificar o caminho de um objeto na coluna 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.
8.1 Simples
Na Associação Simples, o valor da coluna Fonte é copiado para a propriedade toda vez que esta é modificada.
Associação Simples
Para utilizar este recurso, siga estes procedimentos:
1. Clique com o botão direito do mouse em um objeto e selecione a opção Propriedades.
2. Selecione a aba Associações, clique na coluna Conexão da propriedade desejada e selecione a opção Conexão
Simples .
3. Na coluna Fonte, clique em para indicar uma propriedade a referenciar ou escreva uma expressão nesta
coluna.
8.2 Bidirecional
A Associação Bidirecional é semelhante à Associação Simples, mas caso haja uma variação na propriedade, o valor
é copiado para a fonte, gerando assim uma Associação de duas direções.
205 Associações
Associação Bidirecional
Para utilizar este recurso, siga estes procedimentos:
1. Clique com o botão direito do mouse em um objeto e selecione a opção Propriedades.
2. Selecione a aba Associações, clique na coluna Conexão da propriedade desejada e selecione a opção Conexão
Bidirecional .
3. Na coluna Fonte, clique em para indicar uma propriedade a referenciar ou escreva uma expressão nesta
coluna.
8.3 Digital
Na Associação Digital, pode-se estabelecer que, caso a variável ou expressão da coluna Fonte represente um valor
digital ou Booleano, os estados Verdadeiro e Falso desta variável são mapeados para certos valores no destino,
incluindo uma opção de pisca ou 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
Valor <Ligado> Especifica o valor assumido pela propriedade quando a
expressão da coluna Fonte retorna Verdadeiro
Associações 206
OPÇÃO DESCRIÇÃO
Pisca <Ligado> Quando esta opção está habilitada, a propriedade
conectada alterna entre os valores da opção Valor
<Ligado> e Para valor <Ligado> se a expressão da
coluna Fonte retorna Verdadeiro
8.4 Analógica
A Associação Analógica permite estabelecer uma escala de conversões entre uma variável fonte e uma variável de
destino. Através dos valores especificados, é realizada uma escala linear entre os valores da propriedade e os valores
da fonte.
Associação Analógica
As opções disponíveis nesta Associação estão descritas na tabela a seguir.
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
207 Associações
1. Clique com o botão direito do mouse em um objeto e selecione a opção Propriedades.
2. Selecione a aba Associações, clique na coluna Conexão da propriedade desejada e selecione a opção Conexão
Analógica .
3. Na coluna Fonte, clique em para indicar uma propriedade a referenciar ou escreva uma expressão nesta
coluna.
Associações 208
4. Caso seja necessário alternar periodicamente entre os valores, habilite a coluna Pisca e configure a coluna Valor.
8.6 Reversa
Na Associação Reversa, toda vez que o valor de uma propriedade é modificado, este é copiado para a fonte,
funcionando assim de maneira inversa à Associação Simples.
Associação Reversa
Para utilizar este recurso, siga estes procedimentos:
1. Clique com o botão direito do mouse em um objeto e selecione a opção Propriedades.
2. Selecione a aba Associação, clique na coluna Conexão da propriedade desejada e selecione a opção Conexão
Reversa .
3. Na coluna Fonte, clique em para indicar uma propriedade a referenciar ou escreva uma expressão nesta
coluna.
8.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 um intervalo, as propriedades Min e Max, e a fonte para aquele intervalo, a propriedade Source, que
é uma Associação Simples.
Associação Múltipla
As opções disponíveis nesta Associação estão descritas na tabela a seguir.
209 Associações
Opções disponíveis para a Associação Múltipla
OPÇÃO DESCRIÇÃO
Adiciona Adiciona uma nova linha na tabela
Associações 210
Janela Editar 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 os respectivos 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
Clicar em Exclui 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 está selecionada. Se esta
janela está visível, é permitida a edição das propriedades das Associações. O valor padrão é habilitado.
211 Associações
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.
Associações 212
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
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.
213 Associações
CAPÍTULO
Bibliotecas
9
O Elipse E3 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 E3 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 E3 é altamente recomendável na maioria dos casos, devido ao ganho de produtividade
que trazem às aplicações. Algumas das vantagens dos objetos 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
9.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
objetos ElipseX. Os tipos de símbolos disponíveis são 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.
Para utilizar este recurso, siga estes procedimentos:
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 E3.
Bibliotecas 214
Galeria
215 Bibliotecas
Dentro de uma Biblioteca ElipseX, pode-se inserir os objetos XControls, XFolders e XObjects.
Os seguintes itens podem ser inseridos em um XControl:
· Primitivas de desenho, tais como retas, retângulos e círculos, entre outros
· Objetos gráficos vetoriais, incluindo objetos da Biblioteca de símbolos, tais como arquivos no formato WMF e
EMF, entre outros
· Objetos gráficos não vetoriais, tais como arquivos no formato BMP, JPEG e GIF, entre outros
· Controles ActiveX do Elipse E3, tais como 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 nas 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, tais como Bancos de
Dados, Configurações de Alarmes, Fórmulas, Históricos, Storages, Servidores de Dados, Drivers de Comunicação e
Alarmes.
NOTA
A Janela de Propriedades dos objetos 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 XControls, XFolders
ou XObjects. Pode-se também ter várias Bibliotecas diferentes dentro de um mesmo Domínio.
Note que para cada objeto ElipseX criado em uma Biblioteca são criadas internamente uma interface para declarar as
propriedades de um objeto e outra interface para declarar os eventos deste objeto. Estas interfaces têm os nomes
gerados automaticamente, acrescentando o prefixo "D" a este nome, ou seja, a interface de eventos adiciona o sufixo
"Events" ao nome automático. Se, por exemplo, o objeto se chama "XObject1", a 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.
9.2.1 XControls
Um XControl define uma interface gráfica com o usuário, que pode ser composta de quaisquer objetos do Elipse E3
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.
Bibliotecas 216
Aba Design de um XControl
217 Bibliotecas
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
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 na figura a seguir. A partir de
um XControl em desenvolvimento, ou seja, dentro da Biblioteca, é possível inserir outro XControl clicando com o
botão direito do mouse no XControl de destino e selecionando a opção Inserir.
Bibliotecas 218
Inserindo um XControl em uma 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 respectivo menu contextual da Tela para que esta 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 a cor, ao inserir este objeto na Tela o Elipse E3
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.
9.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 nas 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.
219 Bibliotecas
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 está em uso em uma 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 ou clicando em Excluir . As opções disponíveis na aba
Propriedades estão descritas na tabela a seguir.
Opções disponíveis na aba Propriedades
OPÇÃO DESCRIÇÃO
Nome Determina o nome da variável do XFolder
Bibliotecas 220
OPÇÃO DESCRIÇÃO
Exposição ao Servidor OPC UA Determina como esta Propriedade é exposta no Servidor
OPC UA. Os valores possíveis para esta opção são 0 -
eDontExpose: Esta Propriedade não é exposta no
Servidor OPC UA (padrão), 1- eExpose: Esta propriedade
é exposta no Servidor OPC UA para leitura e escrita ou 2
- eExposeAsReadOnly: Esta propriedade é exposta no
Servidor OPC UA somente para leitura. Esta opção
corresponde à propriedade ExposableToOpc de um
objeto Definição de Propriedade
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, 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.
221 Bibliotecas
9.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 e registros históricos, entre outros, que independam de que
alguma interface gráfica (Elipse E3 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.
Bibliotecas 222
OPÇÃO DESCRIÇÃO
Retentiva Determina se a Propriedade é retentiva ou não. Esta
opção corresponde à propriedade Retentive de um
objeto Definição de Propriedade
Apenas Propriedades de tipos de dados simples, tais como Variant, String, Date ou Double, entre outros, podem ser
retentivas. Neste caso, 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 objetos ElipseX pode aumentar o tempo de início de uma aplicação 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 valor alterado. Se a Propriedade nunca é alterada, o valor retentivo permanece
zerado.
Podem ser inseridos em um XObject quaisquer módulos do Elipse E3 que sejam executados no servidor, tais como
Banco de Dados, Configuração de Alarmes, Fórmula, Histórico, Storage, Servidor de Dados, Tag de Comunicação,
Driver 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 uma aplicação.
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 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 este
objeto, a Verificação de Domínio reporta esta situação como um erro e não permite a execução deste objeto.
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, 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.
223 Bibliotecas
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, ou cópia, o Elipse E3 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 excluir uma Propriedade de um XControl, XFolder ou XObject que possua uma Associação.
Estas Propriedades, uma vez excluídas, 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 escluir esta Associação ou não.
Propriedade inválida
Bibliotecas 224
Pode-se optar por não excluir e então criar novamente o objeto que foi excluído com a Propriedade que se deseja
editar, excluir apenas a Propriedade mostrada, excluir todas as Propriedades ou não excluir nenhuma Propriedade.
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 E3:
· 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 E3 permite que sejam utilizadas posteriormente apenas as variáveis de interesse, desprezando-
se as demais
NOTA
Para exemplos de criação de objetos ElipseX e maiores informações sobre estes objetos, consulte o Manual de
Referência e Scripts do Elipse E3.
225 Bibliotecas
CAPÍTULO
ActiveX
10
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 E3 é 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 E3, é necessário que estes objetos sejam instalados em
todos os computadores onde a aplicação vai executar, especialmente em Elipse E3 Viewers remotos.
Além destes, pode-se inserir qualquer outro objeto ActiveX. Para registrar um objeto ActiveX no Elipse E3, siga estes
procedimentos:
1. Selecione o menu Ferramentas - Gerenciar ActiveX. A janela da figura a seguir é mostrada.
ActiveX 226
OPÇÃO DESCRIÇÃO
Remover Remove o controle selecionado da lista Controles
registrados no Elipse E3, 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
2. Clique em Procurar para abrir uma caixa de diálogo e localizar o arquivo que contém o ActiveX.
Os objetos ActiveX podem ser do tipo Gráfico, utilizados nas Telas da aplicação, e Não-Gráfico, que 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
227 ActiveX
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.
Os objetos da biblioteca Microsoft Forms disponíveis no Elipse E3 são descritos nos tópicos seguintes.
ActiveX 228
10.1.7 Editor de Texto
Possibilita ao usuário inserir e editar textos. É inserido na Tela ao selecionar o ícone .
10.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
.
10.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 .
229 ActiveX
OPÇÃO DESCRIÇÃO
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 E3, no capítulo respectivo.
ActiveX 230
CAPÍTULO
Servidor de Dados
11
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.
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.
Aba Geral
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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 a
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.
NOTA
O objeto Banco de Dados pode ser configurado para funcionar como Área de Alarme.
12.1 Access
Gera uma base de dados Access ou MDB (Microsoft Access Database), padrão para banco de dados no Elipse E3. Para
utilizar este recurso, siga estes procedimentos:
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 a janela de edição de scripts é aberta.
2. Para configurar este objeto, selecione a aba Configurações na Janela de Propriedades.
12.2 Oracle
A utilização do Oracle como servidor de banco de dados do Elipse E3 só é possível instalando um servidor ou cliente
Oracle no computador 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 E3
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 acessando-o de dentro do Elipse E3 ou via scripts. A seguir
são explicados cada um destes procedimentos.
Usar provedor OLE DB Oracle Permite usar as interfaces ADO (ActiveX Data Objects) do
Oracle para que o objeto Consulta do Elipse E3
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. Esta opção corresponde à propriedade
OracleUseADODrivers do objeto Banco de Dados
NOTAS
· As opções Usar provedor OLE DB Oracle e Usar tipo TIMESTAMP vêm habilitadas por padrão em aplicações
criadas a partir da versão 6.6. Em aplicações criadas em versões anteriores, as configurações são respeitadas,
mas não é recomendável desabilitar estas opções. A possibilidade de desabilitar estas opções deve ser removida
em versões futuras do Elipse E3.
· Desmarcar a opção Usar provedor OLE DB Oracle automaticamente desmarca a opção Usar tipo TIMESTAMP.
· A opção Usar provedor OLE DB Oracle pode ser habilitada ou desabilitada para novos objetos de Bancos de
Dados na aba Propriedades das opções do Domínio.
· 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 E3 Studio, automaticamente selecionam a opção Usar provedor
OLE DB Oracle se a opção Usar tipo TIMESTAMP está selecionada.
· No caso do Elipse E3 Studio, o usuário é perguntado se deseja salvar esta alteração.
· Ao executar a aplicação, a alteração persiste apenas durante a execução, retornando ao estado anterior até que o
usuário salve esta alteração.
Ao inserir um Banco de Dados na aplicação, são habilitadas as opções referentes ao tipo de servidor de banco de
dados, que é responsável pelo gerenciamento e armazenamento das informações dos objetos que utilizam este
serviço.
2. Depois de criada a conexão, é possível executar um comando SQL diretamente na conexão, como mostrado a
seguir.
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 objeto Recordset,
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.
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 E3 adiciona automaticamente à String de conexão o
parâmetro de compatibilidade "DataTypeCompatibility=80".
O uso deste tipo de acesso deve ser restrito a casos onde não exista outra solução. O Elipse E3 disponibiliza recursos
que visam minimizar o uso destes acessos via script. Entretanto, eventualmente o uso deste recurso pode ser
necessário.
12.4 PostgreSQL
Para inserir um novo Banco de Dados PostgreSQL, siga estes procedimentos:
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 a janela de edição de scripts é aberta.
2. Para configurar este objeto, selecione a aba Configuração na Janela de Propriedades.
Ao inserir um Banco de Dados em uma aplicação, são habilitadas as opções referentes ao tipo de servidor de banco
de dados, que é responsável pelo gerenciamento e armazenamento das informações dos objetos que utilizam este
serviço.
12.5 MySQL
Para inserir um novo Banco de Dados MySQL, siga estes procedimentos:
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 a janela de edição de scripts é aberta.
2. Para configurar este objeto, selecione a aba Configuração na Janela de Propriedades.
NOTA
A versão mínima do servidor MySQL suportada pelo Elipse E3 é a 8.0.11.
Ao inserir um Banco de Dados em uma aplicação, são habilitadas as opções referentes ao tipo de servidor de banco
de dados, que é responsável pelo gerenciamento e armazenamento das informações dos objetos que utilizam este
serviço.
Nas permissões, a expressão Permissão completa significa que o usuário tem permissões para:
· Criar ou remover tabelas existentes
O usuário não precisa ser um Administrador para possuir permissão completa em qualquer objeto.
NOTA
Ao criar 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 uma 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.
Consulta 252
Configurações da Consulta
Para verificar quais as configurações necessárias de uma Consulta, consulte os capítulos Relatórios e E3Browser.
Algumas das propriedades de uma 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 execute os devidos ajustes. Para mais informações, consulte o Manual de Referência e Scripts do Elipse
E3.
253 Consulta
Adição de tabela
3. Selecione as tabelas desejadas e clique em OK.
4. Após definir 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.
Consulta 254
Janela Seleção de Tabelas
Para selecionar todos os campos de uma 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.
255 Consulta
Á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
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.
Consulta 256
Janela Definição do 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.
O valor de uma variável pode ser definido na aba Variáveis ou através de um script usando o método
SetVariableValue.
257 Consulta
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
Consulta 258
Aba Visualizar
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.
259 Consulta
Aviso ao desabilitar a edição direta do SQL
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.
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.
Consulta 260
CAPÍTULO
Consulta Hierarquia do Aplicativo
14
O objeto Consulta Hierarquia do Aplicativo, ou AppXQuery, permite editar, testar e executar consultas no formato
XQuery. Com este formato, pode-se acessar toda a hierarquia de objetos filhos a partir de um objeto pai e retornar
esta hierarquia no formato XML. Para utilizar este recurso, execute os procedimentos a seguir.
1. Clique com o botão direito do mouse em uma Tela e selecione a opção Inserir - Standard - Consulta Hierarquia
do Aplicativo (xml).
NOTA
O objeto Consulta Hierarquia do Aplicativo pode ser inserido em XObjects, XControls, Viewers, Pastas do Viewer,
Telas e Pastas de Dados.
2. Após a inserção, clique com o botão direito do mouse neste objeto e selecione a opção Configurar, conforme a
figura a seguir.
14.1 Configuração
A janela de configuração de uma Consulta Hierarquia do Aplicativo, mostrada na figura a seguir, permite editar,
verificar e visualizar o resultado de uma consulta.
NOTAS
· Para mais informações sobre a especificação da linguagem XQuery, consulte a Referência de linguagem XQuery.
· Uma Consulta Hierarquia do Aplicativo também pode ser executada usando o método XQuery do módulo
E3Globals.
Para acessar todas as Associações da Tela Menu da aplicação de demonstração do Elipse E3, utilize o código a
seguir.
<root>
@foreach
@var Object = {Me.PathName}
@with Me.Links
@foreach
<Link Object Property Source>
@recurse
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.
265 Alarmes
· 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.
Alarmes 266
Aba Área de Alarmes
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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 um objeto de Servidor. Esta opção
corresponde à propriedade IsAlarmArea de um objeto
Demais informações sobre as funcionalidades das propriedades deste objeto podem ser encontradas no Manual de
Referência e Scripts do Elipse E3, no capítulo respectivo.
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 um 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.
267 Alarmes
Opção Inserir - Standard - Filtro de Alarmes
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 execute os devidos ajustes.
15.2.1 Configuração
Para configurar um Filtro de Alarmes, clique com o botão direito do mouse no objeto e selecione a opção
Propriedades.
Alarmes 268
15.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
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Conexões
OPÇÃO DESCRIÇÃO
Adiciona Adiciona uma nova Conexão ao Filtro de Alarmes. Esta
opção corresponde ao método Add da Coleção de
Conexões
269 Alarmes
15.2.1.2 Aba Filtros
A aba Filtros permite gerenciar os Filtros do Filtro de Alarmes.
Aba Filtros
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Filtros
OPÇÃO DESCRIÇÃO
Filtros Opção com os Filtros atualmente disponíveis
Ao clicar em Configurar, a janela da figura a seguir é aberta para configuração do Filtro selecionado.
Alarmes 270
Propriedades do Filtro selecionado
As opções disponíveis nesta janela estão descritas na tabela a seguir.
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 um 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 está em
branco, esta opção é habilitada e, se está 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
Filtro não sensível à acentuação Se a opção Utilizar filtro customizado não está em
branco, esta opção é habilitada e, se está 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
271 Alarmes
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
Aba Ordenação
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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
Alarmes 272
15.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.
273 Alarmes
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 E3, no 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.
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
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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
Alarmes 274
Aba Supressão
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Supressão
OPÇÃO DESCRIÇÃO
Condição para supressão de alarmes Uma expressão que deve ser avaliada para determinar
se este Alarme pode ser suprimido por arquivamento ou
por condição
Tratar alarmes suprimidos como eventos Indica que este Alarme suprimido por arquivamento ou
por condição deve ser tratado como um Evento. Esta
opção corresponde à propriedade SuppressedAsEvent de
todos os objetos Fonte de Alarme
Excluir alarmes suprimidos dos contadores de alarmes Ignora Alarmes suprimidos por arquivamento ou por
condição de uma Área de Alarme nos contadores gerais
de Alarmes. Esta opção corresponde à propriedade
ExcludeSuppressedOnAreaCounters de todos os objetos
Fonte de Alarme
275 Alarmes
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.
Aba Analógico
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Analógico
OPÇÃO DESCRIÇÃO
Subcondição Nome da Subcondição de Alarme. As opções disponíveis
são LoLo, Lo, Hi ou HiHi
Alarmes 276
OPÇÃO DESCRIÇÃO
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
Banda morta
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.
277 Alarmes
Aba Banda Morta
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Banda Morta
OPÇÃO DESCRIÇÃO
Habilitar Habilita a banda morta
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 278
15.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.
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
279 Alarmes
15.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
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Digital
OPÇÃO DESCRIÇÃO
Habilitar Habilita o Alarme Digital
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 280
15.3.5 Alarme Discreto
Permite monitorar uma variável pela especificação de múltiplas subcondições.
Aba Discreto
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Discreto
OPÇÃO DESCRIÇÃO
Cria nova subcondição Cria uma nova Subcondição neste Alarme
281 Alarmes
OPÇÃO DESCRIÇÃO
Espera (ms) Especifica um tempo de espera, em milissegundos.
Quando este valor é igual a 0 (zero, padrão), não é
aplicada nenhuma espera
Alarmes 282
Aba Configuração
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na 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
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.
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
283 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
objeto Servidor de Alarmes e a opção de seleção da
unidade de tempo do intervalo equivale à propriedade
VerificationUnit do objeto Servidor de Alarmes
Mover para a tabela de backup os dados descartados Habilita ou desabilita o armazenamento dos dados
descartados na tabela secundária, ou tabela de backup.
Esta opção equivale à propriedade EnableBackupTable do
objeto Servidor de Alarmes
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 na opção Descartar
dados mais antigos que da tabela principal. Esta opção
equivale à propriedade BackupDiscardInterval do objeto
Servidor de Alarmes e a opção de seleção da unidade de
tempo do intervalo equivale à propriedade
BackupDiscardTimeUnit do objeto Servidor de Alarmes
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
Alarmes 284
CAMPO DESCRIÇÃO
AckTimeMS Corresponde ao Campo AckTime como um valor em
milissegundos. Este Campo é usado para facilitar a
gravação de dados de data e hora em bancos de dados
Oracle
285 Alarmes
CAMPO DESCRIÇÃO
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)
Alarmes 286
CAMPO DESCRIÇÃO
InTime Registra a data e hora do valor, no momento em que
entra na condição de alarme
287 Alarmes
CAMPO DESCRIÇÃO
ShelvedExpirationTime Indica a data e hora programada para que este Evento
saia da condição de arquivamento
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 E3 Studio gera a tabela de
dados dos Alarmes conforme as especificações e informa se a tabela foi gerada com sucesso.
Alarmes 288
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.
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, um objeto DBServer, é um módulo do Elipse
E3 que deve ser inserido na aplicação.
289 Alarmes
15.4.2 Configurações dos Campos de Usuário
Na aba Campos do usuário pode-se adicionar valores arbitrários aos Eventos de Alarme.
Campos de 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 de Usuário herdados do Servidor de Alarmes.
Alarmes 290
Campos de Usuário herdados
Os Campos de Usuário podem ser copiados e colados entre objetos. Para isto, configure os Campos de Usuário,
clique com o botão direito do mouse no objeto e selecione a opção Copiar Campos de Usuário. Depois, clique com
o botão direito do mouse no objeto de destino e selecione a opção Colar Campos de Usuário, conforme a figura a
seguir.
NOTAS
· Sempre que um objeto possua valores forçados em Campos de Usuário, ou seja, valores não herdados de Áreas
superiores, uma mensagem é mostrada pedindo confirmação para sobrescrever estes valores.
· Para mais informações sobre o comportamento de um Campo de Usuário de Áreas e Fontes de Alarme, tanto no
Elipse E3 Studio quanto em tempo de execução, consulte as propriedades Link, Value e ValueSource no Manual de
Referência e Scripts do Elipse E3.
291 Alarmes
CAPÍTULO
E3Alarm
16
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.
E3Alarm 292
16.1 Configurações
Para configurar um E3Alarm, clique com o botão direito do mouse no objeto e selecione a opção Propriedades.
Aba Conexões
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Conexões
OPÇÃO DESCRIÇÃO
Adiciona Adiciona uma nova Conexão a um E3Alarm. Esta opção
corresponde ao método Add da 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
293 E3Alarm
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.
Aba Filtros
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Filtros
OPÇÃO DESCRIÇÃO
Filtros Opção com os Filtros atualmente disponíveis
E3Alarm 294
Aba Colunas
NOTA
O ícone na primeira coluna do E3Alarm pode ser mostrado ou escondido configurando a propriedade ShowIcon em
Verdadeiro ou Falso, respectivamente.
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.
295 E3Alarm
OPÇÃO DESCRIÇÃO
Formatador Determina o formatador utilizado na coluna de um
E3Alarm. O formatador utilizado é o padrão do Elipse E3,
com exceção do Campo Severidade e dos Campos
Condição Ativa, Pede Ack, Reconhecido e Habilitado,
cujos exemplos de formatação podem ser consultados
nas tabelas a seguir. Para mais informações, consulte o
tópico Formatação de Valores. Esta opção corresponde
à propriedade Format 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
Verdadeiro ; Sim
Falso ; Não
E3Alarm 296
Aba Ordenação
As opções disponíveis nesta aba estão descritas na tabela a seguir.
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 E3Alarm
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.
297 E3Alarm
Aba Cores
Clique em para selecionar a cor do tipo de Alarme selecionado. A janela da figura a seguir é mostrada.
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)
E3Alarm 298
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.
299 E3Alarm
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
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
As propriedades descritas na tabela anterior são indexadas, ou seja, na 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.
E3Alarm 300
16.1.6 Aba Fonte
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 E3.
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 .
301 E3Alarm
16.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 nos seguintes
casos:
· Se a opção Pede Ack da Fonte de Alarme está em Falso, o Alarme é considerado reconhecido desde a 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 está 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 estão 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.
Reconhecimento de Alarmes
As opções disponíveis nesta caixa de diálogo estão descritas na tabela a seguir.
E3Alarm 302
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
Todos os alarmes do filtro corrente Todos os Alarmes visíveis neste E3Alarm são
reconhecidos
A opção Apenas os alarmes selecionados só está disponível se realmente há 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 há 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 Excluir alarmes desvinculados mostra a caixa de diálogo da figura a seguir.
NOTA
Um Alarme é considerado desvinculado quando está presente no Sumário de Alarmes mas a 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.
303 E3Alarm
Se o Alarme está ativo e a condição de supressão muda de Falso para Verdadeiro, o Alarme sai da condição ativa,
mantendo os valores iniciais mas com os Campos Suppressed em Verdadeiro e SuppressedTime com a estampa de
tempo do momento da mudança. Se a propriedade SuppressedAsEvent da Fonte de Alarme está em Verdadeiro, o
Alarme se torna um Evento, ou seja, o Campo EventType muda para "Event" e os demais Campos mantêm os valores
iniciais, porém com os Campos Suppressed em Verdadeiro e SuppressedTime com a estampa de tempo do
momento da mudança. Se o Alarme está ativo e a condição de supressão muda de Verdadeiro para Falso, o Alarme é
gerado com a estampa de tempo do momento da mudança.
Alarmes suprimidos por condição continuam sendo contabilizados no contadores gerais. Para alterar este
comportamento, configure a propriedade ExcludeSuppressedOnAreaCounters da Fonte de Alarme em Verdadeiro.
NOTA
Alarmes suprimidos por condição sempre se comportam como Alarmes que não precisam de reconhecimento.
Arquivamento de Alarmes
As opções disponíveis nesta caixa de diálogo estão descritas na tabela a seguir.
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
A opção Apenas os alarmes selecionados só está disponível se realmente há 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.
E3Alarm 304
A opção Todos os alarmes do filtro corrente só está disponível se realmente há 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.
NOTAS
· 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.
· Para arquivar Alarmes via script, use o método Shelve da Fonte de Alarme.
· Para desarquivar Alarmes via script, use o método Unshelve da Fonte de Alarme.
· Para verificar a condição de arquivamento de uma Alarme, use a propriedade Shelved da Fonte de Alarme.
305 E3Alarm
Exemplo de ordenação
E3Alarm 306
· 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 à versão 4.7.
307 E3Alarm
CAPÍTULO
Storage
17
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 E3 pode ser executada através de uma ferramenta de consulta
padronizada, que permite montar a 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.
Storage 308
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
309 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 E3.
NOTA
O objeto Storage pode ser configurado para funcionar como Área de Alarme.
17.1 Configurações
Ao abrir o Editor do Storage, as opções disponíveis para configuração são as mostradas na figura a seguir.
NOTA
As licenças do Storage são verificadas apenas quando a aplicação é executada 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
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.
Storage 310
17.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
descritas na tabela a seguir.
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
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, então é descartado.
Esta opção equivale à propriedade DiscardInterval do
Storage e a opção de seleção da unidade de tempo do
intervalo equivale à propriedade DiscardTimeUnit do
Storage
311 Storage
OPÇÃO DESCRIÇÃO
Mover para a tabela de backup os dados descartados Habilita ou desabilita o armazenamento dos dados
descartados na tabela secundária ou tabela de backup.
Esta opção equivale à propriedade EnableBackupTable do
Storage
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 igual a 30 meses. Este intervalo deve ser
sempre maior que o configurado no item Descartar
dados mais antigos que da tabela principal. Esta opção
equivale à propriedade BackupDiscardInterval do Storage
e a opção de seleção da unidade de tempo do intervalo
equivale à propriedade BackupDiscardTimeUnit do
Storage
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.
Campos da tabela _Fields
CAMPO DESCRIÇÃO
FieldDeadBand Banda morta
Storage 312
CAMPO DESCRIÇÃO
FieldDeadBandUnit Unidade da banda morta, em porcentagem do valor
anterior ou porcentagem dos limites de engenharia
(valor fixo)
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 E3 e das normas OPC
· Índice: Relaciona o Campo gravado com o respectivo nome armazenado na tabela _Fields
313 Storage
· 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
17.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.
Storage 314
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
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
315 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
Storage 316
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.
17.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".
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 E3, 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.
317 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.
17.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.
17.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(
@strTableName VARCHAR(100),
@dDate float,
@strFilter VARCHAR(500),
@type int,
@bQuality int)
Onde:
· @strTableName: Nome da tabela a ser consultada
· @dDate: Instante no tempo para a busca, no formato Float
· @strFilter: Opções de filtro para o valor
· @type: Tipo de dados. Os valores possíveis são 0: String, 1: Bit ou Integer ou 2: Analógico
· @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 e FieldValue.
17.2.4.3 E3CalculatedData
Equivale à função CalculatedData. A descrição formal é a seguinte:
E3CalculatedData(
@iSubType int,
@strTableName VARCHAR(100),
@iModMin int,
@dStartDate float,
@dEndDate float,
@strWhere VARCHAR(4000),
@type int,
@bQuality int)
Onde:
Storage 318
· @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
· @strTableName: Nome da tabela a ser consultada
· @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
· @type: Tipo de dados. Os valores possíveis são 0: String, 1: Bit ou Integer ou 2: Analógico
· @bQuality: Se diferente de 0 (zero), somente inclui Tags com qualidade Boa
17.2.4.4 E3CompDataEx
Equivale à função CompressedDataStartEndTime. A descrição formal é a seguinte:
E3CompDataEx(
@strTableName VARCHAR(100),
@dStartDate float,
@dEndDate float,
@strFilter VARCHAR(500),
@strOrder VARCHAR(100),
@bQuality int)
Onde:
· @strTableName: Nome da tabela a ser consultada
· @dStartDate: A data inicial, em formato Float
· @dEndDate: A data final, em formato Float
· @strFilter: Opções de filtro para o valor
· @strOrder: Opções de ordenação do resultado por um campo diferente de E3TimeStamp
· @bQuality: Se diferente de 0 (zero), somente inclui Tags com qualidade Boa
Este Procedimento Armazenado retorna os valores encontrados, no intervalo especificado, com as colunas
E3TimeStamp, Quality e FieldValue.
17.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(
@strTableName VARCHAR(100),
@strFilter VARCHAR(500),
@bQuality int)
Onde:
· @strTableName: Nome da tabela a ser consultada
· @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.
17.2.4.6 E3NCompDataEx
Equivale à função CompressedDataNValues. A descrição formal é a seguinte:
E3NCompDataEx(
@strTableName VARCHAR(100),
@dDate float,
@iNValues int,
@strFilter VARCHAR(500),
319 Storage
@strOrder VARCHAR(100),
@bQuality int)
Onde:
· @strTableName: Nome da tabela a ser consultada
· @dDate: Instante no tempo para a busca, no formato Float
· @iNValues: O número de valores desejados
· @strFilter: Opções de filtro para o valor
· @strOrder: Opções de ordenação do resultado por um campo diferente de E3TimeStamp
· @bQuality: Se diferente de 0 (zero), somente inclui Tags com qualidade Boa
Este Procedimento Armazenado retorna os valores solicitados, se encontrados, com as colunas E3TimeStamp,
Quality e FieldValue.
17.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
· @dStartDate: A data inicial, em formato Float
· @dEndDate: A data final, em formato Float
· @strFilter: Opções de filtro para o valor
· @strOrder: Opções de ordenação do resultado por um campo diferente de E3TimeStamp
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.
17.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
· @dStartDate: A data inicial, em formato Float
· @dEndDate: A data final, em formato Float
· @strWhere: Opções de filtro para o valor
· @type: Tipo de dados. Os valores possíveis são 0: String, 1: Bit ou Integer ou 2: Analógico
· @bQuality: Se diferente de 0 (zero), somente inclui Tags com qualidade Boa
Storage 320
Este Procedimento Armazenado retorna os resultados com as colunas E3TimeStamp e FieldValue.
NOTAS
· Em aplicações criadas antes da versão 5.0 do Elipse E3, 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.
321 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
Storage 322
CAPÍTULO
Histórico
18
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
utilizar este recurso, siga estes procedimentos:
1. Clique com o botão direito do mouse no nome do projeto no modo Explorer e selecione a opção Inserir -
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.
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.
323 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
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
E3, 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.
18.1 Configurações
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 os 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 excluir um Campo, selecione-o e clique em Excluir na barra de
Histórico 324
ferramentas do Histórico ou clique com o botão direito do mouse em um Campo e selecione a opção Excluir .A
mensagem de confirmação da figura a seguir é mostrada.
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.
Aba Histórico
Cada opção da aba Histórico possui uma propriedade correspondente. As opções disponíveis nesta aba estão
descritas na tabela a seguir.
325 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
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
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.
Esta opção equivale à propriedade DiscardInterval do
Histórico e a opção de seleção da unidade de tempo do
intervalo equivale à propriedade DiscardTimeUnit do
Histórico
Mover para a tabela de backup os dados descartados Habilita ou desabilita o armazenamento dos dados
descartados na tabela secundária, ou tabela de backup.
Esta opção equivale à propriedade EnableBackupTable do
Histórico
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. Esta opção
equivale à propriedade BackupDiscardInterval do
Histórico e a opção de seleção da unidade de tempo do
intervalo equivale à propriedade BackupDiscardTimeUnit
do Histórico
Ao clicar em Gerar Tabela, o Elipse E3 Studio mostra a caixa de diálogo da figura a seguir.
Histórico 326
Mensagem do Elipse E3 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
FieldMaxRecTime Depois que este tempo expira, este dado deve ser
automaticamente gravado
327 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
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 E3 Studio abre uma caixa de diálogo para determinar quais as
tabelas são vinculadas ao Histórico corrente, conforme a figura a seguir.
Histórico 328
Quando a opção Manter Histórico sem Vínculo Direto com Tabela Já Existente é habilitada, o Elipse E3 Studio
mostra a mensagem da figura a seguir.
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.
329 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 E3, 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 E3, 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.
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 330
OPÇÃO DESCRIÇÃO
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
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.
331 Histórico
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.
Histórico 332
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 de uma 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 de uma 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.
333 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.
Histórico 334
CAPÍTULO
E3Browser
19
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
Para utilizar este recurso, siga estes procedimentos:
1. Insira um E3Browser no projeto clicando com o botão direito do mouse na área de trabalho e selecionando o item
Inserir - 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 Consulta.
335 E3Browser
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 E3, no capítulo respectivo.
NOTAS
· Um E3Browser não pode carregar Consultas que se encontrem no servidor.
· Clicar no nome de uma coluna ordena os dados em ordem crescente por aquela coluna. Clicar novamente na
mesma coluna ordena os dados em ordem decrescente por aquela coluna, e um terceiro clique na mesma coluna
retorna a ordenação para o padrão de ordenação do objeto Consulta que fornece os dados para o E3Browser.
Para mais informações sobre este comportamento, consulte a propriedade SortColumn, disponível apenas em
tempo de execução.
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 336
Aba Consulta
Para mais informações sobre Consultas, verifique o capítulo Consulta.
Aba Estilo
As opções disponíveis na aba Estilo possuem uma propriedade correspondente. As propriedades disponíveis estão
descritas na tabela a seguir.
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
337 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
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
Aba Opções
As opções disponíveis na aba Opções possuem uma propriedade correspondente. As propriedades disponíveis estão
descritas na tabela a seguir.
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
E3Browser 338
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
NOTA
O nome desta aba aparece no idioma do Windows, e não necessariamente no idioma do Elipse E3.
339 E3Browser
19.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 E3.
E3Browser 340
CAPÍTULO
E3Chart
20
O E3Chart é um componente ActiveX criado especialmente para trabalhar em conjunto com o Elipse E3. 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
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 E3, no capítulo correspondente.
20.1 Configurações
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.
341 E3Chart
20.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
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 342
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
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ções disponíveis na aba Geral
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 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 GridBkColor do E3Chart
343 E3Chart
20.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 excluir Eixos na Coleção de Eixos, bem como configurar as 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 excluídos. 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, como por exemplo zoom, mover ou enquadrar,
entre outras, 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 344
Aba Geral das propriedades do Eixo
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ções disponíveis na aba Geral
OPÇÃO DESCRIÇÃO
Nome Determina o nome do Eixo do gráfico. Esta opção
equivale à propriedade Name 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
345 E3Chart
OPÇÃO DESCRIÇÃO
Cor da escala Determina a cor da escala. Esta opção corresponde à
propriedade Color 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
Mostrar as linhas na grade Habilita a visualização das linhas na grade. Esta opção
equivale à propriedade ShowGrid 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 346
Aba Escala das propriedades do Eixo
Cada opção da aba Escala possui uma propriedade ou um método correspondente. As opções disponíveis estão
descritas na tabela a seguir.
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
Mínimo: Determina o valor mínimo da escala numérica.
Esta opção equivale ao método SetMinMax do Eixo ou
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
347 E3Chart
OPÇÃO DESCRIÇÃO
Inverter escala Inverte os valores da escala selecionada. Esta opção
corresponde à propriedade Inverse do Eixo
Clique em Aplicar para visualizar as modificações realizadas nesta aba e em OK para salvá-las.
E3Chart 348
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
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))
349 E3Chart
Exemplo de uso da referência visual
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
E3Chart 350
OPÇÃO DESCRIÇÃO
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.
Cor do Fundo Define a cor de fundo usada em uma Pena do tipo Área.
Esta opção equivale à propriedade BkColor da Pena
351 E3Chart
OPÇÃO DESCRIÇÃO
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
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 352
Opções disponíveis na aba Geral
OPÇÃO DESCRIÇÃO
Nome da pena Indica o nome da Pena. Esta opção equivale à
propriedade Name da Pena
Aba Dados
Esta aba contém informações de acordo com o tipo da Pena.
353 E3Chart
OPÇÃO DESCRIÇÃO
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
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 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
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.
E3Chart 354
Aba Estilo das propriedades da Pena
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
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
355 E3Chart
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 fundo do alarme Cor do fundo da Pena quando em alarme. Esta opção
equivale à propriedade LimitPenBkColor da Pena
E3Chart 356
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.
357 E3Chart
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
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 358
Aba Estatísticas das propriedades da Pena
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.
359 E3Chart
Objeto Legenda em tempo de execução
A aba Legenda permite configurar as informações referentes ao objeto Legenda e as respectivas Colunas.
E3Chart 360
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
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
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
361 E3Chart
NOME VALOR DESCRIÇÃO
Description 5 Mostra a descrição contida na
propriedade DocString da Pena
Ao clicar em Mais Configurações, a janela Configurações da Legenda é mostrada, conforme a figura a seguir.
E3Chart 362
As opções disponíveis na aba Geral desta janela estão descritas na tabela a seguir.
Opções disponíveis na aba Geral
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 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
Cor do fundo das colunas Define a cor de fundo das Colunas do cabeçalho da
Legenda. Esta opção equivale à propriedade
HeaderBackColor da Legenda
Estilo da borda das colunas Define o estilo das bordas das Colunas do cabeçalho da
Legenda. Esta opção equivale à propriedade
HeaderBorderStyle da Legenda
363 E3Chart
OPÇÃO DESCRIÇÃO
Cor do texto das colunas Define a cor do texto das Colunas do cabeçalho da
Legenda. Esta opção equivale à propriedade
HeaderTextColor da Legenda
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
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
Consulta.
E3Chart 364
20.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 E3.
365 E3Chart
20.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.
1. Crie um E3Chart em uma Tela.
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 E3 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 E3 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.
E3Chart 366
3. Crie dois Botões de Comando na Tela. No primeiro, mude a propriedade Caption para "Desabilitar Visualização da
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.
Sub CommandButton1_Click()
Set Pen1= Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Visible = False
End Sub
5. No segundo Botão de Comando, mude a propriedade Caption para "Habilitar Visualização da Pena".
6. Abra a Janela de Propriedades deste Botão de Comando e selecione a aba Scripts. No evento Click, digite o script
a seguir.
Sub CommandButton2_Click()
Set Pen1 = Screen.Item("E3Chart1").Pens.Item("Pena1")
Pen1.Visible = True
End Sub
367 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
E3Chart 368
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.
369 E3Chart
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
Info: Consulta inicializando A consulta está iniciando. Nesta fase são validados os
campos informados na Pena
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
Erro: Consulta inválida (QueryName = 'Nome da A consulta indicada pela propriedade QueryName da
Consulta') Pena não foi encontrada pelo E3Chart
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
E3Chart 370
MENSAGEM SIGNIFICADO
Falha ao pegar os dados do servidor Não foi possível trazer do servidor os registros da
consulta
371 E3Chart
CAPÍTULO
TrendAnalysis
21
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 E3. 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 E3 Viewer. A janela resultante pode ser vista nas figuras a seguir.
Aba Exibições
TrendAnalysis 372
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.
373 TrendAnalysis
21.1 Aba Exibições
Esta aba mostra as Penas correspondentes aos dados disponíveis na aba Conexões. Ao clicar com o botão direito do
mouse em uma Exibição, o menu contextual da figura a seguir é mostrado, e as opções disponíveis estão descritas na
tabela a seguir.
Mostrar Linhas da Grade Mostra ou esconde as linhas de grade na área das Penas
Mostrar Legenda Local Mostra uma legenda com o nome da Pena e a respectiva
cor
Janela Legenda
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Legenda
OPÇÃO DESCRIÇÃO
Disponível(eis) Colunas disponíveis para visualização. Consulte a tabela a
seguir para mais informações sobre estas colunas
TrendAnalysis 374
OPÇÃO DESCRIÇÃO
Remover Remove a coluna selecionada da lista Selecionada(s)
375 TrendAnalysis
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.
· O valor da coluna Média baseia-se em dados que, em níveis de zoom muito pequenos, podem estar comprimidos,
desta forma podendo alterar o valor efetivamente calculado.
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 em uma Pena, o menu contextual da figura a seguir é mostrado, e as opções
disponíveis estão descritas na tabela a seguir.
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
Adicionar Linha Guia Horizontal Associada Adiciona uma Linha Guia Horizontal associada a esta
Pena automaticamente
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.
TrendAnalysis 376
Janela Editar
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Editar
OPÇÃO DESCRIÇÃO
Título Permite alterar o título 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.
377 TrendAnalysis
Janela Detalhes
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Detalhes
OPÇÃO DESCRIÇÃO
Conexão Mostra o nome da conexão da Pena
Também é possível editar as Escalas vertical, Numérica, e horizontal, de Tempo, de uma Exibição. A figura a seguir
mostra o menu contextual com as opções disponíveis para a Escala Numérica.
TrendAnalysis 378
Janela Escala Numérica
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Escala Numérica
OPÇÃO DESCRIÇÃO
Título Título da Escala Vertical
A figura a seguir mostra o menu contextual com as opções disponíveis para a Escala de Tempo.
379 TrendAnalysis
Janela Escala de Tempo
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Escala de Tempo
OPÇÃO DESCRIÇÃO
Início Data e hora iniciais mostradas na Escala de Tempo
NOTA
Para adicionar ou excluir Escalas Numéricas, use as opções e junto à Escala. Não é possível excluir a Escala
Numérica original nem é possível adicionar ou excluir a Escala de Tempo. Para criar novas Escalas de Tempo,
adicione uma nova Exibição.
Janela Marcador
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Marcador
OPÇÃO DESCRIÇÃO
Nome Nome do marcador
TrendAnalysis 380
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, o menu contextual da figura a seguir é mostrado, e as
opções disponíveis estão descritas na tabela a seguir.
Aplicar a Todas Não Agrupadas Aplicar este Marcador a todas as Exibições que não são
parte de um agrupamento
NOTA
Viewers de versões anteriores à versão 6.5 não têm acesso a Tags remotos.
381 TrendAnalysis
Ao clicar com o botão direito do mouse na área de uma Exibição, o menu contextual da figura a seguir é mostrado,
em que é possível selecionar as opções descritas na tabela a seguir.
TrendAnalysis 382
OPÇÃO DESCRIÇÃO
Adicionar Linha Guia Horizontal Adiciona uma linha guia horizontal na Exibição. Para mais
informações sobre esta opção, consulte o texto mais
adiante
Adicionar Linha Guia Vertical Adiciona uma linha guia vertical na Exibição. Para mais
informações sobre esta opção, consulte o texto mais
adiante
Ao selecionar a opção Pesquisar, o menu contextual da figura a seguir é mostrado, e as opções disponíveis estão
descritas na tabela a seguir.
Opções de pesquisa
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
Manter Último Ponto de Pesquisa Permite que o ponteiro do mouse permaneça fixo na tela
durante uma pesquisa
383 TrendAnalysis
Janela Exportar
As opções disponíveis nesta janela estão descritas na tabela a seguir.
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
TrendAnalysis 384
Opções disponíveis na janela de edição de uma Exibição
OPÇÃO DESCRIÇÃO
Título Título da Exibição
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
Janela Opções
As opções disponíveis nesta janela estão descritas na tabela a seguir.
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
385 TrendAnalysis
OPÇÃO DESCRIÇÃO
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)
As Linhas Guias Horizontais e Verticais são parte de um conjunto de funcionalidades que auxilia o analista no
processo de análises visuais sobre os dados. A principal função das Linhas Guias é facilitar a identificação visual dos
períodos em que os dados ultrapassam os limites definidos pelas Linhas.
Para adicionar uma Linha Guia Horizontal, clique com o botão direito do mouse na área de um Display e selecione a
opção Adicionar Linha Guia Horizontal. Para mover a Linha Guia Horizontal, clique e arraste-a para a posição
desejada. Para editar, clique com o botão direito do mouse na Linha Guia e selecione a opção Editar para mostrar a
janela da figura a seguir.
Para adicionar uma Linha Guia Vertical, clique com o botão direito do mouse na área de um Display e selecione a
opção Adicionar Linha Guia Vertical. Para mover a Linha Guia Vertical, clique e arraste-a para a posição desejada.
Para editar, clique com o botão direito do mouse na Linha Guia e selecione a opção Editar para mostrar a janela da
figura a seguir.
TrendAnalysis 386
Janela de edição de uma Linha Guia Vertical
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Editar de uma Linha Guia Vertical
OPÇÃO DESCRIÇÃO
Valor Valor da posição da Linha Guia em relação à Escala
Horizontal ou de Tempo
Tanto as Linhas Guias Horizontais quanto as Verticais podem ser copiadas e coladas em outros Displays. Para isto,
clique com o botão direito do mouse na Linha Guia e selecione a opção Copiar Linha Guia. Após, clique com o botão
direito do mouse no Display desejado e selecione a opção Colar Linha Guia Horizontal ou Colar Linha Guia
Vertical, conforme o caso. Para remover uma Linha Guia, clique com o botão direito do mouse na Linha Guia desejada
e selecione a opção Remover Linha Guia. Para travar uma Linha Guia Horizontal ou Vertical em uma determinada
posição, clique com o botão direito do mouse na Linha Guia desejada e selecione a opção Travar Posição da Linha
Guia.
Também é possível adicionar uma Linha Guia Horizontal associada a uma Pena. Para isto, clique com o botão direito
do mouse na Pena desejada e selecione a opção Adicionar Linha Guia Horizontal Associada. Neste caso, a Linha
Guia se move automaticamente para o valor médio, mínimo ou máximo da Pena associada. A janela de edição deste
tipo de Linha Guia, disponível na opção Editar do menu contextual, contém a opção adicional Tipo, mostrada na
janela a seguir.
387 TrendAnalysis
Janela de edição de uma Linha Guia Horizontal associada a uma Pena
As opções disponíveis para a Linha Guia Horizontal associada a uma Pena são Mínimo: A Linha Guia se move
automaticamente com o valor mínimo, Média: A Linha Guia se move automaticamente com o valor médio ou Máximo:
A Linha Guia se move automaticamente com o valor máximo.
NOTAS
· A largura de desenho das Linhas Guias Horizontais e Verticais é independente da resolução de tela do dispositivo
em uso.
· O valor da opção Média sempre corresponde à média dos valores efetivamente mostrados na Exibição, que pode
ser diferente da média dos valores requisitados para os Tags.
Cada Exibição pode conter uma ou mais Áreas de Desenho (Plot Areas). Uma Área de Desenho agrupa Penas e
Escalas Verticais dentro de uma mesma Exibição. Para todas as Áreas de Desenho é usado o mesmo Eixo de Tempo,
que é único para uma Exibição.
Quando o ponteiro do mouse está sobre uma área da Exibição, as opções e são mostradas abaixo da legenda
e permitem, respectivamente, adicionar ou remover uma Área de Desenho. A opção de adicionar empilha uma nova
Área de Desenho na Exibição e a opção de remover apaga a Área de Desenho do topo da Exibição. As Penas e Eixos
associados à Área de Desenho são também removidos.
NOTAS
· Caso deseje manter as Penas usadas em uma Área de Desenho, arraste-as para outra Área de Desenho ou para
outra Exibição antes de removê-las.
· Áreas de Desenho, por padrão, são removidas na ordem inversa de inserção ao usar a opção . Para remover
uma Área de Desenho específica, clique com o botão direito do mouse na Área e selecione a opção Remover
Área de Desenho.
TrendAnalysis 388
ATALHO DE TECLADO DESCRIÇÃO
CTRL + F6 Navega entre as Penas do eixo vertical selecionado
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
389 TrendAnalysis
ATALHO DE TECLADO DESCRIÇÃO
Sinal de menos (-) Executa uma operação de zoom out do eixo vertical
selecionado
Tecla de aplicação ou de menu Abre o menu contextual do item selecionado nas abas
Exibições, Marcadores e Conexões
TrendAnalysis 390
CAPÍTULO
E3Playback
22
Uma ferramenta de playback visa facilitar o pós-operação, sobretudo a análise de ocorrências. A 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 no 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.
391 E3Playback
2. Abra a Lista de Propriedades e configure a propriedade DBServer do E3Playback para apontar para o objeto
Banco de Dados que contém os dados históricos da aplicação.
E3Playback 392
Pick Abrir Tela
393 E3Playback
Tela de playback
7. Clique em para entrar no modo Online. Os primeiros dados de playback são carregados, e o relógio de
playback é posicionado no centro dos dados disponíveis.
E3Playback 394
· Área de Telas
· Lista de Eventos
· Lista de Tags
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
395 E3Playback
Janela Opções de gravação
As opções disponíveis nesta janela estão descritas na tabela a seguir.
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)
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
E3Playback 396
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
Configurar (gravação de áudio) Mostra uma janela que permite alterar o formato de
gravação e os atributos do áudio
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
397 E3Playback
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 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
22.3.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
E3Playback 398
OPÇÃO AÇÃO
Editar Marcador Selecionado Permite editar o marcador selecionado, podendo alterar
data e hora, nome ou descrição
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.
399 E3Playback
Área de Telas
A Área de Telas funciona como se fosse um Elipse E3 Viewer dentro do E3Playback. As Telas são sempre abertas no
zoom Preencher. É possível navegar livremente entre as Telas da aplicação.
Existem algumas restrições e comentários quanto ao funcionamento das Telas dentro do E3Playback:
· As Telas funcionam como se estivessem em um Elipse E3 Viewer Somente Leitura, isto é, não é permitido o envio
de comandos e valores para o servidor Elipse E3. Isto garante que as operações efetuadas no E3Playback não
vão perturbar o funcionamento da aplicação 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 E3 Viewer real. Para isto é criada uma nova cópia do objeto Elipse E3 Viewer e os
Tags para uso do E3Playback. Se algum comportamento específico do Elipse E3 Viewer tem 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 pela aplicação como novas abas no topo da Área de Telas. O título
da aba é o nome do Quadro ou Tela que foi aberto
E3Playback 400
· 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.
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
401 E3Playback
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
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
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
E3Playback 402
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"
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.
403 E3Playback
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 E3 Studio), o período permitido para playback se resume às
últimas seis horas de dados armazenados no banco de dados.
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 dados carregados.
E3Playback 404
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
22.5.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 E3 já cria automaticamente nas tabelas de Storage os índices necessários para otimizar as consultas do
E3Playback.
22.5.2 Alarmes
Para executar o playback de alarmes, siga estes procedimentos:
1. Habilite ou configure o registro de alarmes em disco.
2. Selecione os seguintes campos para registro (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
405 E3Playback
Seleção dos campos
O Elipse E3 já cria automaticamente na tabela de alarmes os índices necessários para otimizar as consultas de
playback.
22.5.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:
E3Playback 406
22.5.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 E3 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 da aplicação 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 E3 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 E3, consulte o tópico Limitações do Modo Demonstração.
407 E3Playback
CAPÍTULO
Fórmulas
23
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, tais como
laranja, uva ou tangerina. 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, como por exemplo 50 g de açúcar, 1000 l de água ou
polpa de fruta. Para utilizar este recurso, siga este procedimento:
1. Clique com o botão direito do mouse no nome do projeto no modo Explorer e selecione a opção Inserir -
Fórmula. 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 Fórmula em e logo após o nome do projeto.
NOTA
O objeto Fórmula pode ser configurado para funcionar como Área de Alarme.
23.1 Configurações
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.
Fórmulas 408
Configuração do Banco de Dados e da tabela
As opções disponíveis nesta janela estão descritas na tabela a seguir.
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
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.
409 Fórmulas
Configurando um Banco de Dados
23.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 das restrições.
Aba Templates
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Fórmulas 410
Opções disponíveis na aba Templates
OPÇÃO DESCRIÇÃO
Nome Define o nome do Template
A barra de ferramentas da aba Templates contém as opções Adicionar , para a criação de um novo Template, e
Excluir , para a exclusão do Template selecionado.
Ao clicar em Restrições , a janela da figura a seguir é mostrada.
411 Fórmulas
OPÇÃO DESCRIÇÃO
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)
23.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
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Unidades
OPÇÃO DESCRIÇÃO
Nome Determina o nome do Template
A barra de ferramentas da aba Unidades contém as opções Adicionar , para a criação de uma nova Unidade,
Excluir , 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.
Aba Valores
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Fórmulas 412
Opções disponíveis na aba Valores
OPÇÃO DESCRIÇÃO
Nome Determina o nome do Template
A barra de ferramentas da aba Valores contém as opções Adicionar , para a criação de um novo Conjunto de
Valores, Excluir , para a exclusão do Conjunto de Valores selecionado, e Renomear , para a troca do nome do
Conjunto de Valores selecionado.
23.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".
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 desta Pasta as Pastas "Maquina1" e "Maquina2". Dentro destas Pastas crie os Tags Internos
mostrados na figura a seguir.
413 Fórmulas
Criando Tags
5. Crie na Fórmula as Unidades "Maquina1" e "Maquina2". Associe cada campo destas Unidades aos Tags criados
anteriormente.
Fórmulas 414
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 de Comando 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.
Sub CommandButton1_Click()
Application.LoadFormulaDlg_
"Formula1", "Maquina1, Maquina2",_
"Modelo1, Modelo2, Modelo3, Modelo4"
End Sub
Formula1 é o nome do objeto Fórmula criado e o método LoadFormulaDlg é um método do Viewer. Ao executar este
método, a caixa de diálogo da figura a seguir é mostrada.
415 Fórmulas
Caixa de diálogo do método LoadFormulaDlg
10. Na divisão da direita são apresentadas as 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.
11. Através deste Botão, pode-se visualizar 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 de Comando com o título "OK". Junto ao SetPoint, posicione um
texto de identificação com o título "Modelo:". Neste Botão deve ser criado o script a seguir.
Sub CommandButton2_Click()
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo1"
Screen.Item("Texto16").Value
End Sub
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 os 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. É definida uma opção pelo modo
silencioso na Tela, utilizando para isto um objeto Caixa de Seleção.
1. Crie um objeto Caixa de Seleção na Tela.
2. Coloque um texto de identificação ao lado, com o texto "Silencioso".
3. Volte ao script do Botão OK e mude o script para o código a seguir.
Fórmulas 416
Sub CommandButton2_Click()
If Screen.Item("CheckBox1").Value = true Then
Application.LoadFormulaValuesQuiet_
"Formula1", "Maquina1", "Modelo1"
Application.LoadFormulaValuesQuiet_
"Formula1", "Maquina1", "Modelo2"
Application.LoadFormulaValuesQuiet_
"Formula1", "Maquina1", "Modelo3"
Application.LoadFormulaValuesQuiet_
"Formula1", "Maquina1", "Modelo4"
Else
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo1"
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo2"
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo3"
Application.LoadFormulaValues_
"Formula1", "Maquina1", "Modelo4"
End If
End Sub
CheckBox1 é o nome da Caixa de Seleção criada. Isto permite que, se o objeto está habilitado, seja utilizado o
método LoadFormulaValuesQuiet. Caso contrário, é utilizado o método LoadFormulaValues.
4. 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.
417 Fórmulas
Tela final da Fórmula
5. Execute a aplicação e observe os resultados.
Fórmulas 418
CAPÍTULO
Relatórios
24
Um 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 bancos de dados, tais como Alarmes, Históricos,
Consultas e Fórmulas. Estes dados podem ser impressos tanto em formato texto como em formato gráfico, e neste
caso é realizado através de um objeto E3Chart.
NOTAS
· O objeto Relatório foi descontinuado. Este objeto não recebe mais atualizações e vai ser removido em uma versão
futura do Elipse E3. Recomenda-se o uso do objeto Relatório de Seção no lugar deste objeto.
· O objeto Relatório de Seção está disponível tanto na versão 64 bits quanto na versão 32 bits do Elipse E3.
· O objeto Relatório NÃO está disponível na versão 64 bits do Elipse E3. Entretanto, o Relatório pode ser editado
na versão 32 bits do Elipse E3 Studio, presente na instalação 64 bits.
· Um Elipse E3 Viewer 32 bits conectado a um Servidor 64 bits imprime Relatórios normalmente.
Inserindo um Relatório
419 Relatórios
Mensagem de objeto descontinuado
4. Selecione a opção Não mostrar este aviso novamente caso deseje ocultar esta mensagem ao inserir novos
Relatórios.
24.2 Componentes
Um Relatório contém várias Seções. Cada Seção de um Relatório contém um grupo de controles que são processados
e impressos ao mesmo tempo, como uma unidade.
Seções do Relatório
Um Relatório define tipos de Seções, que são explicados nos tópicos a seguir.
24.2.1 Detail
A Seção Detail é o corpo de um Relatório, que imprime uma vez para cada registro da fonte de dados.
Relatórios 420
24.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 um grupo são inseridas imediatamente antes e depois da Seção Detail. O número de
vezes que uma Seção de um grupo pode imprimir depende de como os dados são agrupados. Um Relatório inicia
um novo grupo (Header, Detail e Footer) para cada mudança nos dados que são reunidos naquele grupo.
NOTA
Uma Seção Report Header pode estender-se por múltiplas páginas. Para isto, insira um objeto Quebra de Página
no conteúdo.
24.3 Configurações
Um 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 em um Relatório para mostrar um menu contextual. As opções deste menu
variam de acordo com o local do clique do mouse.
NOTA
Para um Relatório de Seção, as opções descritas neste tópico estão disponíveis na respectiva barra de ferramentas.
Na área de um Relatório, somente as opções Insert e Delete Section estão habilitadas, conforme a figura a seguir.
Menu da área de um
Relatório
421 Relatórios
Em um objeto de um 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 de um
Relatório
Em mais de um objeto selecionado em um Relatório, todas as opções de menu estão habilitadas, conforme a tabela a
seguir.
Opções disponíveis no menu contextual de um Relatório
OPÇÃO DESCRIÇÃO
Insert Permite inserir um novo componente de Relatório. As
opções disponíveis são Group Header/Footer: Adiciona
um novo par de cabeçalhos ou rodapés de grupo em um
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 em um Relatório
Delete e Delete Section Apaga a Seção, objeto ou grupo selecionado. Esta opção
não é aplicada na Seção Detail de um Relatório
Relatórios 422
OPÇÃO DESCRIÇÃO
Horizontal Spacing Determina o espaçamento horizontal de um objeto em
um 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
Quando a opção Format Border ou Format Pane Border é selecionada, a caixa de diálogo da figura a seguir é
mostrada.
423 Relatórios
Através da barra de ferramentas de um Relatório é possível acessar os recursos descritos nos próximos tópicos.
Relatórios 424
OPÇÃO DESCRIÇÃO
Previous Page e Next Page Move para a página anterior ou para a próxima
página, respectivamente
Ao selecionar a opção Pré-Visualizar Relatório do Relatório de Seção, pode-se configurar as opções mostradas
na figura a seguir.
Single page view Permite visualizar apenas uma página por vez
425 Relatórios
OPÇÃO DESCRIÇÃO
Previous page Vai para a página anterior
Relatórios 426
OPÇÃO DESCRIÇÃO
Gutter Determina a margem da página
A figura a seguir mostra a aba Page Setup para um Relatório de Seção. As opções são as mesmas descritas na tabela
anterior.
427 Relatórios
Opções de configuração Printer Settings (Impressora)
OPÇÃO DESCRIÇÃO
Paper Size Determina o tamanho do papel
A figura a seguir mostra a aba Printer Settings para um Relatório de Seção. Nesta aba, a opção Paper Source
corresponde à opção PaperBin da tabela anterior.
Relatórios 428
Configurações da grade do Relatório
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções de configuração Grid Settings (grade)
OPÇÃO DESCRIÇÃO
Show Grid Habilita ou desabilita a grade
429 Relatórios
Configurações de estilo de um Relatório
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções de configuração Styles (estilos)
OPÇÃO DESCRIÇÃO
New / Delete / Lista Determina o estilo de um Relatório. Pode-se inserir um
novo estilo clicando em New, apagar um estilo clicando
em Delete ou utilizar os estilos existentes na lista
A figura a seguir mostra a aba Styles para um Relatório de Seção. Nesta aba, as opções são equivalentes às opções
descritas na tabela anterior, exceto pela opção Export styles to file, que permite exportar os estilos de um Relatório
de Seção para um arquivo com a extensão .reportstyle e posteriormente ser carregado em outro Relatório de Seção
usando a opção Import styles from file.
Relatórios 430
Aba Styles
NOTA
Importar um arquivo de estilo de um Relatório de Seção implica em sobrescrever todos os estilos configurados.
A aba Global Settings determina configurações gerais da área de desenho, e está disponível apenas para Relatórios
de Seção.
431 Relatórios
Opções disponíveis na aba Global Settings
OPÇÃO DESCRIÇÃO
Snap Lines Permite usar linhas de ajuste à grade ou não para alinhar
controles
Show Delete Prompt Selecione esta opção para mostrar uma mensagem de
aviso ao apagar um parâmetro ou campo calculado
Relatórios 432
Editor de Scripts de um Relatório de Seção
NOTAS
· Ao clicar em Script Editor na barra de ferramentas de um Relatório, abre-se uma nova janela. Já para os
Relatórios de Seção, a aba Design dos scripts é aberta na mesma janela do Editor.
· O script padrão do evento ReportStart de um Relatório de Seção, mostrado na figura anterior, deve ser mantido
para o correto funcionamento deste controle.
· O Relatório de Seção NÃO utiliza Active Scripting como linguagem de programação, apenas o Visual Basic .NET.
Para mais informações sobre as particularidades de uso desta linguagem de programação no Elipse E3, consulte
o objeto E3ApplicationLink no Manual de Referência e Scripts do Elipse E3.
Na opção Object é necessário especificar o objeto onde se deseja criar o script e, na opção Event, o evento do
Relatório ou Relatório de Seção em que ocorre a ação.
NOTA
Tanto o Relatório quanto o Relatório de Seção carregam arquivos no formato RPX. Entretanto, recursos inexistentes
ou incompatíveis em um tipo ou outro de Relatório são descartados ao carregar em outro Relatório.
NOTA
Tanto o Relatório quanto o Relatório de Seção carregam arquivos no formato RPX. Entretanto, recursos inexistentes
ou incompatíveis em um tipo ou outro de Relatório são descartados ao carregar em outro Relatório.
24.3.6 Objetos
Esta seção contém informações sobre os objetos que podem ser usados em um Relatório.
433 Relatórios
Caixa de seleção
Após ser inserido em um Relatório, este objeto é chamado de "CheckBox".
Campo de Dados
Após ser inserido em um Relatório, este objeto é chamado de "Field".
Código de
barras
Após ser inserido em um Relatório, este objeto é chamado de "Barcode".
NOTA
Consulte a propriedade Style do objeto Relatório de Seção para mais informações sobre os estilos de códigos de
barras disponíveis para este objeto.
24.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.
Relatórios 434
E3Chart
NOTAS
· Um objeto E3Chart não pode ser adicionado na Seção Detail de um Relatório. Um Relatório de Seção, por outro
lado, permite adicionar um E3Chart na Seção Detail, embora não seja recomendado por sobrecarregar a
execução do Relatório de Seção.
· Para configurar um objeto E3Chart em um Relatório de Seção, use a opção Propriedades do menu contextual
deste objeto no Organizer.
· Um Relatório de Seção também permite configurar Penas Automáticas, além de Tags em tempo real e dados
históricos.
NOTA
Um E3Chart incluído em um Relatório de Seção pode ser acessado externamente via scripts em uma aplicação. Para
mais informações, consulte o objeto E3ApplicationLink no Manual de Referência e Scripts do Elipse E3.
24.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 em um Relatório, este objeto é chamado de "Shape".
24.3.6.6 Figura
O objeto Figura permite mostrar imagens que estejam armazenadas em arquivos, tanto em arquivos externos como
em arquivos de recurso de uma aplicação.
435 Relatórios
Figura
Após ser inserido em um Relatório, este objeto é chamado de "Image".
24.3.6.7 Linha
O objeto Linha liga dois pontos quaisquer. Permite o desenho de retas, através de dois pontos especificados na
criação ou em polígonos.
Linha
Após ser inserido em um Relatório, este objeto é chamado de "Line".
24.3.6.8 Quadro
O objeto Quadro é composto de linhas e colunas onde são inseridos textos ou gráficos. Os Quadros de 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 em um Relatório, este objeto é chamado de "Frame".
NOTA
O objeto Quadro não está disponível em Relatórios de Seção.
Quebra de Página
Relatórios 436
24.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.
Retângulo
Após ser inserido em um Relatório, este objeto é chamado de "Shape".
Retângulo arredondado
Após ser inserido em um Relatório, este objeto é chamado de "Shape".
24.3.6.12 Texto
O objeto Texto possibilita a criação de um texto. Ao definir a área em um Relatório, pode-se digitar diretamente o
texto desejado, que aceita também múltiplas linhas.
Texto
Após ser inserido em um Relatório, este objeto é chamado de "Label".
Estas áreas podem ser acessadas clicando com o botão direito do mouse em um Relatório e selecionando a opção
Insert.
437 Relatórios
24.4.2 Configuração da Consulta
Para a extração de dados de um banco de dados, é necessário configurar a Consulta de um Relatório. Podem existir
várias Consultas diferentes para um mesmo Relatório, mas apenas uma pode estar ativa em determinado momento.
Para isto, siga estes procedimentos:
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".
24.4.4 Visualização
É possível executar a visualização de um Relatório 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.
Relatórios 438
TIFF|Texto(CSV)")
Case 1
Report.Export "PDF", "c:\correio\reports\report.pdf"
MsgBox "Exportado para PDF!"
Case 2
Report.Export "EXCEL", "c:\correio\reports\report.xls"
MsgBox "Exportado para XLS!"
Case 3
Report.Export "HTML", "c:\correio\reports\report.html"
MsgBox "Exportado para HTML!"
Case 4
Report.Export "RTF", "c:\correio\reports\report.rtf"
MsgBox "Exportado para RTF!"
Case 5
Report.Export "TEXT", "c:\correio\reports\report.txt"
MsgBox "Exportado para Texto (CSV)!"
Case 6
Report.Export "TIFF", "c:\correio\reports\report.tiff"
MsgBox "Exportado para TIFF!"
Case 7
Set reportFilter = report.GetExportFilter("TEXT")
reportFilter.FileName="c:\correio\reports\_
report2.txt"
reportFilter.TextDelimiter = ","
report.Export reportFilter
MsgBox "Exportado para TXT usando filtro!"
End Select
End Sub
Campo N
· Name: txtPageNumber
· SummaryGroup: GroupHeader1
· SummaryRunning: 1 - ddSRGroup
· SummaryType: 4 - ddSMPageCount
Campo M
· Name: txtPageCount
· SummaryGroup: GroupHeader1
· SummaryType: 4 - ddSMPageCount
439 Relatórios
· 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
· SummaryRunning: 1 - ddSRGroup
· SummaryType: 1 - ddSGrandTotal
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 é 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.
Relatórios 440
CAPÍTULO
Segurança
25
Através desta opção é possível controlar o acesso a Domínios, Elipse E3 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 e grupos, selecione
o menu Arquivo - Usuários.
Caso a aplicação não tenha nenhum usuário configurado como administrador, a janela da figura a seguir é mostrada,
indicando a necessidade de se criar pelo menos um usuário deste tipo.
441 Segurança
Por padrão, a lista de usuários ou grupos é ordenada pelo nome do usuário ou grupo à medida que são criados.
Para modificar esta ordem, clique em uma coluna para torná-la a coluna primária de ordenação. Clique novamente na
coluna para inverter o sentido de ordenação, ascendente ou descendente. Os tópicos a seguir descrevem as opções
disponíveis nesta janela.
NOTA
O usuário administrador, que deve sempre ser criado em uma aplicação nova para que o controle de usuários
possa ser realizado, sempre tem todas as permissões concedidas, independente das configurações do item
Permissões Padrão.
Para cada item na aba Permissões, existe uma série de permissões que podem ser configuradas para cada usuário.
As opções disponíveis estão descritas nas tabelas a seguir.
Opções disponíveis para Domínios
OPÇÃO DESCRIÇÃO
Executar Domínio Habilita a execução de um Domínio. O valor padrão
desta opção é Não Permitido
Segurança 442
OPÇÃO DESCRIÇÃO
Executar como serviço Habilita a execução de um Domínio como um serviço. O
valor padrão desta opção é Não Permitido
Escrever pelo Studio em propriedades em tempo de Habilita a escrita na coluna de valores das propriedades
execução na janela WatchWindow em tempo de execução. O valor
padrão desta opção é Não Permitido
Cada item da lista de permissões padrão pode estar configurado com um dos estados da tabela a seguir.
Estados possíveis para o item Permissões Padrão
ESTADO DESCRIÇÃO
Permitido A opção é permitida para todos os usuários ou grupos
que automaticamente herdam as permissões definidas
no item Permissões Padrão
NOTAS
· Ao abrir uma aplicação criada na versão 6.5 na versão 6.6, todas as opções do item Permissões Padrão são
permitidas.
· Ao abrir uma aplicação criada na versão 6.1 ou anteriores na versão 6.6, as opções do item Permissões Padrão
são permitidas, exceto a opção Configurar usuários/grupos, que é sempre negada.
· A conversão de uma aplicação criada na versão 6.5 ou anteriores e aberta na versão 6.6 só é efetivada quando
alguma opção do item Permissões Padrão é alterada e salva.
443 Segurança
25.2 Usuários
O item Usuários permite configurar as informações referentes aos usuários que têm ou não acesso à uma aplicação.
As opções disponíveis neste item estão descritas na tabela a seguir.
Opções disponíveis no item Usuários
OPÇÃO DESCRIÇÃO
Novo Cria um novo usuário
Ao selecionar a opção Autenticação do Windows, a janela Adicionar Usuário é alterada para permitir a seleção de
usuários de um domínio de rede do Windows, conforme a figura a seguir.
Segurança 444
Janela Adicionar Usuário com autenticação do Windows
Ao clicar em Procurar, a janela da figura a seguir é mostrada, permitindo procurar por um domínio do Windows e
então selecionar um usuário deste domínio.
445 Segurança
Aba Informações do Usuário
Na aba Informações do Usuário, além das opções já descritas na janela Adicionar Usuário, é possível indicar se um
usuário é administrador selecionando a opção Este usuário é um administrador e alterar a senha atual clicando em
Alterar a senha. Neste caso, a janela da figura a seguir é aberta.
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.
· Sempre que um usuário troca a senha, é realizado um logout de todas as sessões onde este usuário estava
logado, exceto da sessão onde foi realizada a troca de senha.
Na aba Grupos, mostrada na figura a seguir, é possível informar a quais grupos de usuários este usuário deve
pertencer. Para isto, selecione um grupo na listagem Grupos disponíveis e clique em Adicionar para mover este
grupo para a listagem Pertence a. Para remover um grupo desta lista, clique em Remover.
Segurança 446
Aba Grupos
Na aba Propriedades de Segurança, mostrada na figura a seguir, é possível especificar diversas propriedades
relacionadas à segurança de um usuário.
447 Segurança
Aba Propriedades de Segurança
As opções disponíveis nesta aba estão descritas na tabela a seguir.
NOTA
A indicação (Herdado) nas opções disponíveis desta aba significa que o valor daquela opção é herdado do grupo
ao qual o usuário pertence ou herdado do sistema. A indicação (Por padrão) significa que o valor é o padrão para
aquela opção.
Permitir mudar senha expirada Permite que este usuário troque imediatamente a senha
expirada
Segurança 448
OPÇÃO DESCRIÇÃO
Duração mínima de senha Indica se há um tempo mínimo em dias para que a 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 deste usuário deve ter um tamanho
mínimo de caracteres. Caso esta opção esteja habilitada,
configure no item Mínimo de caracteres um número
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 deste usuário 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 deste usuário deve ter um número
mínimo de letras. Caso esta opção esteja habilitada,
configure no item Mínimo de letras um número mínimo
de letras para a senha
Mínimo de caracteres especiais na senha Indica se a senha deste usuário 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 número mínimo de caracteres especiais
para a senha
Caracteres maiúsculos e minúsculos Indica que a senha deste usuário deve conter caracteres
em maiúsculas e em minúsculas
Não diferenciar maiúsculas de minúsculas Indica que a validação da senha deste usuário é realizada
sem diferenciar entre caracteres em maiúsculas de
caracteres em minúsculas. Não é recomendado habilitar
esta opção
Conta bloqueada Indica que a conta deste usuário está bloqueada. Esta
opção é habilitada automaticamente caso a senha expire
ou caso este usuário digite 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
Na aba Permissões, mostrada na figura a seguir, é possível especificar as permissões deste usuário para Domínios,
Elipse E3 Viewers, Telas e Alarmes. Uma verificação de permissão consiste em uma informação que um usuário tem
sobre um comando que atua sobre um objeto específico.
449 Segurança
Aba Permissões
Para cada item de segurança existe uma série de permissões que podem ser configuradas para cada usuário. As
opções disponíveis estão descritas nas tabelas a seguir.
NOTAS
· Usuários administradores têm todas as permissões habilitadas por padrão e este comportamento não pode ser
alterado. Portanto, as opções disponíveis nos itens de segurança Domínio, Viewer, Telas e Alarmes sempre
mostram o estado Permitido para este tipo de usuário.
· Consulte o tópico Permissões Padrão para informações sobre permissões que são herdadas automaticamente
por novos usuários ou grupos.
Escrever pelo Studio em propriedades em tempo de Habilita a escrita na coluna de valores das propriedades
execução na janela WatchWindow em tempo de execução
Segurança 450
NOTA
A partir da versão 6.0, aplicações criadas em versões anteriores são abertas no Elipse E3 Studio com a permissão
Escrever pelo Studio em propriedades em tempo de execução desabilitada por padrão.
Cada item da lista de permissões pode estar configurado com um dos estados da tabela a seguir.
Estados possíveis para permissões de um usuário
ESTADO DESCRIÇÃO
Permitido A opção é permitida para o usuário ou grupo
selecionado, independente dos grupos aos quais
pertence
Não Permitido pelo Grupo A opção não é permitida para o usuário ou grupo
selecionado, se não é permitida em pelo menos um dos
grupos aos quais o usuário ou grupo pertence
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.
451 Segurança
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 E3. Para isto, utilize os menus Arquivo - Login ou Arquivo - Logout.
A opção Login abre uma caixa de diálogo para o login no Elipse E3 Studio. O usuário permanece logado até que
seja realizado outro login ou logout.
A opção Logout executa o logout no Elipse E3 Studio. Caso não haja um usuário logado, esta opção está
desabilitada.
NOTAS
· Não é permitido remover todos os usuários administradores de um Domínio.
· Não é possível desmarcar a opção Este usuário é um administrador de todos os usuários de um Domínio.
· Administradores sempre podem alterar a própria senha, mesmo após o término do prazo de expiração.
· Administradores não são impedidos de executar login quando as contas estão desabilitadas ou bloqueadas.
· Se não há nenhum administrador configurado em um Domínio, como por exemplo ao abrir uma aplicação antiga
que não tenha um administrador cadastrado, a edição de usuários permanece desabilitada até que um
administrador seja adicionado.
· Usuários não administradores não têm permissão de editar usuários administradores ou de promover a si
mesmos ou outros usuários a administradores.
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.
Segurança 452
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, conforme a figura a seguir.
NOTA
Apenas administradores e usuários com a permissão Configurar usuários/grupos habilitada têm acesso ao método
UserAdministration do Viewer.
Ao selecionar um usuário e clicar em Excluir, a aplicação mostra uma caixa de mensagem questionando se realmente
deseja-se excluir aquele usuário.
25.3 Grupos
O item Grupos permite que sejam configuradas informações referentes a grupos. Cada grupo define características
que são comuns a 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. As opções disponíveis neste item
estão descritas na tabela a seguir.
Opções disponíveis no item Grupos
OPÇÃO DESCRIÇÃO
Novo Cria um novo grupo
453 Segurança
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Adicionar Grupo
OPÇÃO DESCRIÇÃO
Nome do grupo Nome deste grupo
Ao selecionar a opção Autenticação do Windows, a janela Adicionar Grupo é alterada para permitir a seleção de
grupos de um domínio de rede do Windows, de forma que os usuários destes grupos possam logar na aplicação,
conforme a figura a seguir.
Segurança 454
Aba Membros de um grupo do Windows
As opções disponíveis nesta aba estão descritas na tabela a seguir.
Opções disponíveis na aba Membros de um grupo do Windows
OPÇÃO DESCRIÇÃO
Membros não cadastrados no Elipse E3 Contém todos os usuários pertencentes ao grupo do
Windows selecionado e que não estão cadastrados no
Elipse E3
Ao clicar em Excluir, a aplicação mostra uma caixa de mensagem questionando se realmente deseja-se remover
aquele grupo.
É possível que um grupo de usuários pertença a outro grupo, 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.
455 Segurança
NOTA
É importante verificar a hierarquia entre usuários e grupos. Se um 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 está marcada como neutra ou herdada.
Proteção de arquivos
Os tipos de proteção disponíveis nesta janela sã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.
Segurança 456
Adicionar proteção
A opção Alterar senha altera a senha de proteção do Elipse E3 Studio para um arquivo, 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.
457 Segurança
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 E3 Studio, este inicializa mostrando um ícone
cinza , com um cadeado indicando que está protegido e o 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.
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 458
CAPÍTULO
Elipse E3 Viewer e WebViewer
26
O Elipse E3 Viewer é o ambiente de visualização do Elipse E3. Neste ambiente, é possível visualizar a execução de
aplicações criadas no Elipse E3 Studio.
O WebViewer é um componente ActiveX que permite que o Internet Explorer comporte-se como um Elipse E3
Viewer, o que habilita a visualização e controle de aplicações Elipse E3 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 funciona exatamente como o Elipse E3 Viewer, executando o download da
aplicação, tais como Telas e bitmaps, para o computador local. Todas as funcionalidades do Elipse E3 Viewer, tais
como E3Chart e E3Alarm, são suportadas pelo WebViewer.
NOTA
Tanto o Elipse E3 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 E3 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 E3.
É importante lembrar que, no caso de não haver usuário logado no Elipse E3 Viewer, ou seja, um 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 E3 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 E3 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 E3 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.
Quando o Elipse E3 Viewer é executado, a aplicação mostra a janela da figura a seguir, indicando o estado da
conexão.
O argumento nome_do_servidor representa o nome do computador 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 E3 Viewer é executado a partir do menu Iniciar do Windows, 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 E3 Viewer deve tentar conectar apenas no
modo Somente Leitura. Quando isto é realizado, o Elipse E3 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 E3 Viewer. Se
não é especificado, é usado o diretório temporário do sistema, ou seja, a variável de ambiente TEMP
Viewer [nome_do_servidor] –cachepath <diretorio>
· -useservers ou /useservers: Esta opção permite que o Elipse E3 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
E3 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 E3 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 E3 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
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 E3 Viewer,
como na figura a seguir
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();
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, conforme o exemplo a seguir.
<param name="Screen" value="Nome_da_tela">
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 este
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, conforme o exemplo a seguir.
<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, conforme o exemplo a seguir.
<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, conforme o exemplo a
seguir.
<param name="URLToLoad" value="URL">
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 outras aplicações, como por exemplo o Microsoft Office.
Os servidores e o WebViewer podem tanto executar no mesmo computador quanto em computadores diferentes. Os
tópicos a seguir mostram como estas situações se aplicam.
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 o computador cliente acessar o servidor pela primeira vez, caso o Elipse E3 não tenha sido
previamente instalado neste computador. Este arquivo pode ser obtido através de download no site da Elipse
Software.
O IIS ainda necessita ser configurado para o correto funcionamento. A configuração é diferente caso o IIS e o E3
Server estejam no mesmo computador ou em computadores diferentes. Para configurá-lo, consulte o Guia de
Instalação do Elipse E3.
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, o arquivo e3webviewer-x86-ptb.exe, no
servidor deve ser sempre o mais atual.
IMPORTANTE
Para executar uma aplicação redundante no Elipse E3, é necessário que todos os servidores executem a mesma
versão do produto, e tenham uma cópia local atualizada dos arquivos do Domínio, ou seja, os arquivos .prj e .lib,
entre outros. 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 só funciona se o E3 Server foi iniciado nos computadores envolvidos.
Se o usuário de um Elipse E3 Studio ou Hot-Standby é administrador do computador remoto onde o E3 Server está
executando, este pode controlar o serviço remotamente usando a aplicação services.msc, através da opção Action -
Connect to another computer.
27.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, ou seja, os arquivos .dom, .prj, e .lib, entre outros, no computador
principal e copie esta pasta para o computador em modo 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 .
467 Hot-Standby
Menu Domínio - Opções
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. Na opção Servidor principal, selecione o servidor principal do
projeto e, na opção Servidor de backup, selecione o servidor de backup. O Elipse E3 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 E3 é 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 E3 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 em modo Standby é mostrado um ícone
representado por duas barras amarelas , indicando que este computador está em modo Standby, ou modo de
espera.
Este servidor inicia os servidores do Domínio e depois é automaticamente fechado. Um Domínio pode ser iniciado
também através do Elipse E3 Studio. Para tanto, abra o Domínio e clique em na barra de ferramentas Padrão.
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 468
27.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 é colocado em manutenção, o servidor em
modo Standby passa para o estado ativo. Para recolocar o servidor no Domínio, desmarque a opção Em
manutenção deste servidor.
NOTA
Se a aplicação principal não consegue enviar os dados para o servidor em modo Standby, estes dados
permanecem armazenados localmente em disco, para posterior envio quando a comunicação entre os dois
computadores é restabelecida, assegurando assim a igualdade entre as tabelas geradas pela aplicação.
469 Hot-Standby
CAPÍTULO
Configurações Avançadas
28
Existem configurações do Elipse E3 que podem ser realizadas diretamente no Registro do Windows, embora este
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. Para mais informações, consulte o Manual do Usuário do E3
Tweak. O E3 Tweak pode ser aberto das seguintes formas:
· Pelo menu Iniciar do Windows
· Pelo menu Ferramentas - E3 Tweak do Elipse E3 Studio
· Pelo item Atalhos - E3 Tweak do menu do E3 Admin na Área de Notificação do Windows
29.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.
29.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 Elipse 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
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.
Login(Login, Password)
Este método executa um login no servidor Elipse 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 Elipse E3 ou Elipse Power do usuário indicado no método Login.
RegisterCallback(Path)
Este método é usado para monitorar as modificações ocorridas em alguma propriedade de um objeto instanciado no
servidor Elipse 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.
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.
29.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.
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 Elipse 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 Elipse E3 ou
Elipse Power.
30.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, consulte o tópico
Criando um Arquivo CSV Manualmente no capítulo Elipse E3 Studio.
SOLUÇÃO
As possíveis respostas à pergunta da mensagem de erro são as seguintes:
· 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), estes arquivos 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 nas Configurações do Windows, e confirme se o caractere separador é o mesmo
utilizado no arquivo CSV. DICA: Crie um Alarme no Elipse E3 e utilize a ferramenta de exportação, utilizando-o como
modelo para a geração dos novos Alarmes.
Como exibir as mensagens "Crítica", "Alta", "Média" e "Baixa" no campo Severidade de um Alarme
ao invés dos valores -2 (menos dois), 0 (zero), 1 (um) e 2 (dois) em uma consulta SQL?
A sintaxe SQL para cada um dos bancos de dados suportados pelo Elipse E3 é a seguinte:
· Access:
SELECT InTime, OutTime, Message, FormattedValue,
IIF(Severity = "-2", "Crítica",
IIF(Severity = "0", "Alta",
IIF(Severity = "1", "Média", "Baixa")))
AS Severidade FROM Alarms;
· SQL Server:
SELECT InTime, OutTime, Message, FormattedValue,
Severidade = CASE Severity
WHEN -2 THEN 'Crítica'
WHEN 0 THEN 'Alta'
WHEN 1 THEN 'Média'
WHEN 2 THEN 'Baixa' END
FROM Alarms;
· Oracle:
SELECT InTime, OutTime, Message, FormattedValue,
DECODE(Severity, -2, 'Crítica', 0, 'Alta', 1, 'Média', 2, 'Baixa')
Severidade FROM Alarms;
· MySQL ou PostgreSQL:
SELECT InTime, OutTime, Message, FormattedValue,
CASE WHEN Severity = '-2' THEN 'Crítica'
WHEN Severity = '0' THEN 'Alta'
WHEN Severity = '1' THEN 'Média'
WHEN Severity = '2' THEN 'Baixa' END
AS Severidade FROM Alarms;
30.2 Associações
Como criar um Tag Expressão no Elipse E3?
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 mover o ponteiro do mouse sobre este objeto?
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 ponteiro do mouse está sobre objeto e Falso
quando o ponteiro do mouse está fora da área do objeto.
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.
30.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 no computador. Durante o instanciamento, o
controle procura no Registro do Windows pela 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?
POSSÍVEL CAUSA
Provavelmente, uma das Bibliotecas foi criada a partir da cópia da outra, permanecendo as duas com o mesmo
identificador.
SOLUÇÃO
Para este caso, é necessário remover uma das Bibliotecas do Domínio.
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 é informada uma opção inexistente, um nome de Domínio inexistente ou
quando o arquivo do Domínio não é 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 são usadas as opções viewer ou start sem o nome do Domínio. Para mais
informações, consulte o capítulo Domínios
Como dois ou mais usuários podem trabalhar ao mesmo tempo no mesmo Domínio?
Criando o Domínio pela rede, vários usuários podem abri-lo em computadores diferentes e trabalhar nele ao mesmo
tempo. As alterações salvas por um usuário são visíveis para todos os outros usuários, assim que abrirem o objeto
específico alterado, ou então assim que atualizarem o projeto ou a Biblioteca alterados.
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 E3 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 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 a aplicação seja
modificada 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 computadores que não pertencem a um domínio
de rede Microsoft?
Depende. O arquivo de Domínio é sempre aberto pelo E3 Server, que a partir da versão 3.0 do Elipse E3 executa
exclusivamente na conta SYSTEM. É necessário então abrir o compartilhamento para o usuário SYSTEM, que chega no
outro computador 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á no mesmo computador do Elipse E3 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 E3 Studio e, quando a aplicação é executada, estes valores são buscados no computador
remoto.
O protocolo DCOM do Windows é utilizado pelo Elipse E3 para a comunicação entre Domínios
Remotos e Elipse E3 Viewer?
Não, nestas interações o protocolo utilizado é o REC, proprietário da Elipse Software.
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 está 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 E3 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.
Como são contados os Tags Bloco e os bits dos Tags no Elipse E3?
A contagem considera os Tags de Comunicação e o tamanho dos Blocos de Comunicação. Os bits não entram na
contagem.
POSSÍVEL CAUSA
Existe um firewall bloqueando o acesso ao servidor.
SOLUÇÃO
Deve-se liberar as portas utilizadas pelo Elipse E3. O procedimento para desbloquear uma porta no Firewall do
Windows está descrito a seguir.
NOTA
A porta padrão utilizada pelo Elipse E3 é a 6515, mas este comportamento pode ser alterado conforme descrito no
tópico Elipse E3 Viewer e WebViewer - Execução do Elipse E3 Viewer - Através do Menu Iniciar.
1. No Windows 11, clique no menu Iniciar (Start), selecione Configurações (Settings), clique em Rede e Internet
(Network & Internet), clique em Configurações avançadas de rede (Advanced network settings) e clique em Firewall
do Windows (Windows Firewall).
2. No Windows 10, clique no menu Iniciar (Start), selecione Configurações (Settings), clique em Rede e Internet
(Network & Internet), clique em Ethernet, clique em Firewall do Windows (Windows Firewall) e clique em
Configurações avançadas (Advanced settings).
3. 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).
4. Na janela Tipo de Regra (Rule Type), selecione o item Porta (Port) e clique em Avançar (Next).
5. 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).
6. Na janela Ação (Action), selecione o item Permitir a conexão (Allow the connection) e clique em Avançar (Next).
7. Na janela Perfil (Profile), deixe selecionadas as opções Domínio (Domain), Particular (Private) e Público (Public) e
clique em Avançar (Next).
8. 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 E3 Viewer remoto pelo Internet Explorer. Por que isto está
acontecendo?
POSSÍVEIS CAUSAS
· O Elipse E3 Viewer não foi instalado no computador remoto
· Existe um firewall bloqueando o acesso ao servidor
SOLUÇÃO
Pode-se instalar o Elipse E3 Viewer no computador remoto ou então colocar o arquivo de instalação do Elipse E3
Viewer na pasta c:\inetpub\wwwroot do computador servidor. Assim, toda vez que se tentar abrir um Elipse E3
30.8 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.
30.9 E3Browser
Como limitar o número de registros que aparecem no E3Browser?
Este item pode ser configurado na consulta do E3Browser. Habilite a opçã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 realizada
utilizando os filtros para restringir o período ou a quantidade de colunas ou registros envolvidos, entre outras
opções. Para isto, consulte o capítulo Consulta.
30.10 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.
30.11 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, e é necessário executar o registro via script utilizando o método WriteRecord.
POSSÍVEL CAUSA
O Elipse E3 Viewer não tem acesso à impressora configurada no objeto Impressora de Linha.
30.15 Relatórios
Como colocar a data e a hora atual em um Relatório do Elipse E3?
Existem pelo menos as seguintes 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, como por exemplo
"Dados.TagDemo1.Value". Configure o formato da data desejada. Para isto, clique com o botão direito do mouse
no objeto e ajuste as propriedades, ou então digite 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 este 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 um Relatório com as
configurações realizadas no Elipse E3 Studio. Utilize somente uma vez o método LoadReport no script, carregando um
Relatório para uma variável, através da declaração 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, e é necessário executar este procedimento via
script dentro do gráfico. As Penas configuradas em um E3Chart em Tela são do tipo Real.
Depois, associe dois Tags Internos aos SetPoints da Tela onde são especificadas as datas. Associe estes Tags aos
SetPoints neste Relatório.
Como utilizo o evento de script OnError para mostrar uma mensagem de erro quando falha a
impressão de um Relatório?
O evento OnError de um Relatório não permite a execução de scripts, servindo somente para uso interno. Isto significa
que não é possível alterar a mensagem de erro, nem executar algum outro procedimento a partir deste evento.
POSSÍVEL CAUSA
Mensagem gerada em log quando a senha ou o usuário está incorreto.
SOLUÇÃO
Verifique se o usuário existe e se a senha utilizada está correta.
POSSÍVEL CAUSA
A conexão cliente utilizada não foi encontrada.
SOLUÇÃO
Verifique se a conexão utilizada está criada no computador e se está funcionando através dos utilitários de rede da
Oracle.
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 E3.
SOLUÇÃO
Isto seria considerado um erro apenas se persistisse nos logs da aplicação.
POSSÍVEL CAUSA
Sempre que é realizada uma tentativa de escrita de um registro onde o campo definido como chave primária tem 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, considere os casos a seguir:
· 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 é 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 não envie valores repetidos de chave para gravação.
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
Verifique 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.
POSSÍVEL CAUSA
Já existe um objeto (tabela, chave ou índice, entre outros) no Banco de Dados com este mesmo nome.
SOLUÇÃO
Mude o nome do objeto.
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.
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. Clique com o botão direito do mouse no objeto desejado e selecione a opção Remover animação.
2. 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.
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, como 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 E3 deve estar configurada como 1 - clClient.
Integradores Youtube