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.
  • Registro na base de desenvolvedores Sankhya.

Requisitos Computacionais

  • Processador: Intel Core i5 ou superior (ou equivalente AMD Ryzen)
  • Memória RAM: 16 GB ou mais.
  • Armazenamento: SSD de no mínimo 120 GB.

Passo a passo para a preparação do ambiente

Acesso ao projeto modelo

  1. Acesse o link (Acessar projeto modelo) a seguir e faça o download do projeto modelo (.zip).
  2. Após o download, extraia o conteúdo do arquivo e abra o projeto na sua IDE. Neste exemplo, utilizaremos o IntelliJ, conforme imagem abaixo:

Inicialização do banco de dados (Oracle e SQL Server)

🚧

Observação:

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.
  • Para preservar os dados da base de desenvolvimento, crie um volume antes de executar o container.

Oracle

docker volume create skdev-oracle-volume

SQL Server

docker volume create skdev-mssql-volume
  • Após a criação do volume é necessário inicar o container, para isso execute o comando abaixo:

Oracle

docker run -d --name skdev-oracle --shm-size=1g -p 1521:1521 -p 5500:5500 -v skdev-oracle-volume:/opt/oracle/oradata sankhyaimages/skdev-oracle:1.1.0

SQL Server

docker run -d --name skdev-mssql -p 1433:1433 -v skdev-mssql-volume:/var/opt/mssql sankhyaimages/skdev-mssql:1.1.0
  • O primeiro start do container pode levar de 20 a 30 minutos devido à configuração e importação do dump. Para acompanhar o log insira o comando abaixo:

Oracle

docker logs -f skdev-oracle

SQL

docker logs -f skdev-mssql
  • Após finalizar toda a configuração, acesse o docker e verifique que seu container está em execução.

Dados de conexão

Oracle

Para conectar na base de dados Oracle, basta utilizar os seguintes dados de conexão:

Endereço: 127.0.0.1
Porta: 1521
SID: XE
Usuário: SANKHYA
Senha: developer

SQL Server

Para conectar na base de dados SQL, basta utilizar os seguintes dados de conexão:

URL: localhost
Porta: 1433
Banco: jiva
Usuário: SANKHYA
Senha: developer

Parando e reiniciando o container docker

Para interromper o ambiente de desenvolvimento, execute:

Oracle

docker stop skdev-oracle

SQL Server

docker stop skdev-mssql

Para reiniciar o ambiente, utilize:

Oracle

docker start skdev-oracle

SLQ Server

docker start skdev-mssql

Instalação e configuração do servidor de aplicação (Wildfly)

Após inicializar o banco de dados, é necessário instalar e iniciar o servidor de aplicação. Para isso:

  1. Baixe o Wildfly 23 na Central de Downloads Sankhya
  2. Execute os comandos conforme 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

(Sendo /home/mgeweb/wildfly_producao é o caminho onde o wildfly está instalado.)

Habilitando o modo debug

Basta iniciar o Wildfly com o sufixo --debug.

Exemplo:

./standalone.sh --debug

Este comando habilita o modo debug automaticamente na porta padrão (8787), sem a necessidade de edições manuais.

🚧

Atenção para usuários do Windows:

Antes de iniciar o servidor WildFly, verifique se nenhuma outra aplicação está utilizando as portas do banco de dados. Isso é importante para evitar conflitos de porta, que podem impedir o WildFly de iniciar corretamente.


Configuração inicial do WPM e Sankhya Om

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

No primeiro acesso, a senha padrão é admin. Após efetuar o primeiro acesso, você será solicitado a alterá-la:

Caso haja atualização do WPM, a nova versão será baixada e instalada automaticamente. Faça login novamente após a atualização.


Configure os dados de conexão com o banco de dados utilizando as credenciais informadas anteriormente (Oracle e SQL Server)

Oracle:


SQL Server:

Finalizada a configuração com o banco de dados, baixe e instale a versão desejada do Sankhya Om no WPM.

Siga o processo de instalação da release escolhida. Ao final, seu ambiente estará pronto para o desenvolvimento.

👍

Dicas extras:

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