Manual de Usuário - E3

Prévia do material em texto

Versão 6.0.215 (10/12/2021)
Manual do Usuário do E3
Copyright © 1999 - 2021 Elipse Software Ltda. Todos os direitos reservados.
I
Sumário
1 Introdução ................................................................................................................................................... 1
1.1 Descrição Geral ..................................................................................................................................... 1
1.2 Arquitetura ............................................................................................................................................ 2
1.3 Diagrama de Blocos ............................................................................................................................. 3
1.4 Estrutura de Domínio ........................................................................................................................... 4
1.5 Limitações do Modo Demonstração .................................................................................................. 4
2 E3 Studio ..................................................................................................................................................... 5
2.1 Iniciando um Projeto ............................................................................................................................ 5
2.2 Área de Trabalho .................................................................................................................................. 5
2.3 Configuração ......................................................................................................................................... 6
2.4 Barra de Ferramentas ........................................................................................................................ 13
2.5 Atalhos de Teclado ............................................................................................................................. 30
2.6 Organizer ............................................................................................................................................. 34
2.7 Importação e Exportação .................................................................................................................. 38
2.8 Lista de Propriedades ........................................................................................................................ 60
2.9 Galeria .................................................................................................................................................. 62
2.10 AppBrowser ...................................................................................................................................... 63
2.11 Conectar A ........................................................................................................................................ 66
3 Domínios ................................................................................................................................................... 68
3.1 E3 Server .............................................................................................................................................. 68
3.2 E3Run ................................................................................................................................................... 68
3.3 E3 Admin ............................................................................................................................................. 69
3.4 IOServer ............................................................................................................................................... 70
3.5 E3 Studio ............................................................................................................................................. 70
3.6 E3 Viewer ............................................................................................................................................. 70
3.7 Componentes ...................................................................................................................................... 70
3.8 Criando um Domínio .......................................................................................................................... 71
3.9 Configurações ..................................................................................................................................... 77
3.10 Outras Opções da Área de Notificação ....................................................................................... 101
3.11 Domínios Remotos ........................................................................................................................ 108
3.12 Gerando Logs no E3 ...................................................................................................................... 113
4 Drivers ..................................................................................................................................................... 115
4.1 Driver de Comunicação ................................................................................................................... 115
4.2 Servidor OPC ..................................................................................................................................... 127
4.3 Driver de Comunicação OPC ........................................................................................................... 128
4.4 Driver de Comunicação OPC UA ..................................................................................................... 139
4.5 Qualidade .......................................................................................................................................... 150
5 Quadros ................................................................................................................................................... 156
6 Viewer ..................................................................................................................................................... 160
6.1 Configuração .................................................................................................................................... 160
II
6.2 Variáveis no Viewer ......................................................................................................................... 165
6.3 Objeto _top ....................................................................................................................................... 165
6.4 Pasta do Viewer ................................................................................................................................ 166
7 Telas e Objetos de Tela ......................................................................................................................... 168
7.1 Tela .................................................................................................................................................... 168
7.2 Barra de Ferramentas ...................................................................................................................... 170
7.3 Objetos de Tela ................................................................................................................................. 173
7.4 Configurações Gerais ....................................................................................................................... 177
7.5 Formatação de Cores ....................................................................................................................... 185
7.6 Formatação de Valores .................................................................................................................... 187
8 Associações ............................................................................................................................................ 191
8.1 Simples.............................................................................................................................................. 192
8.2 Bidirecional ....................................................................................................................................... 192
8.3 Digital ................................................................................................................................................ 193
8.4 Analógica .......................................................................................................................................... 194
8.5 Por Tabela ......................................................................................................................................... 195
8.6 Reversa .............................................................................................................................................. 196
8.7 Múltipla ............................................................................................................................................. 196
8.8 Edição de Associações ..................................................................................................................... 197
9 Bibliotecas .............................................................................................................................................. 201
9.1 Galeria ............................................................................................................................................... 201
9.2 Biblioteca do Usuário (ElipseX) ...................................................................................................... 202
9.3 Quando Criar um ElipseX ................................................................................................................ 211
10 ActiveX .................................................................................................................................................. 212
10.1 Objetos Microsoft Forms .............................................................................................................. 214
10.2 Elipse KeyPad ................................................................................................................................. 215
11 Servidor de Dados ............................................................................................................................... 217
11.1 Impressora de Linha ...................................................................................................................... 217
11.2 Pasta de Dados ............................................................................................................................... 219
11.3 Tag Contador .................................................................................................................................. 220
11.4 Tag Demo ....................................................................................................................................... 221
11.5 Tag Interno ..................................................................................................................................... 222
11.6 Tag Timer ........................................................................................................................................ 223
12 Banco de Dados ................................................................................................................................... 225
12.1 Access .............................................................................................................................................. 225
12.2 Oracle .............................................................................................................................................. 226
12.3 SQL Server ....................................................................................................................................... 230
12.4 Objetos do E3 e Permissões ......................................................................................................... 232
13 Consultas .............................................................................................................................................. 234
13.1 Criando uma Consulta ................................................................................................................... 235
13.2 Uso dos Filtros da Consulta através de Scripts .......................................................................... 242
III
13.3 Uso de Recordsets de uma Consulta através de Scripts ........................................................... 242
14 Alarmes ................................................................................................................................................. 243
14.1 Configuração de Alarmes ............................................................................................................. 243
14.2 Filtro de Alarmes ........................................................................................................................... 245
14.3 Fontes de Alarme ........................................................................................................................... 251
14.4 Servidor de Alarmes ...................................................................................................................... 259
15 E3Alarm ................................................................................................................................................ 268
15.1 Configurações ................................................................................................................................ 268
15.2 Características Específicas de Tempo de Execução .................................................................... 277
16 Storage .................................................................................................................................................. 283
16.1 Configurações ................................................................................................................................ 285
16.2 Configuração da Tabela ................................................................................................................ 286
16.3 Objeto Fields ................................................................................................................................... 296
16.4 Campo do Storage ......................................................................................................................... 296
17 Histórico ............................................................................................................................................... 298
17.1 Configurações ................................................................................................................................ 299
17.2 Objeto Fields ................................................................................................................................... 304
17.3 Objeto Indexes ............................................................................................................................... 306
17.4 Objeto PrimaryKey ........................................................................................................................ 307
18 E3Browser ............................................................................................................................................ 310
18.1 Objeto Consulta no E3Browser .................................................................................................... 311
18.2 Outras Configurações .................................................................................................................... 312
19 E3Chart .................................................................................................................................................316
19.1 Configurações ................................................................................................................................ 316
19.2 Exemplos de Utilização ................................................................................................................. 342
19.3 Características Específicas de Tempo de Execução .................................................................... 344
20 TrendAnalysis ...................................................................................................................................... 349
20.1 Aba Exibições ................................................................................................................................. 350
20.2 Aba Marcadores ............................................................................................................................. 355
20.3 Aba Conexões ................................................................................................................................. 356
20.4 Área de Exibições ........................................................................................................................... 356
20.5 Atalhos de Teclado ........................................................................................................................ 360
21 E3Playback ............................................................................................................................................ 362
21.1 Objeto E3Playback ......................................................................................................................... 362
21.2 Adicionar Playback ao Demo do E3 ............................................................................................. 362
21.3 Interface de Usuário ...................................................................................................................... 365
21.4 Banco de Dados de Playback ........................................................................................................ 374
21.5 Configuração dos Objetos de Banco de Dados do E3 ............................................................... 376
22 Fórmulas ............................................................................................................................................... 379
22.1 Configurações ................................................................................................................................ 379
22.2 Templates ....................................................................................................................................... 381
IV
22.3 Unidades ......................................................................................................................................... 382
22.4 Conjunto de Valores ...................................................................................................................... 383
22.5 Criação de uma Fórmula ............................................................................................................... 384
23 Relatórios ............................................................................................................................................. 389
23.1 Objeto Consulta ............................................................................................................................. 389
23.2 Componentes ................................................................................................................................. 389
23.3 Configurações ................................................................................................................................ 391
23.4 Criando um Relatório no E3 ......................................................................................................... 402
23.5 Exemplos de Utilização ................................................................................................................. 403
24 Segurança ............................................................................................................................................. 406
24.1 Usuários .......................................................................................................................................... 406
24.2 Grupos ............................................................................................................................................. 411
24.3 Permissões ...................................................................................................................................... 416
24.4 Proteção de Arquivos .................................................................................................................... 419
25 E3 Viewer e WebViewer ...................................................................................................................... 423
25.1 Viewer Only (Modo Somente Leitura) ........................................................................................ 423
25.2 Execução do E3 Viewer .................................................................................................................. 424
25.3 Logs do E3 Viewer ......................................................................................................................... 427
25.4 Execução do WebViewer ............................................................................................................... 427
26 Hot-Standby ......................................................................................................................................... 431
26.1 Configurando ................................................................................................................................. 431
26.2 Executando um Domínio Redundante ........................................................................................ 432
26.3 Parando um Domínio Redundante .............................................................................................. 432
26.4 Parando um dos Servidores do Domínio .................................................................................... 432
26.5 Tempo de Troca entre Servidores ................................................................................................ 433
26.6 Reconexão de E3 Viewers ............................................................................................................. 433
26.7 Utilizando Bancos de Dados com Hot-Standby ......................................................................... 433
27 Configurações Avançadas .................................................................................................................. 434
28 Biblioteca E3DataAccess ..................................................................................................................... 435
28.1 Eventos ............................................................................................................................................ 435
28.2 Métodos .......................................................................................................................................... 435
28.3 Propriedades .................................................................................................................................. 437
29 Dúvidas mais Frequentes ................................................................................................................... 439
29.1 Alarmes ........................................................................................................................................... 439
29.2 Associações .................................................................................................................................... 440
29.3 Bibliotecas ......................................................................................................................................441
29.4 Domínios e Projetos ...................................................................................................................... 441
29.5 Domínios Remotos ........................................................................................................................ 442
29.6 Drivers de Comunicação ............................................................................................................... 445
29.7 E3Alarm .......................................................................................................................................... 446
29.8 E3Browser ....................................................................................................................................... 446
V
29.9 E3Chart ............................................................................................................................................ 446
29.10 Histórico ....................................................................................................................................... 446
29.11 Impressora de Linha .................................................................................................................... 447
29.12 Objetos de Tela ............................................................................................................................ 447
29.13 Ordem da Tabulação ................................................................................................................... 447
29.14 Relatórios ..................................................................................................................................... 447
29.15 Servidor de Banco de Dados Oracle .......................................................................................... 448
29.16 Servidor de Banco de Dados SQL Server ................................................................................... 449
29.17 Servidor de Dados ....................................................................................................................... 450
29.18 Sobreposição de Animações nos Objetos ................................................................................. 450
29.19 Stored Procedure ......................................................................................................................... 451
29.20 E3 Viewer ...................................................................................................................................... 451
1 
 
 Introdução
1
Introdução
CAPÍTULO
Desenvolvido pela Elipse Software, o E3 é uma poderosa plataforma para supervisão e controle de processos
totalmente voltada à operação em rede e aplicações distribuídas. O 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. Sua concepção incorpora as mais novas tecnologias em desenvolvimento de software, maximizando o
desempenho, a produtividade e a qualidade de suas aplicações e do próprio processo, minimizando perdas e custos.
Os sistemas construídos com o E3 geralmente partem da coleta de dados em tempo real de equipamentos de
aquisição de dados ou de controle, como os 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 permitem sua conexão ao software, 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 E3 lê e escreve dados dos equipamentos através de módulos (Drivers de Comunicação) que implementam o
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, dentre elas:
· 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
1.1 Descrição Geral
O E3 pode ser executado nas plataformas Windows 7 SP1, Windows 8, Windows 8.1, Windows 10, Windows 10
Enterprise LTSB ou LTSC, Windows Server 2008 R2 SP1, Windows Server 2012, Windows Server 2012 R2, Windows
Server 2016 ou Windows Server 2019, utilizando alguns recursos disponíveis nestes sistemas operacionais. A interface
gráfica com o usuário pode também ser executada através da Internet ou intranet via Internet Explorer.
As funções básicas do software estão divididas em módulos independentes, capazes de processar atividades
específicas. O gerenciamento do tráfego de informações entre os módulos é coordenado por um módulo principal
(E3 Admin), utilizando a tecnologia de objetos distribuídos, permitindo que os componentes possam ser executados
tanto na mesma máquina quanto em outros computadores.
Em linhas gerais, o E3 é composto de um núcleo (kernel) responsável por unir e coordenar o trabalho de vários outros
módulos, que também são servidores de informações. A partir daí são geradas as interfaces gráficas com o usuário,
disponíveis através dos clientes, tanto locais como pela Internet.
O E3 possui quatro programas principais, descritos a seguir.
1.1.1 E3 Server
É o Servidor de Aplicações, onde os principais processos são executados, incluindo a comunicação em tempo real
com os equipamentos de controle. O servidor também é responsável por enviar dados e Telas aos clientes
conectados em qualquer parte da rede (intranet e Internet). O servidor pode executar vários projetos ao mesmo
tempo e conversar com outros E3 Servers para realizar um fail-over (standby) ou distribuir cargas de processamento
entre as máquinas.
1.1.2 E3 Studio
Ferramenta única de configuração, agindo como plataforma universal de desenvolvimento, que possui um ambiente
moderno e amigável, incluindo um completo editor gráfico e de scripts (VBScript). Permite que um projeto seja
editado por várias pessoas ao mesmo tempo ou que vários E3 Studios estejam conectados ao mesmo servidor
remoto, com múltiplas configurações.
Introdução 
 
 2
