{"id":18127,"date":"2026-09-10T09:04:44","date_gmt":"2026-09-10T12:04:44","guid":{"rendered":"https:\/\/kb.elipse.com.br\/?p=18127"},"modified":"2026-09-10T09:45:15","modified_gmt":"2026-09-10T12:45:15","slug":"atualizacao-do-elipse-e3-entre-versoes-distantes","status":"publish","type":"post","link":"https:\/\/kb.elipse.com.br\/en\/atualizacao-do-elipse-e3-entre-versoes-distantes\/","title":{"rendered":"Atualiza\u00e7\u00e3o do Elipse E3 entre vers\u00f5es distantes."},"content":{"rendered":"
\n
\n

Pontos de aten\u00e7\u00e3o e poss\u00edveis quebras de compatibilidade ao migrar de uma vers\u00e3o antiga para uma atual, organizados vers\u00e3o a vers\u00e3o, com valida\u00e7\u00e3o antes de produ\u00e7\u00e3o.<\/p>\n<\/div>\n<\/div>\n

\n
\n

1.<\/span> Introdu\u00e7\u00e3o<\/h2>\n

\u00c9 comum uma aplica\u00e7\u00e3o antiga do Elipse E3 precisar migrar para uma vers\u00e3o atual \u2014 por fim de suporte, requisitos de sistema ou novos recursos. A d\u00favida recorrente \u00e9: o que precisa ser refeito ou alterado na aplica\u00e7\u00e3o?<\/em><\/p>\n

A regra geral \u00e9 a retrocompatibilidade<\/strong>: aplica\u00e7\u00f5es de vers\u00f5es anteriores continuam funcionando em vers\u00f5es iguais ou superiores. Num salto de v\u00e1rias vers\u00f5es, por\u00e9m, alguns recursos foram descontinuados ou removidos e outros tiveram o comportamento alterado no caminho. O quadro abaixo organiza esses pontos vers\u00e3o a vers\u00e3o<\/strong>, para que a revis\u00e3o da aplica\u00e7\u00e3o acompanhe exatamente o que mudou em cada etapa.<\/p>\n<\/section>\n

\n

2.<\/span> Pontos de aten\u00e7\u00e3o por vers\u00e3o<\/h2>\n

O s\u00edmbolo \u26a0<\/span> marca itens que podem quebrar a compatibilidade<\/strong> ou exigir ajuste de c\u00f3digo\/configura\u00e7\u00e3o.<\/p>\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Vers\u00e3o<\/th>\nPontos de aten\u00e7\u00e3o e poss\u00edveis quebras<\/th>\n<\/tr>\n<\/thead>\n
4.7<\/td>\n\u26a0<\/span> A chave de prote\u00e7\u00e3o passa a definir o intervalo de vers\u00f5es execut\u00e1veis (obrigat\u00f3rio em licen\u00e7as Runtime) \u2014 uma chave programada para a 4.6 n\u00e3o \u00e9 reconhecida pelo E3 4.7 ou superior.
\n<\/span>\u26a0<\/span> Mudan\u00e7as de comportamento em runtime: uma Associa\u00e7\u00e3o por Tabela<\/strong> passa a atualizar quando a linha \u00e9 alterada por script (antes n\u00e3o atualizava); e renomear um objeto<\/strong> (ex.: driver de I\/O) e aplicar passa a desativar\/reativar o objeto no dom\u00ednio em execu\u00e7\u00e3o (dispara OnStartRunning<\/code>\/reconex\u00e3o do driver).<\/span><\/td>\n<\/tr>\n
4.8<\/td>\nNovos objetos OPC UA (Assinatura \/ Tag \/ Bloco) \u2014 possibilitam a comunica\u00e7\u00e3o de tempo real via OPC UA (cliente).<\/span>
\nNovo ElipseX XFolder<\/code> e propriedade EnableTagBehavior<\/code> \u2014 mudan\u00e7as no modelo de bibliotecas ElipseX.<\/span>
\n\u26a0<\/span> Mudan\u00e7as de comportamento: o MouseUp<\/code> do E3Browser passa a disparar ap\u00f3s<\/em> a sele\u00e7\u00e3o da linha (handlers que leem a linha selecionada veem outra linha); e a escrita de um Viewer-Only<\/strong> em tag de dom\u00ednio remoto passa a ser bloqueada.<\/span><\/td>\n<\/tr>\n
5.0<\/td>\n\u26a0<\/span> Campos de Hist\u00f3rico e Storage viram objetos em cole\u00e7\u00e3o (Fields<\/code>), com \u00edndices e chaves por objetos: um Hist\u00f3rico salvo na 5.0, por exemplo, n\u00e3o abre nem funciona em vers\u00f5es anteriores.<\/span>
\n\u26a0<\/span> Propriedade Events<\/code> renomeada para ObjectEvents<\/code> (quebra scripts).<\/span>
\n\u26a0<\/span> Application.GetObject<\/code> passa a validar o caminho inteiro e recusa caminhos que terminam em uma propriedade (n\u00e3o-objeto): GetObject(\"obj.Prop\")<\/code> passa a dar erro.<\/span>
\nAlinhamento de Tela\/Viewer passa a ser controlado por ScreenAlignment<\/code> (default paTopLeft<\/code>, mantido na migra\u00e7\u00e3o e em novas aplica\u00e7\u00f5es).<\/span>
\n\u26a0<\/span> Com o descolamento da tela<\/strong> (\u00e2ncora no canto superior esquerdo), passam a ser renderizados apenas os objetos dentro da \u00e1rea vis\u00edvel<\/strong> da tela. Aplica\u00e7\u00f5es que usavam MoveFrame<\/code> para “revelar” objetos fora dessa \u00e1rea ao redimensionar telas janeladas\/modais<\/strong> deixam de exibi-los (surge a cor de fundo no lugar). O MoveFrame<\/code> altera o tamanho do quadro<\/em>, n\u00e3o o da tela: ajuste o tamanho da tela no Studio e abra com zoom 100% sem rolagem (?100?0<\/code>), ou ajuste Width<\/code>\/Height<\/code> no evento OnPreShow<\/code>.<\/span><\/td>\n<\/tr>\n
5.1<\/td>\nNovo m\u00e9todo LoginWindowsUser<\/code> (login silencioso com usu\u00e1rio do Windows).<\/span><\/td>\n<\/tr>\n
5.5<\/td>\nObjeto [?Server]<\/code> exp\u00f5e informa\u00e7\u00f5es de servidor, clientes, dom\u00ednios remotos e licen\u00e7a.<\/span>
\nArquivamento (Shelve<\/em>) de alarmes: o operador pode suprimir temporariamente um alarme por um tempo definido (norma ISA 18.2).
\n<\/span>\u26a0<\/span> OpenScreen<\/code> sem o argumento de zoom passa a abrir a tela em 100%<\/strong>, em vez de herdar o zoom da tela anterior \u2014 aplica\u00e7\u00f5es que dependiam dessa heran\u00e7a mudam em sil\u00eancio.<\/span>
\n\u26a0<\/span> TypeName<\/code> e IsObject<\/code> passam a retornar o valor correto dentro de links\/associa\u00e7\u00f5es \u2014 express\u00f5es que ramificavam no resultado antigo mudam de comportamento.<\/span>
\n\u26a0<\/span> As sess\u00f5es de Studio e Viewer passam a revalidar periodicamente o usu\u00e1rio logado e a propagar renomea\u00e7\u00f5es\/invalida\u00e7\u00f5es \u2014 a sess\u00e3o de um usu\u00e1rio removido que continuava aberta passa a ser encerrada.<\/span><\/td>\n<\/tr>\n
5.6<\/td>\nGrupos de usu\u00e1rios do Windows podem ser cadastrados como grupos do Elipse E3.<\/span>
\n\u26a0<\/span> Criptografia AES-128<\/strong> na comunica\u00e7\u00e3o entre E3 Server e clientes \u2014 quando habilitada, n\u00e3o \u00e9 compat\u00edvel com vers\u00f5es anteriores.<\/span>
\n\u26a0<\/span> Tags criadas por AddObject<\/code> em script do Studio passam a respeitar o par\u00e2metro de ativa\u00e7\u00e3o<\/strong> (antes subiam sempre ativas) \u2014 scripts de setup podem encontr\u00e1-las inativas.<\/span><\/td>\n<\/tr>\n
6.0<\/td>\nComponente TrendAnalysis<\/strong> integrado ao E3.<\/span>
\nProvedor MSOLEDBSQL<\/strong> torna-se o padr\u00e3o para SQL Server \u2014 garanta que o provider esteja instalado. Aplica\u00e7\u00f5es feitas em vers\u00f5es anteriores permanecem com a mesma configura\u00e7\u00e3o.<\/span>
\n\u26a0<\/span> Mudan\u00e7as de comportamento: X<\/code>\/Y<\/code>\/Width<\/code>\/Height<\/code> de Grupo e Conector passam a ser lidos j\u00e1 atualizados por script; ActiveX dentro de um Grupo passam a respeitar a visibilidade\/camada do grupo<\/strong> (alternar Visible<\/code> do grupo passa a ocult\u00e1-los tamb\u00e9m); e n\u00e3o \u00e9 mais poss\u00edvel editar um SetPoint desativado<\/strong>.<\/span><\/td>\n<\/tr>\n
6.1<\/td>\nHot-Standby: uma \u00fanica falha de ping<\/em> deixa de considerar a rede fora de opera\u00e7\u00e3o imediatamente (menos comuta\u00e7\u00f5es desnecess\u00e1rias).<\/span>
\n\u26a0<\/span> Valores inv\u00e1lidos (NaN<\/code>\/infinito) passam a comparar como diferentes<\/strong> de um n\u00famero (antes eram tratados como “iguais”). Como a detec\u00e7\u00e3o de mudan\u00e7a de valor sustenta tags, links e alarmes, transi\u00e7\u00f5es de\/para valor inv\u00e1lido que n\u00e3o<\/strong> disparavam OnValueChange<\/code>, propaga\u00e7\u00e3o de link ou reavalia\u00e7\u00e3o de alarme passam a disparar<\/strong>.<\/span><\/td>\n<\/tr>\n
6.5<\/td>\nAdicionado suporte nativo a MySQL<\/strong> e PostgreSQL<\/strong>.
\n<\/span>\u26a0<\/span> Alarmes<\/strong> ganham a supress\u00e3o por condi\u00e7\u00e3o (by design<\/em>), da norma ISA 18.2 \u2014 confira relat\u00f3rios e consultas sobre a tabela de alarmes.<\/span>
\n\u26a0<\/span> Caminhos de objeto com nomes especiais<\/strong> que resolviam sem colchetes passam a falhar (silenciosamente) \u2014 use colchetes no caminho do objeto.<\/span>
\n\u26a0<\/span> Seguran\u00e7a: ao atualizar aplica\u00e7\u00f5es muito antigas (grupos criados antes da 5.6), as refer\u00eancias de grupos passam a ser carregadas \u2014 membros podem recuperar permiss\u00f5es de grupo que n\u00e3o estavam sendo aplicadas. Revise as permiss\u00f5es efetivas dos usu\u00e1rios ap\u00f3s o upgrade.<\/span><\/td>\n<\/tr>\n
6.6<\/td>\n\u26a0<\/span> Relat\u00f3rio de Se\u00e7\u00e3o<\/strong> adicionado e o objeto Relat\u00f3rio (antigo) marcado como descontinuado<\/strong>.<\/span>
\n\u26a0<\/span> Usu\u00e1rios e grupos do Windows apenas no formato NetBIOS<\/strong> (DOMINIO\\usuario<\/code>).<\/span>
\n\u26a0<\/span> A persist\u00eancia do sum\u00e1rio de alarmes<\/strong> passa a respeitar o intervalo m\u00ednimo (1 minuto) \u2014 aplica\u00e7\u00f5es com persist\u00eancia de sum\u00e1rio habilitada e sem intervalo configurado passam a gravar com frequ\u00eancia diferente (antes o m\u00ednimo era ignorado).<\/span><\/td>\n<\/tr>\n
6.7<\/td>\n\u26a0<\/span> N\u00e3o \u00e9 mais poss\u00edvel inserir Relat\u00f3rios antigos<\/strong>; o Verificador de Dom\u00ednio passa a apont\u00e1-los como erro.<\/span>
\nAlarmes: novo estado Out-Of-Service<\/strong> (fora de servi\u00e7o), da norma ISA 18.2.<\/span>
\n\u26a0<\/span> Seguran\u00e7a: o usu\u00e1rio an\u00f4nimo<\/strong> passa a ser for\u00e7ado a ser t\u00e3o ou mais restritivo que seus grupos, e a heran\u00e7a de permiss\u00f5es<\/strong> \u00e9 recalculada \u2014 aplica\u00e7\u00f5es com acesso an\u00f4nimo, ou que dependiam da resolu\u00e7\u00e3o antiga de permiss\u00f5es, podem perder privil\u00e9gios em sil\u00eancio.<\/span><\/td>\n<\/tr>\n
6.8<\/td>\n\u26a0<\/span> Estampas de tempo no SQL Server passam ao tipo datetime2<\/code> por padr\u00e3o. O provedor antigo 1 - SQLOLEDB<\/code> n\u00e3o suporta<\/strong> datetime2<\/code>: ap\u00f3s o upgrade, o E3Chart deixa de desenhar as penas hist\u00f3ricas<\/strong> e o E3TimeStamp<\/code> pode aparecer zerado (30\/12\/1999). Corre\u00e7\u00e3o: alterar o objeto banco de dados para 2 - MSOLEDBSQL<\/code> \u2014 hist\u00f3ricos novos e antigos voltam a funcionar.<\/span>
\n\u26a0<\/span> O evento OnLogout<\/code> passa a ocorrer apenas quando o usu\u00e1rio ativo volta a ser o an\u00f4nimo \u2014 aplica\u00e7\u00f5es que trocam de usu\u00e1rio via LoginUser<\/code> e tinham l\u00f3gica no OnLogout<\/code> deixam de execut\u00e1-la.<\/span>
\n\u26a0<\/span> Consultas s\u00edncronas do E3Query<\/strong> passam a honrar CursorType<\/code>\/CursorLocation<\/code> (antes fixos) \u2014 scripts que contavam com o cursor fixo (RecordCount<\/code>, bookmarks, rolagem) recebem um recordset diferente.<\/span><\/td>\n<\/tr>\n
6.9<\/td>\n\u26a0<\/span> Objeto E3Playback removido<\/strong>.<\/span>
\n\u26a0<\/span> Relat\u00f3rio (antigo) n\u00e3o \u00e9 mais acess\u00edvel pelo Studio<\/strong>.<\/span>
\nAssocia\u00e7\u00f5es passam a aceitar o prefixo :<\/code> para for\u00e7ar um caminho absoluto<\/strong> (a partir da raiz do projeto). Os novos links j\u00e1 s\u00e3o criados com :<\/code> por padr\u00e3o; links de aplica\u00e7\u00f5es antigas (sem o :<\/code>) continuam v\u00e1lidos e funcionando normalmente.<\/span>
\n\u26a0<\/span> Um ActiveX\/MSForms sem janela<\/strong> que estava inativo passa a ativar e disparar seus eventos tamb\u00e9m no clique do bot\u00e3o do meio\/direito<\/strong> (antes s\u00f3 no esquerdo) \u2014 handlers de Click<\/code> podem executar em cliques antes inertes.<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/section>\n
\n

3.<\/span> Itens que costumam exigir desenvolvimento<\/h2>\n

Relat\u00f3rios (formato antigo) \u2192 Relat\u00f3rio de Se\u00e7\u00e3o<\/h3>\n

Descontinuados a partir da 6.6, n\u00e3o podem mais ser inseridos desde a 6.7 e n\u00e3o s\u00e3o acess\u00edveis pelo Studio na 6.9 (ser\u00e3o totalmente removidos na 7.0). N\u00e3o funcionam na vers\u00e3o 64 bits. Migre para o Relat\u00f3rio de Se\u00e7\u00e3o antes de concluir a atualiza\u00e7\u00e3o<\/strong> \u2014 em uma vers\u00e3o anterior \u00e0 de destino, onde ainda \u00e9 poss\u00edvel abrir os dois formatos \u2014 e teste cada relat\u00f3rio na vers\u00e3o de destino.<\/p>\n

Scripts, propriedades e m\u00e9todos alterados entre vers\u00f5es<\/h3>\n

Ao longo das vers\u00f5es, propriedades e m\u00e9todos foram criados, renomeados ou removidos<\/strong>, e alguns m\u00e9todos tiveram par\u00e2metros adicionados ou alterados<\/strong>. Por isso, depois de instalar a nova vers\u00e3o, recompile os scripts e rode o Verificador de Dom\u00ednio<\/strong> para localizar associa\u00e7\u00f5es e refer\u00eancias inv\u00e1lidas \u2014 principalmente as que apontam para propriedades ou m\u00e9todos removidos ou modificados, como a propriedade ScreenAlignment<\/code> e a cole\u00e7\u00e3o ObjectEvents<\/code> (antiga Events<\/code>).<\/p>\n

Componentes ActiveX e Microsoft Forms (64 bits)<\/h3>\n

Independentemente da vers\u00e3o, componentes ActiveX exclusivamente de 32 bits \u2014 como o Microsoft Forms 2.0<\/strong> (FM20.dll<\/code>) e ActiveX de terceiros \u2014 n\u00e3o abrem no Studio 64 bits. Use o Studio de 32 bits<\/strong> (que acompanha a instala\u00e7\u00e3o da vers\u00e3o 64 bits) ou instale a vers\u00e3o 64 bits do componente (no caso do Microsoft Forms, o FM20.dll<\/code> vem com o Office 64 bits). O E3 Viewer \u00e9 sempre 32 bits<\/strong>.<\/p>\n<\/section>\n

\n

4.<\/span> Licen\u00e7a e requisitos de instala\u00e7\u00e3o<\/h2>\n

A chave de prote\u00e7\u00e3o (hardkey ou softkey) precisa habilitar a vers\u00e3o de destino (a vers\u00e3o atual desejada)<\/strong> \u2014 sem isso, o E3 opera em modo DEMO. A atualiza\u00e7\u00e3o \u00e9 feita pelo setor comercial, informando o n\u00famero da licen\u00e7a. Recursos licenciados \u00e0 parte<\/strong> \u2014 como o Servidor OPC UA<\/strong>, o Storage<\/strong> (por quantidade de tags), os Dom\u00ednios Remotos<\/strong>, Viewers adicionais<\/strong> e os drivers de comunica\u00e7\u00e3o<\/strong> \u2014 tamb\u00e9m precisam estar previstos na licen\u00e7a.<\/p>\n

Os requisitos de sistema<\/strong> (SO, .NET e WebView2) variam conforme a vers\u00e3o de destino e est\u00e3o descritos no artigo Requisitos m\u00ednimos para instala\u00e7\u00e3o do Elipse E3\/Power\/Water<\/em> (ver Artigos relacionados). Se o upgrade falhar, feche todos os m\u00f3dulos do E3 e desinstale manualmente os m\u00f3dulos antigos antes de reinstalar.<\/p>\n<\/section>\n

\n

5.<\/span> Roteiro de atualiza\u00e7\u00e3o e valida\u00e7\u00e3o<\/h2>\n

N\u00e3o atualize direto em produ\u00e7\u00e3o. Para ambientes com Hot-Standby<\/strong>, o roteiro recomendado \u00e9:<\/p>\n

    \n
  1. Backup completo<\/strong> dos arquivos da aplica\u00e7\u00e3o (arquivo .dom<\/code>, .prj<\/code>, .lib<\/code>, bancos hist\u00f3ricos e de alarmes) e tenha em m\u00e3os os instaladores Full da vers\u00e3o de destino e da vers\u00e3o anterior.<\/li>\n
  2. Coloque o servidor Reserva (Standby)<\/strong> em manuten\u00e7\u00e3o<\/strong> pelo E3 Admin (aba Servidores<\/em> das configura\u00e7\u00f5es do Dom\u00ednio). Ele se dessincroniza do servidor ativo e descarrega a aplica\u00e7\u00e3o \u2014 parar o Standby diretamente pararia tamb\u00e9m o servidor ativo<\/strong>.<\/li>\n
  3. Reprograme a chave<\/strong> do servidor reserva para a vers\u00e3o de destino e instale a nova vers\u00e3o do E3<\/strong> (parar a aplica\u00e7\u00e3o, fechar todos os m\u00f3dulos, rodar o instalador). O E3 Server ir\u00e1 iniciar automaticamente.<\/li>\n
  4. Reavalie as configura\u00e7\u00f5es de Firewall e DCOM.<\/strong> Entre vers\u00f5es, m\u00f3dulos do E3 foram renomeados e novos m\u00f3dulos passaram a existir \u2014 as exce\u00e7\u00f5es de Firewall e as permiss\u00f5es de DCOM precisam contemplar os execut\u00e1veis da nova vers\u00e3o (use o Elipse DCOM Wizard; ver “Configura\u00e7\u00e3o de DCOM e Firewall”).<\/li>\n
  5. Tire o servidor de manuten\u00e7\u00e3o e aguarde a aplica\u00e7\u00e3o voltar ao estado Standby<\/strong> (\u00edcone amarelo no E3 Admin) \u2014 n\u00e3o chaveie antes da subida completa.<\/li>\n
  6. Execute os testes de sanidade<\/strong> (ver a lista de verifica\u00e7\u00e3o ao final desta se\u00e7\u00e3o). Havendo problema, o servidor ativo (vers\u00e3o antiga) segue como ambiente seguro.<\/li>\n
  7. Chaveie<\/strong> manualmente para o servidor atualizado (E3 Admin \u2192 Servidor \u2192 Ativar).<\/li>\n
  8. Atualize todos os Viewers remotos<\/strong> para a vers\u00e3o de destino.<\/li>\n
  9. Repita os passos anteriores no outro servidor<\/strong> (o Principal) e, ao final, chaveie de volta para ele \u2014 evita um chaveamento autom\u00e1tico em hor\u00e1rio inesperado.<\/li>\n<\/ol>\n
    \n

    Sem Hot-Standby<\/strong><\/p>\n

    Valide em uma m\u00e1quina de homologa\u00e7\u00e3o<\/strong>, sobre uma c\u00f3pia da aplica\u00e7\u00e3o, antes de ir a produ\u00e7\u00e3o \u2014 uma chave de Studio<\/strong> permite executar por at\u00e9 6 horas para os testes. S\u00f3 ent\u00e3o atualize o servidor de produ\u00e7\u00e3o, em janela de manuten\u00e7\u00e3o.<\/p>\n<\/div>\n

    Configura\u00e7\u00e3o de DCOM e Firewall<\/h3>\n

    A comunica\u00e7\u00e3o entre servidores E3 (Hot-Standby e dom\u00ednios remotos) usa o protocolo REC e n\u00e3o depende de DCOM. J\u00e1 as conex\u00f5es externas e o OPC cl\u00e1ssico (DA) exigem DCOM e Firewall configurados<\/strong> \u2014 uma configura\u00e7\u00e3o manual. Para isso, utilize o Elipse DCOM Wizard<\/strong>, que ajusta as permiss\u00f5es de DCOM e as exce\u00e7\u00f5es de Firewall necess\u00e1rias (ver Artigos relacionados).<\/p>\n

    \n

    Tenha os instaladores \u00e0 m\u00e3o (rollback)<\/strong><\/p>\n

    Mantenha o instalador Full da vers\u00e3o de destino<\/strong> e o da vers\u00e3o anterior<\/strong> (mesma arquitetura, x86 ou 64 bits). Como o projeto salvo na vers\u00e3o nova n\u00e3o funciona corretamente em vers\u00f5es anteriores, o retorno \u00e9 restaurar o backup<\/strong> e, se preciso, reinstalar a vers\u00e3o antiga com esse instalador.<\/p>\n<\/div>\n

    Lista de verifica\u00e7\u00e3o \u2014 itens m\u00ednimos antes de entrar em produ\u00e7\u00e3o<\/h3>\n

    Prepara\u00e7\u00e3o<\/strong><\/p>\n