Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Revisão QA

...

Painel
borderColorgrey
borderStylesolid
 

Requisitos necessários para Web Service Solus




Painel
borderColorgrey
titleColorWhite
borderWidth1px
titleBGColor#AB0047
titleComum aos ambientes

Ter o sistema operacional com as versões abaixo para a utilização do web service:

Debian:

  • Buster 10 (stable) ou superior;
  • Stretch 9 / RaspbianStretch ou superior;
  • Necessário instalar o linux com interface gráfica.

Windows:

  • Windows 7 ou superior.


Expandir
titleDebian


Expandir
titleInstalação JDK 1.8

Para a instalação do JDK 1.8 será necessário realizar por comandos:

Abrir o prompt de comando do Linux com usuário root:

Comece atualizando a lista de pacotes e instalando as dependências necessárias para adicionar um novo repositório por HTTPS:

#apt update  

#apt install apt-transport-https ca-certificates wget dirmngr gnupg software-properties-common

Importe a chave GPG do repositório usando o seguinte comando wget:

wget -qO - https://adoptopenjdk.jfrog.io/adoptopenjdk/api/gpg/key/public | apt-key add -


Adicione o repositório AdoptOpenJDK APT ao seu sistema:

add-apt-repository --yes https://adoptopenjdk.jfrog.io/adoptopenjdk/deb/


Atualizar os repositórios:

# apt update

Depois que o repositório estiver ativado, atualize o apt sources e instale o Java 8 usando os seguintes comandos:

#apt install adoptopenjdk - 8 - hotspot


Ao aparecer a mensagem "você quer continuar?" digitar S > Enter.

Por fim, verifique a instalação da versão do Java, com o comando: java -version



Expandir
titleInstalação Netbeans 13

Baixar o Netbeans do site oficial a partir da versão 13, extensão sh.

Após o download do arquivo .SH execute os comandos para torna-lo executável:

chmod +x Apache-NetBeans-13-bin-linux-x64.sh

Executar o arquivo:

./Apache-NetBeans-13-bin-linux-x64.sh

Na tela inicial clicar em Next:

Selecionar a opção aceitar todos os termos e clicar em next:

Deixar a instalação do Netbeans no caminho padrão, clicar em next:


Selecionar a opção checar updates e clicar em Install:

Ao completar 100% clicar em Next:

Clicar em Finish para completar o processo de instalação:



Expandir
titleInstalação Payara Server 5.2022.2

Payara Server é um servidor de aplicativos de código aberto derivado do GlassFish.

A configuração do Payara pode ser realizada a partir Netbeans:

Executar o netbeans >Window > Services:

Clicar com o botão direito em Servers:

Ao abrir a tela Add Server Instance selecionar Payara Server e clicar em Next:


Marcar a caixa de seleção e clicar em Download now:


Após a conclusão do download clicar em next:


Informar o domínio e clicar em Finish:





Expandir
titleWindows


Expandir
titleInstalação JDK 1.8

Para darmos início da instalação em um ambiente Windows é necessário realizar os seguintes passos:

Baixar e instalar o JDK 1.8 que está disponível no site oficial da Oracle:


 Abrir o executável > clicar Next:


Clicar em Next:


Clicar em Próximo:

Clicar em close:

Após a instalação, seguir para a instalação do Netbeans.


Expandir
titleInstalação Netbeans 13

Baixar o Netbeans do site oficial a partir da versão 13, extensão exe.


Abrir o executável, clicar em next:

Aceitar os termos > Next:


Clicar em next:

Clicar em Install:

Após a conclusão, clicar em Finish:

Depois de instalado podemos inicializar o mesmo, e caso tenha sido instalado no mesmo servidor que a versão anterior do Netbeans, será questionado se deseja importar as configurações do mesmo, e nesse caso, clicar Não.


Expandir
titleInstalação Payara Server 5.2022.2

Com o Netbeans já instalado, instalar o Payara Server 5.2022.2 (Full), disponível aqui.

Após concluído o download, extrair o conteúdo do arquivo em algum local do sistema, como por exemplo o diretório C:\Users.

Após o conteúdo ser extraído, executar o Netbeans > Tools > Plugins:


Na aba Installed, selecionar os plugins Java SE, Java Web and EE e Base IDE e clicar em Activate > Close:


Clicar em Tools > Servers:

Clicar em Add Server:

