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, 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

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

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

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

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

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.

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.