1.1.3 E3 Viewer
Permite operar as aplicações residentes no servidor a partir de qualquer computador com o programa executável E3
Viewer ou com um navegador de Internet. Em ambos os casos, não é necessário instalar a aplicação na máquina
cliente, pois é realizado o download e o registro de todos os componentes (Telas, bibliotecas e controles ActiveX).
1.1.4 E3 Admin
É o módulo responsável pela interface do E3 Server e de outros módulos do E3 com o usuário. Através dele o usuário
pode enviar comandos ao E3 Server, utilizando o ícone na Área de Notificações do Windows, e controlar o Domínio
pela linha de comando.
1.2 Arquitetura
Para supervisionar um determinado processo com um sistema SCADA, geralmente é construída uma aplicação que
contém a definição das variáveis envolvidas, com nomes e endereçamentos, Telas, definiçõesde alarmes e outros, a
qual 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. 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 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 (servidores) e as bases de dados de projeto que devem ser
executadas nestes servidores, com a possibilidade de execução de vários projetos em cada servidor. Também é
possível inserir, apagar ou modificar projetos durante a execução, sem afetar as outras partes do Domínio em
execução.
Cada projeto pode conter qualquer tipo de objeto, como Telas, Drivers de Comunicação, Alarmes, Históricos,
Relatórios, Fórmulas e Bancos de Dados, dentre outros. Quando dois ou mais projetos estão dentro de um mesmo
Domínio, estes podem acessar as propriedades e objetos entre si como se estivessem residentes em uma única base
de dados. Isto é possível através do uso de Associações (conexões) que um objeto pode criar com qualquer outro. Se
ambos os objetos existem e estão executando, a conexão está ativa e qualquer mudança de valor é enviada
assincronamente entre as partes, dependendo do tipo da conexão. Se um dos objetos é destruído ou parado a
conexão é quebrada, então a aplicação é notificada e pode indicar seu estado em uma forma definida pelo usuário.
A estrutura do Domínio é restrita aos servidores e afins, como as máquinas servidoras, projetos, usuários e senhas. A
interface do cliente para operação e visualização, chamada E3 Viewer, pode se conectar diretamente a qualquer
servidor E3 (com licenças suficientes de E3 Viewer). O E3 Viewer possui três destaques especiais:
· Os projetos da aplicação residem somente no servidor
· O Internet Explorer pode ser usado como interface de operação, sem nenhuma mudança
· A interface do cliente é capaz de alternar de um servidor desligado ou com falha para o próximo servidor
disponível, sem interromper o monitoramento do processo
Como alternativa ao uso do E3 Viewer na máquina cliente, é possível utilizar a tecnologia Terminal Service. Este
serviço surgiu no Windows NT 4.0 e sua função é permitir o acesso remoto entre computadores, através de um
protocolo chamado RDP (Remote Desktop Protocol). Este protocolo permite a interação entre uma estação cliente e
uma máquina servidora, que é acessada remotamente. O E3 Viewer é executado em uma nova sessão de usuário
criada na máquina servidora, que por sua vez transfere para a máquina cliente os dados de vídeo e recebe de volta
os eventos de mouse e teclado.
3 
 
 Introdução
Arquitetura do E3
É possível observar que, em todos os casos, o E3 Viewer continua sendo a interface de operação e visualização. A
diferença está no local de execução, que pode ser na máquina cliente (operação normal do E3 Viewer) ou na máquina
servidora, com o operador fisicamente junto à máquina ou através dos Terminal Services. Com o E3 Viewer sendo
executado diretamente na estação cliente, existe um tráfego inicial maior para o download de Telas e objetos. Este
tráfego diminui substancialmente à medida que somente as mudanças nos dados são reportadas do servidor para o
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 da máquina
cliente quando existem poucos efeitos gráficos e visuais, além da possibilidade de operar o E3 em outras plataformas
de software que não são suportadas pelo E3 Viewer, como o Windows CE e o Linux ou Unix. Entretanto, o RDP
possui a limitação de exibir somente 256 cores, o que aumenta consideravelmente o tráfego quando existem muitas
animações ou efeitos piscantes nas Telas. Para verificar qual a melhor maneira de implementar múltiplos acessos a um
E3 Server, é importante estudar caso a caso, para poder definir a melhor alternativa para a aplicação. Para utilizar o
RDP com múltiplos usuários, é necessário uma licença de Windows 2003 Server SP2, além do mesmo número de E3
Viewers disponíveis no Servidor.
1.3 Diagrama de Blocos
A arquitetura interna do E3 é totalmente escalável, com cada tarefa principal sendo executada por um serviço
separado. O diagrama a seguir mostra uma visão geral dos principais blocos.
Diagrama dos blocos que compõem o E3
Introdução 
 
 4
