Migrando da versão 19.1.14 para a versão 20.0.15

Uma das maiores preocupações ao implementar novas versões do MenuFlex é a de tornar o processo de migração para os desenvolvedores que estiverem usando a versão anterior do MenuFlex o mais simples possível. Abaixo seguem os detalhes do processo de migração.

Atenção

  • Os passos descritos pressupõem que a versão atual do MenuFlex é a versão 19.1.14. Se a versão atual for a 19.1.13, primeiro deve ser feita a migração para a versão 19.1.14, conforme descrito no tópico "Migrando para a versão 19.1.14", para depois migrar para a versão 20.0.15.
  • Devido a alteração da codificação dos caracteres de OEM para UTF-8 feita no DataFlex, a partir da versão 20.0, ao realizar a migração do MenuFlex para versão igual ou superior a 20.0.15, as senhas cadastradas ficarão inválidas, obrigando que sejam recadastradas. Sugerimos aos desenvolvedores que criem um projeto de teste, somente com a view de usuário e recadastrem as senhas.

Pré-requisitos

Para que a migração da versão 19.1.14 para a versão 20.0.15 ocorra sem problemas, os seguintes pré-requisitos devem ser observados:

  • O desenvolvedor não pode ter alterado nenhuma das tabelas que fazem parte do MenuFlex. 
  • O desenvolvedor não pode ter alterado nenhum pacote integrante do MenuFlex, incluindo os dicionários de dados das tabelas do MenuFlex, que serão substituídos pelos dicionários de dados da nova versão. 
  • A sua Workspace deve estar na versão 20.0 do DataFlex. Portanto, se necessário, faça primeiro a migração da sua Workspace antes de continuar. Ao migrar sua Workspace, o assistente de migração irá alertar que a Library do MenuFlex também precisa ser convertida. Neste caso, após um backup, faça a migração da Library antiga do MenuFlex no local original dela.
  • A não observação dos pré-requisitos acima pode provocar problemas no processo de migração.

Backup

Antes de iniciar o processo de migração na área de desenvolvimento é recomendado que seja feito um backup de todas as Workspaces e Libraries que serão migradas.

Antes de iniciar o processo de atualização na área de produção é recomendado que seja feito um backup da base de dados e dos programas compilados.

Migração passo-a-passo

Removendo a Library antiga e acrescentando a Library nova

Primeiramente é necessário remover a Library da versão 19.1.14 e acrecentar a Library da versão 20.0.15 da seguinte forma:

  • Acessar "Tools > Maintain Libraries";
  • Remover a Library do MenuFlex "antiga";
  • Acrescentar a Library da versão 20.0.15 localizando o arquivo sws da nova versão.

Copiando os dicionários de dados

A próxima etapa é copiar os arquivos .DD. A partir do diretório DDSrc da NovaWorkspace, copie todos os arquivos .DD para o diretório DDSrc da sua Workspace.

Copiando e registrando a MenuFlex.dll na sua workspace

Copie os arquivos abaixo que estão no arquivo MenuFlex20_0_15_DLLs.zip (deve ser efetuado o download deste arquivo através do link enviado no e-mail de distribuição do MenuFlex), para o diretório Programs da sua Workspace:

  • desregistraW10DLL_MenuFlex.bat
  • desregistraW10DLL64_MenuFlex.bat
  • DllInscE32.dll
  • MenuFlex.dll
  • registraW10DLL_MenuFlex.bat
  • registraW10DLL64_MenuFlex.bat

Após a cópia, clique com o botão direito no bat registraW10DLL_MenuFlex.bat e escolha "Executar como administrador" para registro para 32 bits ou faça o mesmo com arquivo registraW10DLL64_MenuFlex.bat para registro para 64 bits.

Acrescentando arquivos de imagem no executável

A partir do menu principal do Studio escolher a opção “Project > Project Properties”, pressionar então o botão “Scan for images”, escolher “Sim” e aguardar o Studio fazer a varredura nos arquivos para criar a lista de ícones e bitmaps usados no projeto.

Executar a leitura das imagens para cada um dos projetos da workspace.