SDK Sankhya
O SDK Sankhya é um conjunto de ferramentas e bibliotecas para desenvolvimento de personalizações e customizações na plataforma Sankhya. Confira a seguir o passo a passo de instalação de configuração do seu ambiente.
![Etapas configuração de ambiente - SDK Sankhya](https://files.readme.io/59fd74e-sdk.png)
Etapas configuração de ambiente - SDK Sankhya
Recursos e ferramentas para configuração (TOOLBOX)
-
Wildfly: Será o nosso servidor de aplicação para desenvolvimento. Os binários já existem representam o sankhya-om versão 4.18b9 que usaremos de base para os desenvolvimentos.
-
DumpOracle: É uma cópia de um banco aqui chamado de PRODUCAO porém é uma base de teste comuns também na versão 4.18b9 pronta para ser usada no desenvolvimento.
-
Eclipse: IDE de desenvolvimento usada para desenvolvimento e build dos projetos.
Já está configurada para o wildfly e build de ants de extensão no wildfly. Baixe a versão mais recente caso não tenha instalado. -
SankhyaW_Gerenciador_Pacotes: Usado para atualizar e instalar versões e extensão.
Importante
Antes de iniciar a instalação do SDK, caso ainda não tenha, recomendamos a instalação do Oracle (versão 18c) na sua máquina 📦Download instalador Oracle XE
Etapa 1 - Subindo o dump usuário
-
Crie uma pasta Sk-Java no disco local a mesma será utilizada em todo o processo.
-
Baixe a toolbox
-
Descompacte os arquivos da toolbox na pasta Sk-Java criada
- Libs
- sankhya_format_eclipse
- SkWExtensionTools
- jdk1.8.0_121
- gerenciador de pacotes
-
Acesse o CMD em modo administrador
-
Conecte no sqlplus como sysdba
sqlplus /nolog
conn sys as sysdba
- Habilite os scripts no Oracle
alter session set “_ORACLE_SCRIPT”=true;
- Altere o charset do banco para WE8MSWIN1252
STARTUP MOUNT;
ALTER SYSTEM ENABLE RESTRICTED SESSION;
ALTER SYSTEM SET JOB_QUEUE_PROCESSES=0;
ALTER DATABASE OPEN;
ALTER DATABASE CHARACTER SET INTERNAL_USE WE8MSWIN1252;
SHUTDOWN IMMEDIATE;
STARTUP;
- Crie o Tablespace, verifique o diretório (Substitua o USER)
CREATE BIGFILE TABLESPACE SANKHYA
DATAFILE 'C:\app\<USER>\product\18.0.0\oradata\XE\SANKHYA.DBF'
SIZE 100M
AUTOEXTEND ON;
- Crie o usuário ATACADISTRIB com o comando abaixo:
CREATE USER ATACADISTRIBS IDENTIFIED BY tecsis;
GRANT CONNECT, RESOURCE, DBA TO ATACADISTRIBS;
GRANT ALL PRIVILEGES TO ATACADISTRIBS;
GRANT DBA TO ATACADISTRIBS;
GRANT SELECT ON DBA_TRIGGERS TO ATACADISTRIBS;
GRANT SELECT ON DBA_OBJECTS TO ATACADISTRIBS;
GRANT SELECT ON V_$SESSION TO ATACADISTRIBS;
GRANT SELECT ON V_$INSTANCE TO ATACADISTRIBS;
grant execute on dbms_crypto to ATACADISTRIBS;
grant execute on dbms_OUTPUT to ATACADISTRIBS;
grant execute on DBMS_OBFUSCATION_TOOLKIT to ATACADISTRIBS;
exit sqlplus
- importe o dump da toolbox utilizando o comando abaixo:
imp system/123456 file=C:\oraclexe\app\oracle\admin\XE\dpdump\PRODUCAO.dmp feedback=5000 statistics=none log=import.log fromuser=PRODUCAO touser=ATACADISTRIBS
Para a importação utilizamos o usuário system, o local de arquivo de dump, feedback a cada 5 segundos, o log é registrado no arquivo de log e também
- A importação pode levar alguns minutos pois são muitas tabelas. aguarde o fim do procedimento.
Etapa 2 - Preparando o banco de dados
- Instale o Dbeaver e crie uma nova conexão com a base
![](https://files.readme.io/2336740-01_2.png)
Username ATACADISTRIBIS
Password: Utilize a senha que você criou para o usuário. tecsis
- Execute o comando abaixo para verificar se todas as tabelas do sistema foram criadas. Após a execução do comando em seu SGBD, devem aparecer as tabelas do sistema Sankhya.
SELECT* FROM USER_TABLES;
Verificação de erros do Dump
- Execute o comando abaixo para verificar se possui erros no banco de dados
SELECT* FROM USER_ERRORS;
- Execute o comando abaixo para recompilar objetos com inconsistências
SELECT 'ALTER ' || "TYPE" || ' ' || "NAME" || ' COMPILE;' FROM USER_ERRORS GROUP BY "TYPE", "NAME";
Verificação de erros:
Verifique se existe algum erro relacionado com alguma tabela que será necessária para o desenvolvimento da sua extensão, caso os erros não possuam dependências, os mesmos podem ser ignorados e corrigidos posteriormente caso seja necessário.
O dump fornecido pode possuir algumas views de uma extensão, selecione as views e faça o drop realizando o comando abaixo:
SELECT 'drop view '||name||', ' FROM USER_ERRORS WHERE name like '%MAXIMAS%' GROUP BY name;
Caso possua erros, selecione as tabelas do código de erro e verifique quais são os erros, no vídeo a seguir é apresentado como identificar e corrigir possíveis erros caso necessite ajustar algum.
Etapa 3 - Preparando o Eclipse
- Baixe e instale o Eclipse Java EE IDE em sua máquina apontando a pasta SK-Java como diretório de instalação.
- Baixe o Loombok e salve o mesmo na pasta SK-Java
- Com o Eclipse instalado, verifique se o Wildfly já está instalado
Window > Show View > Servers - Clique na aba Servers, para adicionar um novo servidor
![Aba servers Eclipse](https://files.readme.io/0fe2850-01.1.png)
Aba servers Eclipse
- Pesquise por Wildfly e faça a instalação do plugin
![Instalação plugin](https://files.readme.io/81a3c17-02.2.png)
Instalação plugin
Etapa 4: Preparando o Wildfly
- No marketplace do Eclipse, pesquise por Jboss e instale o plugin Jboss Tools
![Plugin Jboss Tools](https://files.readme.io/1afbc7d-image15.png)
Plugin Jboss Tools
- Aguarde a instalação e reinicie o Eclipse.
- Na aba servidores clique em novo servidor e pesquise por Wildfly
- Selecione o Wildfly11 e execute as configurações conforme imagem abaixo:
![Configuração Wildfly](https://files.readme.io/03c9eed-image20.png)
Configuração Wildfly
- Agora vamos ajustar algumas configurações, siga o caminho Window > preferences pesquise por Compiler e selecione 1.8 versão do java que vamos trabalhar.
![Configuração Wildfly](https://files.readme.io/1f49a5e-image7.png)
Configuração Wildfly
- Agora, ainda no caminho Window > preferences pesquise por JDK e na aba Installed JREs, Clique em Add > next e selecione a pasta jdk1.8.0_121 da toolbox presente na pasta SK-Java
![Configuração Wildfly](https://files.readme.io/17cbc21-image13.png)
Configuração Wildfly
- Após adicionar o JDK selecione o mesmo como Default
![Configuração Wildfly](https://files.readme.io/0dccbd2-image19.png)
Configuração Wildfly
- Na aba servidor, de dois cliques no servidor criado, em seguida clique em Runtime Environment
![Configuração Wildfly](https://files.readme.io/fff0d1e-image3.png)
Configuração Wildfly
- Alterne o JRE selecionando o JDK 1.8.0_121
![Configuração Wildfly](https://files.readme.io/07a8d6e-image5.png)
Configuração Wildfly
- Ainda em overview, agora selecione Open launch configuration
![Configuração Wildfly](https://files.readme.io/245e41b-image4.png)
Configuração Wildfly
- Vamos fazer algumas configurações no VM arguments, inicialmente, vamos alterar o tamanho mínimo e máximo de memória, altere para 512m e 2018m conforme imagem abaixo:
![Configuração Wildfly](https://files.readme.io/01f75c7-image17.png)
Configuração Wildfly
- Agora vamos adicionar alguns (- d´s ) essenciais para desenvolvimento na plataforma Sankhya), devem ser adicionados no fim do campo VM arguments
-Djape.verbose=false
-Djape.ignore.ligacao.inconsistente=true
-Djape.lazy.init=true
-Dhtm15.enable.beta.screens=true
-Dsankhyaw.dicionario.ignorarvalidacao=true
-Dsnk.authorization.layer.enable=true
![Configuração Wildfly](https://files.readme.io/c093700-image10.png)
Configuração Wildfly
Etapa 5 - Configurando o banco de dados no servidor
- Abra o arquivo gerenciador de pacotes contido na pasta Sk-java
- Na pasta bin execute o Sankhya package manager
![Configuração Gerenciador de pacotes](https://files.readme.io/cef3313-image6.png)
Configuração Gerenciador de pacotes
- Selecione a opção [4] registrar servidor, informe o nome do seu servidor, em seguida o diretório de instalação
![Configuração Gerenciador de pacotes](https://files.readme.io/c27227a-image9.png)
Configuração Gerenciador de pacotes
- Após registrar o servidor, no menu selecione a opção [2] selecionar servidor, e selecione o servidor registrado (Wildfly) Utilize o mesmo nome que voce deu ao servidor na etapa 2 deste tutorial.
![Configuração Gerenciador de pacotes](https://files.readme.io/e7daf8a-image18.png)
Configuração Gerenciador de pacotes
- Após selecionar o Wildfly, selecione a opção [1] Configurar banco de dados
![Configuração Gerenciador de pacotes](https://files.readme.io/260af22-image12.png)
Configuração Gerenciador de pacotes
- Em seguida, selecione a opção [1 ]novamente, Editar configuração.
![Configuração Gerenciador de pacotes](https://files.readme.io/1c7e575-image14.png)
Configuração Gerenciador de pacotes
- Selecione o tipo de banco [oracle], e preencha os campos solicitados: IP, porta, XE, usuário, senha e faça o teste.
- Verifique a mensagem "Teste realizado com sucesso" e volte ao Eclipse
![Configuração Gerenciador de pacotes](https://files.readme.io/0ab5a9d-image11.png)
Configuração Gerenciador de pacotes
- No eclipse, na aba servidores, clique com botão direito de start no servidor e aguarde a compilação.
![](https://files.readme.io/3ae2940-image2.png)
⚠️Ignore alguns erros que aparecem durante a compilação, são dependências de geolocalização ou outros pontos que não vão interferir no seu ambiente.
- Após subir o servidor, teste em seu navegador o endereço localhost8080/mge/
⚠️ A porta pode variar de acordo com a configuração feita no inicio do processo, caso sua porta esteja diferente de 8080 veja na videoaula abaixo os mapeamentos e pontos no XML que precisam ser modificados. Se sua porta for 8080 desconsidere esta parte.
![](https://files.readme.io/01ad676-07.jpg)
Pronto, seu ambiente está configurado!
Como tirar dúvidas?
Deu algum erro na configuração do seu ambiente e precisa tirar alguma dúvida, use a sala SDK da comunidade Sankhya Developer.
Updated 5 months ago