Detalhadamente, o E3 Server é responsável por criar um processo de execução (E3Run) que vai efetivamente executar
a aplicação. Dentro do E3Run encontram-se outros servidores, que expõem serviços utilizados por outros módulos.
1.4 Estrutura de Domínio
Cada grupo de servidores é composto por um E3 Server operando isoladamente ou dois E3 Servers em configuração
de Hot-Standby. Cada E3 Viewer, de fato, se conecta a um Domínio ao invés de somente a um servidor.
Depois da conexão, servidor e cliente trocam informações e verificam a existência de objetos do sistema registrados e
atualizados na máquina cliente. Caso negativo, o servidor carrega as definições dos objetos, como bibliotecas do
usuário, conforme a necessidade para abrir cada uma das Telas.
Do ponto de vista do cliente, o download começa na primeira Tela (interface gráfica), incluindo quaisquer objetos
internos que são salvos em um diretório de cache. Este processo pode levar alguns segundos, dependendo da
aplicação, mas traz mais benefícios na próxima vez que se abre a mesma Tela, pois o E3 Viewer realiza um cache em
disco e em memória. Se o E3 Viewer não é fechado, a partir da segunda vez que uma Tela é aberta (e não for
reconfigurada) ela já está criada em memória, reduzindo portanto o tempo de paginação. Se a Tela é modificada, o
E3 Viewer deve executar um novo download, reiniciando o processo.
Depois de abrir uma Tela, o servidor e o cliente trocam somente dados em tempo real e consultas ao banco de
dados em um sistema de mensagens TCP/IP, com um alto desempenho se comparado ao Terminal Services,
dependendo da aplicação. Isto é possível porque enquanto o E3 Viewer recebe e envia apenas valores e dados em
tempo real, um cliente Terminal Services envia mensagens de teclado e mouse e recebe imagens, o que gera um
tráfego muito maior de informações. Um E3 Viewer conectado a um Domínio isolado pode obter informações
residentes somente dentro do servidor ativo, de acordo com os direitos de acesso do usuário.
1.5 Limitações do Modo Demonstração
Sem a utilização de uma chave de produto, o E3 pode ser executado em modo Demonstração (ou Demo), o que é
útil para avaliação do software. Neste caso, as seguintes limitações se aplicam:
· Permite salvar projetos com até 20 Tags de Comunicação
· Não permite trabalhar com servidores em modo Hot-Standby
· Não permite trabalhar com Domínios Remotos
· Só permite a comunicação com um Driver de Comunicação de nível 0 (zero), sem limite de Tags. Drivers com nível
maior do que 0 (zero) não são permitidos
· Não permite acesso às configurações do Domínio, disponíveis no menu contextual Domínio - Opções do ícone
do E3 Admin na Área de Notificações do Windows
· Somente a primeira imagem de cada categoria da Galeria de Símbolos está disponível
· Só permitea abertura de um 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 E3 Studio
5 
 
 E3 Studio
2
E3 Studio
CAPÍTULO
O E3 Studio é o ambiente de desenvolvimento do E3. Neste ambiente é possível criar e manter Domínios, projetos e
bibliotecas.
Para iniciar uma aplicação no 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
a máquina deve estar na mesma rede local que outra com o E3 Server já previamente instalado, e com um dispositivo
de proteção presente.
2.1 Iniciando um Projeto
Ao iniciar o E3 Studio, abre-se uma caixa de diálogo com algumas opções do projeto, conforme a figura a seguir.
Janela Iniciar o E3 Studio
As opções disponíveis nesta caixa de diálogo estão descritas na tabela a seguir.
Opções disponíveis na janela Iniciar o E3 Studio
OPÇÃO DESCRIÇÃO
Iniciar o E3 Studio Não abre nenhum Domínio
Criar um Domínio novo Requisita um nome e um caminho para este novo
Domínio
Abrir um Domínio existente Ao clicar em Outros Arquivos, tem-se a opção de
localizar um Domínio em um diretório específico ou
selecionar na lista uma das últimas aplicações editadas
2.2 Área de Trabalho
O E3 Studio já vem com uma série de menus e uma barra de ferramentas configurados, que são mostrados ao
executá-lo pela primeira vez. Ao utilizar uma interface gráfica mais moderna, similar a programas como o Microsoft
Office, os menus e a barra de ferramentas podem ser modificados pelo usuário. Quando não existe uma aplicação
aberta, a tela apresenta menos opções habilitadas na barra de menu e na barra de ferramentas, mas sua aparência
permanece a mesma. A figura a seguir mostra a aparência do E3 Studio após a criação de um novo projeto.
E3 Studio 
 
 6
Área de trabalho do 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 E3.
A Área de Trabalho é onde os Editores são mostrados.
2.3 Configuração
O E3 permite personalizar alguns recursos do E3 Studio, tais como barras de ferramentas, teclado, menus, mouse,
etc.
2.3.1 Aparência
Para personalizar a aparência do 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 
 
 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 E3
Studio
Comandos Mostra os itens que compõem a categoria selecionada
Descrição Breve descrição da opção selecionada
Aba Barras de Ferramentas
Esta aba configura a barra de ferramentas Padrão e a barra de menus do E3 Studio.
Aba Barras de ferramentas
As opções disponíveis nesta aba estão disponíveis na tabela a seguir.
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
Restaurar Restaura as opções padrão para o item selecionado na
lista Barras de ferramentas
Restaurar tudo Restaura as opções padrão tanto para a barra de
ferramentas Padrão quanto para a barra de menus
Nova Cria uma nova barra de ferramentas. Esta opção não tem
efeito e é mantida no E3 por questões de
compatibilidade
Renomear Muda o nome da barra de ferramentas selecionada. Esta
opção não tem efeito e é mantida no E3 por questões de
compatibilidade
Remover Remove a barra de ferramentas selecionada. Esta opção
não tem efeito e é mantida no E3 por questões de
compatibilidade
Mostrar legendas Mostra uma legenda nas opções da barra de
ferramentas Padrão. Esta opção não está disponível para
a barra de menus
Aba Menus
Esta aba configura os menus do 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 E3 por questão de
compatibilidade
Restaurar Restaura o menu definido na opção anterior. Esta opção
não tem efeito e é mantida no E3 por questão de
compatibilidade
9 
 
 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 E3),
