Migrando extensões desenvolvidas com DWF para o Add-on Studio

A manutenção de extensões desenvolvidas com o DWF pode ser complexa, pois exige a restauração de backups do banco de dados e a configuração de um ambiente compatível com as ferramentas legadas.

Com o lançamento do Add-on Studio, esse processo se torna mais simples e eficiente, permitindo a evolução e manutenção das extensões diretamente na nova ferramenta, eliminando a dependência do DWF. Para isso, é necessário restaurar e importar o dicionário de dados para a nova estrutura.

Como Restaurar e Importar o Dicionário de Dados

A partir do terminal de sua preferência, utilize o comando cd para acessar o diretório raiz do seu projeto e execute o seguinte comando

./gradlew importAndConvertDD -PlocationMetadata=/caminho/para/seu/arquivo/metadata.xml -PlocationScripts=/caminho/para/o/diretório/dos/seus/scripts/

🚧

ATENÇÃO

Substitua /caminho/para/seu/arquivo/metadata.xml e /caminho/para/o/diretório/dos/seus/scripts/ pelos caminhos reais dos seus arquivos. Onde:

• locationMetadata deve ser um arquivo .xml.
• locationScripts deve ser um diretório contendo os scripts .sql nomeados como "mssqlserver.sql" e "oracle.sql", seguindo o padrão esperado.

O comando iniciará o processo de importação e conversão, analisando o dicionário de dados legado e adaptando-o para o novo formato. Os arquivos convertidos serão armazenados nas pastas datadictionary e dbscripts, ambas na raiz do projeto.

Para melhor organização e manutenção, os metadados são estruturados separadamente, contemplando contextos como menus, tabelas, pastas nativas e tabelas nativas.

❗️

IMPORTANTE

Durante a geração das tabelas, é essencial definir a primary key corretamente para garantir o perfeito funcionamento das funcionalidades associadas.