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.

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 é necessário recomendamos a instalação do Oracle na sua máquina

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

• 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; 
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.

Videoaula Etapa 1 - Subindo o dump usuário

Etapa 2 - Preparando o banco de dados

• Instale o Dbeaver e crie uma nova conexão com a base

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.
  SQL

  SELECT* FROM USER_TABLES;
  

Verificação de erros do Dump

• Execute o comando abaixo para verificar se possui erros no banco de dados
  SQL

  SELECT* FROM USER_ERRORS;
  

🚧

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.

Videoaula Etapa 2 - Preparando o banco de dados

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

• Pesquise por Wildfly e faça a instalação do plugin

Videoaula Etapa 3 - Preparando o Eclipse

Etapa 4: Preparando o Wildfly

• No marketplace do Eclipse, pesquise por Jboss e instale o 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:

• 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.

• 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

• Após adicionar o JDK selecione o mesmo como Default

• Na aba servidor, de dois cliques no servidor criado, em seguida clique em Runtime Environment

• Alterne o JRE selecionando o JDK 1.8.0_121

• Ainda em overview, agora selecione Open launch configuration

• 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:

• 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

Videoaula Etapa 4 - Preparando 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

• Selecione a opção [4] registrar servidor, informe o nome do seu servidor, em seguida o diretório de instalação

• 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.

• Após selecionar o Wildfly, selecione a opção [1] Configurar banco de dados

• Em seguida, selecione a opção [1 ]novamente, Editar configuração.

• 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

• No eclipse, na aba servidores, clique com botão direito de start no servidor e aguarde a compilação.

⚠️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.

Videoaula Etapa 5 - Configurando o banco de dados

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.