A ferramenta Dataplace Refactor foi criada a partir da necessidade do alinhamento das personalizações dos engine codes(ECs), com o novo padrão de engine code que fica armazenado no banco de dados. Essa ferramenta faz a leitura do EC personalizado e o traduz para o novo padrão de EC do Dataplace que surgiu no projeto GoNet.
O Dataplace possui engine codes em vários pontos do sistema que permitem a sua personalização ampliando as regras de negócio aplicada aos processos da empresa, dessa forma com a necessidade da melhoria tecnológica do novo padrão de engine code desenvolvido pela Dataplace surge a necessidade de alinhar os engine codes antigos personalizados com o novo modelo sem perder seus recursos personalizados.
A ferramenta Dataplace Refactor tem o papel de fazer o alinhamento entre o engine code personalizado que é armazenado em um arquivo para o novo padrão de engine code que fica armazenado no banco de dados.
Para acessar a ferramenta, abra o módulo SymphonyRefactor, na pasta Install do diretório do sistema. No módulo vá em menu Ferramentas >> Engine Code Refactor.
Vantagens
O novo modelo padrão de Engine Code nos dá as seguintes vantagens no seu uso:
- Padronização da estrutura dos métodos e chamadas dos Engine Codes;
- Controle ao acesso e edição do engine code;
- Rastreabilidade;
- O Engine code é armazenado diretamente no banco de dados da empresa. Como engine code é armazenado no banco de dados da empresa é possibilitado maior segurança, pois o backup do banco de dados da empresa também assegura o backup das personalizações de engine code já migrados.
Para o correto funcionamento da ferramenta Dataplace Refactor é necessário que os arquivos “Sym_RfcEgnCodeRef.xml” e “Sym_RfcEgnCodeChange.xml” estejam na pasta XML da instalação do Dataplace.
Configurações
Ao clicar em Configurações, será exibido container que contém todas as configurações das ferramentas.
Para ativar as configurações marque , caso contrário ela não será aplicada.
Caminho para o EGN padrão
Caminho em que os Engine Codes padrões se encontram.
Caminho para o EGN personalizado
Caminho em que os Engine Codes personalizados se encontram (pasta_de_instalaçãoscript)
Refatorar padrão
Habilita a refatoração do Engine Code padrão.
Refatorar personalizado
Habilita a refatoração do Engine Code personalizado.
Refatorar EGNs já refatorados
Esta opção restaura o Engine Code do subdiretório criado ‘refactorbackup’ para ser refatorado novamente.
Executar Análise de Sintaxe
Esta opção executa análise sintática no Engine Code. É um recurso muito interessante pois possibilita a identificação rápida de problemas pós refatoração.
Chamar diff após refatorar
Esta opção possibilita a chamada de um comparador de diferenças após cada refatoração. O mesmo deve ser parametrizado para o seu uso pelo botão Configurar.
Não Atualizar EGNs personalizados
Esta opção habilita ou não atualização de EGNs personalizados, que são os EGNs que possuem o sufixo ‘_custom’ .
O processo de refatoração continuará mesmo após aberta a aplicação de diff.
Configurar
Possibilita a configuração de um comparador de diferenças
Seleção
Referência
É a referência de refatoração que agrupa as refatorações necessárias de um determinado período de migração.
Selecionar pack específico
Habilitando esta opção, será possível filtrar os dados pelo Pack referente ao release (lançamento).
Selecionar intervalo do pack
Habilitando esta opção, será possível filtrar os dados entre os Packs do release.
Pesquisa
Campo de pesquisa.
Coluna
Coluna que será pesquisada no grid sendo ele EgnCodeID (File) ou EngineCodeID (Database).
Na coluna EgnCodeID (File) são exibidas as descrições dos arquivos localizados na pasta Script, na coluna EgnCodeID (Database) são exibidos os códigos dos EGNs refatorados para o banco de dados.
Quais os cuidados de Pré processamento ?
Se a opção ‘Refatorar personalizado’ estiver habilitada somente ECs que possuem o sufixo ‘_custom’ serão considerados. As extensões suportadas são ‘.egn’, ‘.txt’.
Como vou identificar qual Engine Code foi migrado para o novo padrão?
Os Engine Codes que serão considerados para a refatoração são os que possuem nova ID de objeto, para saber quais são eles acesse a lista de Engine Codes Migrados, na página O que há de novo do WebHelp.
O que acontece os arquivos de Script ?
Os diretórios ‘refactorbackup’ e ‘refactornew’ serão criados como subdiretórios dos caminhos especificados. O caminho precisará estar habilitado para que a operação seja realizada.
Como faço para verificar as mensagens de advertência ou informações referentes a refatoração?
Para visualizar é necessário habilitar a visualização avançada, clicar no botão e clicar em Visualização avançada, a tela do Symphny Refactor irá mudar, permitindo visualizar informações referente ao processo da refatoração das Engine Codes, avisos e inconsistências conforme a imagem abaixo: