Especificação | |||
Produto | Datasul | Módulo | Embarques |
Segmento Executor | Manufatura | ||
Projeto1 | D_MAN_DIS001 | IRM1 | PCREQ-5105 - Integração com Neolog |
Requisito1 | PCREQ-5534 - Camada de Conexão | Subtarefa1 |
|
Chamado2 |
| ||
Release de Entrega Planejada | 12.1.7 | Réplica |
|
País | ( X ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________. | ||
Outros | <Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>. | ||
Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos).
O objetivo desta especificação é definir a implementação da camada de conexão do produto Neolog com o Datasul, a integração será direta, onde o Neolog irá chamar API´s do Datasul para notificar alterações que precisam ser efetivadas no ERP.
O Neolog ser comunica com o ERP via WebService SOAP, portando a implementação deverá ser feita utilizando JAVA e usando a API JAX-WS para implementar os webservices, este webservies se comunicam com o AppServer do progress via DATASUL-REST onde a API eqapi200 deverá ser liberada para executar os processos de atualização que serão contruidos em outro requisito do projeto.
A construção deverá implementar WebServices SOAP em Java usando a API JAX-WS, esses webservices deverão ser disponibilizados no WAR atual do Datasul onde estão os outros WebServices (datasul-webservices-11.5.X-SNAPSHOT.war) que fica no JBOSS, o arquivo web.xml do WAR deverá ser atualizado para considerar os novos webservices implementados.
Os webservices deverão ser implementados conforme os arquivos WSDL que foram enviados pelos analistas da Neolog:
| WSDL | WebService | Classe do serviço |
|---|---|---|
| publishCancelService.wsdl | PublishCancelServiceRequest | neolog.cockpit.tripcancelrequestservice.PublishCancelServiceRequestService |
| publishReleasedTripService.wsdl | PublishReleasedTripRequest | neolog.cockpit.tripreleaserequestpublishingservice.PublishReleasedTripRequestService |
| publishReprogrammingService.wsdl | PublishReprogrammingServiceRequest | neolog.cockpit.tripreprogrammingrequestservice.PublishReprogrammingServiceRequestService |
As URL´s para cada um dos webservices no Datasul deverão ser:
| WebService | URL |
|---|---|
| PublishCancelServiceRequest | http://server:port/WebService/publishCancelServiceRequest?wsdl |
| PublishReleasedTripRequest | http://server:port/WebService/publishReleasedTripRequest?wsdl |
| PublishReprogrammingServiceRequest | http://server:port/WebService/publishReprogrammingServiceRequest?wsdl |
Deve-se utilizar a ferramenta wsimport do JDK para gerar os fontes das interfaces, tipos e metodos do WebService, o wsimport gera os fontes para um client SOAP, mas precisamos do server, então a classe consumidora pode ser descartada, e deve ser implementado um webservice usando a API JAX-WS para implementar a interface gerada.
A implementaçao do webservice deverá chamar a API no progress EQP/EQAPI200 que ficará disponível no AppServer, para chamar o AppServer, deve ser utilizado o serviço DATASUL-REST, para isso deverá ser utilizado a API do Jersey para chamar o datasul-rest, onde a api deverá ser disponibilizada.
O Jersey chama o datasul-rest utilizando JSON, então o webservice, deverá traduzir os dados da chamada ao webservice para objetos JSON, que serão enviados para o datasul-rest, que então irá chamar a API progress com os dados corretos.
Como a estrutura de dados do webservice é complexa, a api eqapi200 deverá utilziar os recursos do DATASET para conseguir conversar corretamente com o webservice.
Exemplo de Aplicação:
Tabelas Utilizadas
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
|---|