Selecionar o Payara Server > Next:

Indicar onde a instalação será realizada, selecionar que aceita os termos de licença e clicar em Download Now:


Configurar e clicar em finish:





Expandir
titleConfiguração Payara

Após finalizada a configuração, na aba Services clicar com o botão direito sobre o Payara Server, clicar em View Domain Admin Console:


Configurations > Server-config > Network Config > Network Listeners > listener-2. Na aba General, marcar Enabled no campo “Security”. Alterar a Port para 443 e clicar em “Save”:


Listener 2 > aba de SSL, selecionar Enabled no campo SSL3, clicar em save:



File > Open Project > selecionar o projeto a ser importado:


Expandir
titleProcesso para atualização de versão

Antes de iniciarmos o processo de atualização do Web Service Tiss, devemos mapear qual será o link atual do serviço.

No exemplo em questão, o link atual do cliente é "TISSSolus40100", salve essa informação, pois será necessária durante a atualização do serviço:

Image Added


(seleção) Nota: Normalmente o link possui o mesmo nome que a pasta a que está referenciado no NetBeans.

Image Added


Para atualizar o serviço do Web Service Tiss para a nova versão deve ser baixado os repositórios junto ao GitHug do Solus:

Localizar o caminho do diretório onde está salvo o projeto atualmente: Propriedade > Sources > Projetct Folder:

Image Added

Criar uma nova pasta para armazenar os repositórios da nova versão baixados do Git:

Image Added

Após o Download dos projetos, salvar os mesmos junto a essa nova pasta criada:

Image Added

Antes de inicializar a nova versão dos projetos, deve ser removido os projetos atuais do NetBeans. Para isso, utilize o botão direito do mouse > Close, deve ser removido os três projetos (CommonModel, CommonClass, TISSSolus40100 ou ws_tiss):

Image Added


Após a exclusão, iremos iniciaremos os novos projetos que foram baixados e salvo na pasta. Para executar esse processo selecione a opção File > Open Projetos:

Image Added


Image Added

Por padrão, o projeto atual do Web Servece Tiss tem a nomenclatura "ws_tiss". No entanto, será importante avaliar como o serviço está atualmente referenciado, pois devemos manter o mesmo nome que o atual.

No exemplo em questão, o link atual do cliente é TISSSolus40100:

Image Added

Desta forma, devemos renomear a pasta baixada do GitHug de ws_tiss para "TISSSolus40100":

Image Added


Image Added

(seleção) "Nota: Informamos previamente aos clientes que o padrão a ser adotado será "ws_tiss". No entanto, para evitar impactos, manteremos o nome atual até que a comunicação sobre a mudança na nomenclatura dos serviços seja realizada junto aos prestadores."


Executar o processo de build de um projeto no NetBeans:

  • Ao abrir o "NetBeans" do cliente, selecione a opção "File".

Image Added


Após isso, selecione a opção para abrir um projeto:

Image Added


Abra os três pacotes listados abaixo. Se não estiver visualizando-os, clone-os para o seu repositório no GitHub:

Image Added


(seleção) Lembrando que mudamos o nome da pasta ws_tiss para TISSSolus40100, pois esse era o padrão atual do cliente.

Após a subida dos pacotes, execute a limpeza no botão "Clean and Build" de cada uma das duas classes, "CommonClass" e "CommonModel", vinculadas ao seu "NetBeans":

Image Added


Então aguarde até que a mensagem de sucesso seja exibida "BUILD SUCCESS":Image Added


Após o Build das classes, no deploy do projeto realize o mesmo processo, porém com as dependências "Build with Dependencies":Image Added


Aguarde até que a mensagem de sucesso seja exibida "BUILD SUCCESS":

Image Added


Após a inserção bem-sucedida do projeto, selecione a opção "Run". O "NetBeans" então realizará o deployment do projeto "TISSolus40100" no servidor Payara:

Image Added


Uma mensagem de saída será exibida novamente, notificando que um arquivo.war foi adicionado à pasta designada:

Image Added


Em seguida, o NetBeans abrirá uma nova aba em seu navegador, exibindo uma mensagem que indica que o projeto está em execução. Nesse estágio, ele está devidamente configurado na base da operadora:

Image Added



Aviso
titleAtenção

Documentação elaborada com base na versão vigente do sistema.



Editado por: B. S. 

Revisão textual: V. F.,