Desdobrar, Deslizar, Fade ou [Default] (padrão do
Windows)
Menus com sombra Define se um menu apresenta o efeito de sombreado ou
não
Aba Aparência
Esta aba altera a aparência das janelas e barras de ferramentas no 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 E3 Studio com o estilo usado
no esquema de cores do Windows atualmente instalado
Office 2000 Configura a aparência do E3 Studio com o estilo usado
no esquema de cores Office 2000
Office XP Configura a aparência do E3 Studio com o estilo usado
no esquema de cores Office XP
Office 2003 Configura a aparência do E3 Studio com o estilo usado
no esquema de cores Office 2003
VS.Net 2005 Configura a aparência do E3 Studio com o estilo usado
no esquema de cores Visual Studio .NET 2005
Office 2007 (Prata) Configura a aparência do E3 Studio com o estilo usado
no esquema de cores Office 2007 Prata
VS 2008 Configura a aparência do E3 Studio com o estilo usado
no esquema de cores Visual Studio 2008
VS 2010 Configura a aparência do E3 Studio com o estilo usado
no esquema de cores Visual Studio 2010
Office 2010 (Prata) Configura a aparência do E3 Studio com o estilo usado
no esquema de cores Office 2010 Prata
E3 Studio 
 
 10
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 E3 a mostrar uma breve descrição nas opções
dabarra de ferramentas Padrão e nas barras de
ferramentas de uma Tela quando o ponteiro do mouse é
posicionado sobre um item
Incluir teclas de atalho Mostra ou não os atalhos de teclado na descrição de
uma opção
Ícones grandes Habilita ícones grandes na barras de ferramentas Padrão
e nas barras de ferramentas de uma Tela
2.3.2 Outras Configurações
Pode-se configurar o Editor de Scripts do E3, bem como outras opções dos arquivos do Domínio, através do menu
Ferramentas - Opções, onde tem-se acesso à janela de configurações mostrada nas figuras a seguir.
A aba Geral configura comportamento gerais de Editores de objetos e Domínios.
11 
 
 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
Abrir a Janela de Propriedades Abre a Janela de Propriedades de um objeto na
ocorrência de um duplo-clique do mouse. NOTA: A Janela
de Propriedades também pode ser aberta utilizando os
atalhos de teclado ALT + ENTER ou ALT + Duplo-clique
do mouse
Mostrar botão de fechar na aba ativa Permite fechar a aba ativa ao clicar no seu respectivo
botão de fechar. Desmarcar esta opção posiciona o
botão de fechar à direita do Editor
Pedir confirmação ao parar o Domínio Se esta opção está selecionada, mostra uma mensagem
de confirmação de parada do Domínio ao usar a opção
Rodar ou Parar Domínio (SHIFT + F9) na barra de
ferramentas Padrão
Mostrar mensagens de advertência da janela
Procurar/Substituir
Se esta opção está selecionada, todas as mensagens
mostradas em caixas de diálogo durante as operações de
procura e substituição da janela Procurar e Substituir
são sempre mostradas. NOTA: Se esta opção está em um
estado indeterminado , isto indica que em algumas
mensagens o usuário desmarcou a opção Sempre
mostrar esta mensagem da caixa de diálogo e em outras
mensagens não
A aba Editor de Scripts destina-se à configuração do Editor de Scripts do E3.
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
Tamanho da margem Tamanho da margem da marcação do bloco de código
Numeração da linha Habilita a numeração de linha no editor de scripts
Tamanho da margem Tamanho da margem que contém a numeração de linha
Tamanho da tabulação Determina o número de espaços de tabulação
Fonte Determina o nome da fonte a ser usada no editor de
scripts
Tamanho Determina o tamanho da fonte a ser usada no editor de
scripts
NOTA
Feche os editores de scripts abertos para que as modificações sejam aplicadas.
A aba Arquivos permite habilitar ou desabilitar a verificação de CRC (Cyclic Redundancy Check ou Verificação de
Redundância Cíclica).
13 
 
 E3 Studio
Aba Arquivos
Toda vez que um projeto ou uma biblioteca é criado, o E3 grava internamente um código CRC dos dados deste
arquivo. Cada vez que um arquivo é aberto, é feita uma verificação deste CRC. Caso esta verificação falhe, ou seja, o
CRC não coincida com os dados, a carga do arquivo é abortada, indicando uma corrupção dos dados do arquivo.
Isto pode ser causado por falhas diversas de hardware, tais como memória, rede ou dispositivos de armazenamento,
entre outras.
Porém, se um projeto criado na versão atual é modificado em uma versão anterior à versão 1.00.019 build 203, o CRC
não é atualizado. Com isto, o arquivo não pode ser aberto novamente com as versões atuais, pois a verificação de
CRC falha, mesmo que o arquivo não esteja efetivamente corrompido. Para solucionar esta questão, é necessário
habilitar a opção Ignorar verificação de CRC. Assim, um projeto pode ser aberto em uma versão atual.
Neste caso, a opção deve permanecer habilitada até que todos os objetos editados na versão antiga tenham sido
salvos com a versão atual, o que atualiza o CRC.
NOTA
Não é recomendável que arquivos de projeto sejam editados em versões mais antigas do 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.
2.4 Barra de Ferramentas
A Barra de Ferramentas do E3 contém opções que permitem a execução de determinadas tarefas rapidamente sem
utilizar os menus, como por exemplo abrir o Organizer. A tabela a seguir mostra as opções disponíveis na barra de
ferramentas Padrão do E3 Studio.
Opções disponíveis na barra de ferramentas Padrão
COMANDO AÇÃO
Novo Cria um novo projeto (CTRL + N)
Abrir Projeto Abre um projeto existente (CTRL + O)
Salvar Salva um projeto (CTRL + S)
Salvar Tudo Salva todo o Domínio (CTRL + SHIFT + S)
E3 Studio 
 
 14
