Preparação de ambiente para desenvolver add-on

As extensões no Sankhya OM são frequentemente utilizadas para atender às necessidades específicas de cada negócio, permitindo a adaptação da plataforma a diferentes cenários. Nesse contexto, o projeto modelo é uma ferramenta que possibilita aos desenvolvedores criarem funcionalidades personalizadas com base nos recursos oficiais da Sankhya.

Este artigo tem como objetivo guiar você na preparação do ambiente de desenvolvimento, desde a configuração do banco de dados até a inicialização do servidor de aplicação, seguindo as melhores práticas recomendadas pela Sankhya para o desenvolvimento desses recursos.

Requisitos

• Servidor de aplicação e banco de dados Sankhya - SDK
• Java 1.8
• IDE para desenvolvimento de projetos em Java - Recomendamos o uso do IntelliJ community ou ultimate
• Gradle - Se estiver utilizando o IntelliJ, não será necessário fazer o download do Gradle, pois ele já vem integrado à IDE.
• Ser registrado na base de desenvolvedores Sankhya.

Requisitos Computacionais

• Processador: Intel Core i5 ou superior.
• Processadores equivalentes AMD Ryzen também são adequados.
• Memória RAM: 16 GB ou mais.
• Armazenamento: SSD de no mínimo 120 GB.

1. Ambiente de desenvolvimento

1.1. Acesso ao projeto modelo

Ao clicar no link para baixar o projeto modelo um arquivo no formato .ZIP será disponibilizado.

Após o download, extraia o conteúdo do arquivo e abra o projeto na sua IDE. Neste exemplo, utilizaremos o IntelliJ.

1.2. Preparação do banco de dados Sankhya

🚧

Se você já possui um banco de dados compatível com o Sankhya configurado, pode pular esta etapa.

Para preparar o ambiente Sankhya para desenvolvimento, certifique-se de estar com o Docker devidamente instalado e configurado no seu ambiente local.

Inicialização do Banco de Dados

Oracle

Preservando a Base de Desenvolvimento

Para garantir a preservação dos dados da sua base de desenvolvimento, através do terminal execute o comando para criar um volume antes de executar o container. Use o comando:

docker volume create skdev-oracle-volume

Após a criação do volume é necessário inicar o container, para isso execute o comando abaixo:

docker run --name skdev-oracle -v skdev-oracle-volume:/u01/app/oracle --shm-size=1g -p 1521:1521 sankhyaimages/oracle-addon-dev-xe:latest

A primeira vez que o container rodar uma série de configurações serão feitas na base de dados, inclusive a importação do dump. Levará de 20 a 30 minutos... Execute o comando abaixo para verificar o log de configuração:

docker logs -f skdev-oracle

Quando toda configuração terminar acesse o Docker e verifique que o container está em execução.

Parando e Reiniciando o Ambiente

Para interromper o banco de dados, execute:

docker stop skdev-oracle

Para reiniciar o ambiente, utilize:

docker start skdev-oracle

MSSQL

Preservando os Dados

Para garantir a preservação dos dados da sua base de desenvolvimento, crie um volume antes de executar o container. Use o comando:

docker volume create mssql_dados

Iniciando o Container

Agora, inicie o container:

docker run -d --name sankhya_sqlserver -p 1433:1433 -v mssql_dados:/var/opt/mssql sankhyaimages/skdev-mssql:1.0.0

Parando e Reiniciando o Ambiente

Para interromper o container, execute:

docker stop sankhya_sqlserver

Para reiniciar o ambiente, use:

docker start sankhya_sqlserver

1.3. Servidor de aplicação

Após inicializar o banco de dados, é necessário instalar e iniciar o servidor de aplicação. Para isso, acesse a Central de Downloads Sankhya e faça o download do WildFly 23.0 e realize os seguintes comandos de acordo com o seu sistema operacional:

Windows

C:\\wildfly_8180\\bin\\standalone.bat

Onde C:\wildfly_8180 é o caminho onde o wildfly está instalado.

Linux

/home/mgeweb/wildfly_producao/bin/./standalone.sh

Onde /home/mgeweb/wildfly_producao é o caminho onde o wildfly está instalado.

Após configurar o WildFly é necessário acessar o WPM: http://localhost:8080/wpm/

A senha de acesso padrão é admin, e ao solicitar o primeiro login será necessário realizar a alteração da senha:

Após redefinir senha e realizar novo login, caso exista alguma nova versão do WPM ela será baixada e instalada no seu ambiente e será necessário realizar novo login:

Após realizar login será necessario realizar as configurações do banco de dados, as credenciais estão descritas no template:

Oracle:

MSSQL:

Finalizado a configuração do banco de dados é necessário baixar e instalar uma nova versão do Sankhya OM, para isso no WPM selecione qual a Release que você irá instalar:

Siga o processo de instalação da versão e ao final seu ambiente estará apto para o desenvolvimento.

👍

Sempre prefira a versão mais recente do Sankhya OM.