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
- Acesse o link (Acessar projeto modelo) a seguir e faça o download do projeto modelo (.zip).
- 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:
- Baixe o Wildfly 23 na Central de Downloads Sankhya
- 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.
Updated about 14 hours ago