COMANDO AÇÃO
Registrar Bibliotecas Registra todas as bibliotecas carregadas (CTRL + SHIFT
+ L)
Recortar Remove a informação selecionada e a move para a Área
de Transferência (SHIFT + DELETE)
Copiar Copia a informação selecionada e a move para a Área
de Transferência (CTRL + C)
Colar Cola a informação selecionada da Área de Transferência
(CTRL + V)
Desfazer Desfaz a última ação executada (ALT + BACKSPACE)
Refazer Refaz a última ação desfeita pela opção Desfazer (CTRL
+ Y)
Organizer Mostra ou esconde o Organizer (CTRL + SHIFT + O)
Galeria Mostra ou esconde a Galeria (CTRL + SHIFT + G)
Lista de Propriedades Mostra ou esconde a Lista de Propriedades (CTRL +
SHIFT + P)
Verificação de Domínio Verifica se o Domínio atual contém erros (CTRL + SHIFT
+ V)
Mostrar no Editor Mostra um objeto no Editor deste objeto, se este estiver
selecionado no Organizer (ENTER)
Mostrar no Organizer Mostra um objeto no Organizer, se este estiver
selecionado no Editor do objeto
Executar Aplicativo Salva todos os projetos e bibliotecas, executa o Domínio
e abre o E3 Viewer (F9)
Rodar ou Parar Domínio Executa ou para o Domínio corrente (SHIFT + F9)
Executar ou Parar E3 Viewer Executa ou para o E3 Viewer (CTRL + F9)
Desfragmentar Arquivos Desfragmenta o arquivo especificado
Criar Pacote de Bibliotecas Cria um arquivo compactado com as bibliotecas
disponíveis no Domínio
Procurar Procura todas as ocorrências de um determinado texto
em todo o Domínio (CTRL + SHIFT + F)
Substituir Substitui todas as ocorrências de um determinado texto
em todo o Domínio (CTRL + SHIFT + H)
Contagem de Objetos do Domínio Mostra uma janela com as quantidades de objetos
disponíveis no Domínio, separados por classes
ordenadas alfabeticamente ou agrupadas por módulos
(CTRL + SHIFT + C)
Documentação de Scripts Gera a documentação dos scripts
Relatório de Versões Mostra as versões dos projetos e bibliotecas
WatchWindow Mostra ou edita os valores de Tags e de propriedades
no E3 Studio em tempo de execução (CTRL + SHIFT +
W)
2.4.1 Contagem de Objetos do Domínio
A ferramenta Contagem de Objetos do Domínio permite visualizar a quantidade de objetos existentes em um
Domínio, separados por classes ordenadas alfabeticamente ou agrupadas por módulos. A contagem também pode
ser realizada contextualmente a um objeto, clicando com o botão direito do mouse no objeto desejado e
selecionando a opção Contagem de Objetos .
15E3 Studio
Janela Contagem de Objetos do Domínio
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Contagem de Objetos do Domínio
OPÇÃO DESCRIÇÃO
Ordenar por Categoria Mostra a contagem de objetos organizando-os pelo
módulo
Ordenar Alfabeticamente Mostra a contagem de objetos organizando-os em
ordem alfabética
Atualizar Atualiza a contagem de objetos. NOTA: A atualização
não é automática, exceto quando o objeto removido é o
objeto base do contexto de contagem ou ao fechar o
Domínio
Contar Filhos de Instâncias de ElipseXs Inclui na contagem os filhos internos das instâncias de
um XControl, XFolder ou XObject
Procurar Permite filtrar a listagem pelo nome ou parte do nome
de um objeto
NOTAS
· O menu contextual Contagem de Objetos não está disponível no Organizer em modo Domínio para os itens
Configuração, Servidores, Arquivos e Domínios Remotos.
· Os arquivos individuais do item Arquivos no Organizer em modo Domínio permitem utilizar o menu contextual
Contagem de Objetos.
· No caso de arquivos protegidos por senha, é necessário que estes arquivos estejam abertos para que sejam
incluídos na contagem.
2.4.2 Criar Pacote de Bibliotecas
A ferramenta Criar Pacote de Bibliotecas permite criar um arquivo compactado contendo uma ou mais bibliotecas do
Domínio atual. Ao selecionar esta opção, a janela da figura a seguir é aberta.
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
Bibliotecas selecionadas Listagem com todas as bibliotecas selecionadas para o
pacote de bibliotecas
Adicionar Adiciona a biblioteca selecionada na listagem Bibliotecas
disponíveis na listagem Bibliotecas selecionadas
Remover Remove a biblioteca selecionada na listagem Bibliotecas
selecionadas, movendo-a de volta para a listagem
Bibliotecas disponíveis
Criar Abre uma caixa de diálogo Salvar Como, que permite
selecionar onde salvar o pacote com as bibliotecas
selecionadas em um arquivo com a extensão .e3pkg
O pacote criado usando esta opção não é automaticamente adicionado ao Domínio corrente. Para isto, clique com o
botão direito do mouse no pacote no modo Explorer do Organizer e selecione a opção Adicionar ao Domínio .
As bibliotecas que compõem um pacote não são visíveis no modo Domínio, somente no modo Explorer, e não
podem ser removidas do pacote.
Os pacotes de bibliotecas contêm uma opção Extrair Bibliotecas no menu contextual, que permite extrair todos os
recursos adicionados aos pacotes. Estes recursos não são adicionados ao Domínio corrente.
NOTA
Deve-se ter cuidado ao tentar incluir as bibliotecas ou recursos extraídos de um pacote de bibliotecas ao Domínio
atual, pois se já houver uma biblioteca com o mesmo identificador, esta situação impede a utilização destas
bibliotecas até que uma delas seja removida do Domínio.
2.4.3 Documentação de Scripts
A ferramenta Documentação de Scripts serve para auxiliar o usuário na organização e documentação dos scripts da
aplicação. Esta ferramenta pode ser acessada das seguintes formas:
17 
 
 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 de seus filhos são gravados no arquivo
Esta ferramenta gera um arquivo texto que pode ser editado em qualquer programa de edição de textos. A
formatação do arquivo de documentação é realizada através de um assistente chamado Assistente de
Documentação de Scripts. Este assistente é responsável por guiar o usuário na configuração do arquivo de
documentação de scripts.
Assistente de Documentação de Scripts
Na janela Arquivo de documentação são definidas as informações referentes ao arquivo que guarda os scripts da
aplicação.
No item Nome do arquivo, especifique o nome do arquivo onde é gerada a documentação dos scripts. Especifique o
local onde este arquivo é salvo no item Salvar o arquivo na pasta, e caso haja necessidade, clique em Procurar.
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 
 
 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
E para o segundo objeto seria no formato a seguir.
<Tela1.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 no campo Entre com o texto da linha. Se a opção selecionada é Repetir até o final da
linha, os caracteres informados são repetidos até o limite de tamanho da linha, que é de 80 caracteres. Pode-se
também utilizar mais de uma linha como separador, seja em branco ou personalizada. para isto, informe um número
entre 1 (um) e 100 no campo Entre com o número de linhas do separador. Clique em Avançar para finalizar a
configuração. Logo após, o assistente mostra uma mensagem indicando a finalização da configuração e a geração do
arquivo que contém a documentação dos scripts.
E3 Studio 
 
 20
Mensagem definalizaçã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 E3
2.4.4 Procurar e Substituir
A ferramenta Procurar busca por ocorrências de um determinado texto, de forma parcial ou completa. Ao final da
busca é apresentada ao usuário uma lista de resultados indicando o objeto ou objetos onde a ocorrência foi
encontrada, a localização dentro deste objeto ou objetos, como por exemplo se é uma propriedade ou Associação, e
o texto que contém a ocorrência. Para utilizar esta ferramenta, selecione a opção Procurar na barra de
ferramentas Padrão, selecione o item Procurar no menu Ferramentas do E3 Studio ou utilize o atalho de teclado
CTRL + SHIFT + F. Nestes casos a procura é sempre iniciada para todo o Domínio atual. Ao clicar com o botão direito
do mouse em um objeto e selecionar a opção Procurar, que é equivalente ao atalho de teclado CTRL + F, a procura é
sempre iniciada a partir do objeto selecionado e os respectivos filhos, se houver.
21 
 
 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
Olhar em Procura em todo o Domínio, nas janelas Resultados de
Procura 1 (um) ou 2 (dois) ou somente no objeto
selecionado
Diferenciar maiúsculas de minúsculas Procura pelo texto especificado exatamente como foi
escrito, diferenciando maiúsculas de minúsculas
Palavra inteira Procura pelo texto especificado como uma palavra
inteira, sem considerar se este texto está contido em
outro texto
Usar expressões regulares Procura pelo texto especificado utilizando o recurso de
expressões regulares, descrito mais adiante
Tudo Procura pelo texto especificado em propriedades dos
objetos, Associações, scripts e Picks
Incluir Dados das Fórmulas Inclui na procura os dados no banco de dados das
Fórmulas
Propriedades Procura pelo texto especificado apenas nos valores das
propriedades dos objetos
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
Associações Procura pelo texto especificado apenas nas Associações
dos objetos
Apenas Fontes Procura pelo texto especificado apenas nas fontes das
Associações dos objetos
Scripts e Picks Procura pelo texto especificado apenas em scripts e Picks
dos objetos
Resultados de Procura 1 e 2 Mostra os resultados da procura nas janelas Resultados
de Procura 1 (um) ou 2 (dois)
Acrescentar Resultados Permite executar uma procura sem remover os
resultados das buscas anteriores
Procurar Executa a procura usando as opções selecionadas
Ao selecionar a opção Usar expressões regulares, é possível utilizar padrões de combinações de caracteres,
conhecidos como Expressões Regulares, para localizar texto. Por exemplo, utilizar a expressão "a*c" permitiria
encontrar os textos "abc", "abbc" ou "a123c". A tabela a seguir contém alguns exemplos de combinações mais comuns
em expressões regulares.
Combinações comuns em expressões regulares
COMBINAÇÃO DESCRIÇÃO
a Encontra apenas o caractere "a"
. (ponto) Encontra qualquer sequência de caracteres, exceto nova
linha
[a-c] Encontra apenas os caracteres "a", "b" ou "c"
\n, \t Encontra os caracteres de nova linha ou tabulação,
respectivamente
NOTAS
· O 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.
https://docs.microsoft.com/pt-br/cpp/standard-library/regular-expressions-cpp
https://docs.microsoft.com/pt-br/cpp/standard-library/regular-expressions-cpp
23 
 
 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)
Selecionar Próximo Seleciona o próximo resultado na lista de resultados
(CTRL + F8)
Ir para Resultado Seleciona o objeto que contém o resultado no
Organizer
Apagar Grupos Selecionados Apaga o grupo de resultados de procura selecionado
(DELETE)
Limpar Lista de Resultados Remove todos os resultados de procura da lista de
resultados
Filtro Permite filtrar os resultados usando as colunas Objeto,
Localização ou Resultado
Objeto Caminho completo do objeto onde o texto foi
encontrado
Localização Mostra onde o texto foi encontrado, de acordo com as
opções selecionadas no grupo Avançado da janela
Procurar
Resultado Mostra a expressão onde o texto foi encontrado
NOTA
Os grupos de resultados nas janelas Resultados de Procura 1 (um) e 2 (dois) podem ser expandidos ou recolhidos
 para melhor organizar os resultados de busca, especialmente ao selecionar a opção Acrescentar Resultados.
A ferramenta Substituir substitui as ocorrências encontradas por outro texto especificado. Para utilizar esta
ferramenta, selecione a opção Substituir na barra de ferramentas Padrão, selecione o item Substituir no menu
Ferramentas do 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.
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
Substituir por Texto a ser utilizado na substituição
Olhar em Realiza a substituição em todo o Domínio, nas janelas
Resultados de Procura 1 (um) ou 2 (dois) ou somente no
objeto selecionado
Diferenciar maiúsculas de minúsculas Realiza a substituição pelo texto exatamente como foi
escrito, diferenciando maiúsculas de minúsculas
Palavra inteira Realiza a substituição do texto especificado como uma
palavra inteira, sem considerar se este texto está contido
em outro texto
25E3 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
Tudo Realiza a substituição do texto especificado em
propriedades dos objetos, Associações, scripts e Picks
Incluir Dados das Fórmulas Inclui na substituição os dados no banco de dados das
Fórmulas
Propriedades Realiza a substituição do texto especificado apenas nos
valores das propriedades dos objetos
Apenas Nomes Realiza a substituição do texto especificado apenas em
propriedades que representam os nomes dos objetos,
como por exemplo Name e ConnectionName
Associações Realiza a substituição do texto especificado apenas nas
Associações dos objetos
Apenas Fontes Realiza a substituição do texto especificado apenas nas
fontes das Associações dos objetos
Scripts e Picks Realiza a substituição do texto especificado apenas em
scripts e Picks dos objetos
Resultados de Procura 1 e 2 Mostra os resultados da substituição nas janelas
Resultados de Procura 1 (um) ou 2 (dois)
Acrescentar Resultados Permite executar uma substituição sem remover os
resultados das substituições anteriores
Procurar Executa a procura usando as opções selecionadas sem
executar a substituição
Substituir Executa a substituição usando as opções selecionadas do
primeiro resultado da procura nas janelas Resultados de
Procura 1 (um) ou 2 (dois)
Substituir Tudo Executa a substituição usando as opções selecionadas de
todos os resultados da procura
Substituir Seleção Executa a substituição somente nos resultados
selecionados nas janelas Resultados de Procura 1 (um)
ou 2 (dois)
Substituir Visíveis Executa a substituição somente nos resultados
mostrados após utilizar a opção Filtro das colunas
Objeto, Localização ou Resultado nas janelas
Resultados de Procura 1 (um) ou 2 (dois)
NOTA
Para selecionar um objeto e mostrar o local exato onde o texto se encontra ou onde o texto foi substituído, clique
duas vezes na linha correspondente da lista de resultados ou pressione a tecla de espaço.
A tabela a seguir contém as principais opções de pesquisa, bem como as limitações para os principais tipos de
dados.
E3 Studio 
 
 26
Principais opções de pesquisa
TIPO DE DADOS EXEMPLO OBSERVAÇÃO
Data e Hora 10/02/2010
00:00:10
Encontra em propriedades do tipo
Data e Hora. Se somente a data é
especificada, encontra todas as
ocorrências desta data, independente
da hora. Se somente a hora é
especificada, encontra todas as
ocorrências desta hora, independente
da data. Os milissegundos são
ignorados na pesquisa
Inteiro 0
100
Encontra em todas as propriedades
numéricas. Pesquisar por 10 encontra
10 e 10.0, mas não encontra 10.1 ou
100
Ponto flutuante 10.0
40,5
Encontra em todas as propriedades
numéricas de tipo Ponto Flutuante.
Pesquisar por 10.1 não encontra 10
(inteiro). As configurações regionais
do Windows são consideradas para
validar o símbolo decimal no número
Cor 255,255,0
0,0,234
Encontra apenas em propriedades do
tipo Cor. Deve necessariamente usar
vírgulas para separar os valores, que
devem estar no sistema RGB, ou seja,
três grupos de valores variando entre
0 (zero) e 255
Booleano Verdadeiro
True
Leva em consideração o idioma do
Windows para entender a pesquisa
como sendo de um valor Booleano
String Teste
Tag
Encontra Strings inteiras ou partes de
Strings, de acordo com o tipo de
pesquisa, por palavra inteira ou não.
Qualquer tipo de dado pode ser
encontrado em propriedades do tipo
String
2.4.5 Relatório de Versões
A ferramenta Relatório de Versões permite a visualização das versões e comentários dos projetos e das bibliotecas
abertos, pertencentes ou não ao Domínio. Para acessar esta ferramenta, clique em Relatório de Versões na barra
de ferramentas Padrão para mostrar a caixa de diálogo da figura a seguir.
27 
 
 E3 Studio
Relatório de versões
As opções desta caixa de diálogo são mostradas na tabela a seguir.
Opções disponíveis na caixa de diálogo Relatório de versões
OPÇÃO DESCRIÇÃO
Projeto/Biblioteca Nome do projeto ou da biblioteca abertos
Versão Indica a versão do projeto ou biblioteca. Esta versão é
gerada internamente pelo E3, sendo incrementada toda
vez que um projeto é salvo, manual ou automaticamente.
No caso de projetos ou de bibliotecas protegidos, se a
versão não puder ser salva, também não é possível
incrementá-la. No entanto, se o usuário tem permissão
para abrir e alterar um projeto ou biblioteca, a versão é
incrementada normalmente
Comentário Mostra o comentário relacionado ao projeto. Este
comentário pode ser editado através da propriedade
DocString. No caso de bibliotecas, este campo
permanece em branco
NOTA
Estes campos são apenas para visualização, não sendo permitida sua edição.
2.4.6 Verificação de Domínio
A ferramenta Verificação de Domínio verifica erros de configuração em todo o Domínio, tais como objetos com o
mesmo nome e Associações ilegais, entre outros. Para usar esta ferramenta, clique em Verificação de Domínio na
barra de ferramentas Padrão para mostrar a janela da figura a seguir.
Janela Verificação de Domínio
E3 Studio 
 
 28
As opções disponíveis nesta janela estão descritas na tabela a seguir.
Opções disponíveis na janela Verificação de Domínio
OPÇÃO DESCRIÇÃO
Limpa a lista de erros Remove todas as mensagens da lista de resultados
Mostra a janela de informações Mostra uma janela com informações detalhadas do erro
selecionado
Executa a verificação Executa o processo de verificação no Domínio atual ou
no objeto selecionado no Organizer
Exportar Lista de Erros Exporta o resultado da verificação para um arquivo no
formato CSV (Comma-Separated Values)
Objeto Caminho completo do objeto em erro
Erro Tipo de erro encontrado
Descrição Descrição detalhada do erro encontrado
Solução Mensagem sugerindo uma solução para o erro
encontrado
Filtro Permite filtrar a lista de erros para as colunas
disponíveis
Ao clicar na opção Mostra a janela de informações , a janela da figura a seguir é mostrada.
Janela Problemas a Resolver
Após solucionar o erro ou erros indicados, a janela da figura a seguir é mostrada.
Janela de sucesso na verificação
Clicar duas vezes em um erro na lista seleciona o objeto correspondente no Organizer, como mostrado na figura a
seguir.
29 
 
 E3 Studio
Objeto com erros selecionado
no Organizer
A ferramenta Verificação de Domínio está disponível no menu Ferramentas do E3 Studio e também no menu
contextual dos objetos do Organizer. Neste caso, a verificação é realizada no objeto selecionado e em seus filhos.
2.4.7 WatchWindow
A ferramenta WatchWindow permite a visualização e edição do valor corrente de qualquer propriedade ou Tag em
tempo de execução no 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
Remover Remove a linha selecionada da lista de objetos da janela
WatchWindow
Atualizar Busca toda a árvore de filhos dos objetos selecionados
atualmente na janela