WebServices com Tecnologia Protheus

TDI - Desenvolvimento

WebServices com Tecnologia Protheus

NDICE
Introduo Tecnologia Estrutura de um WebService Gerao de Client Protheus Configurao

WebServices com Tecnologia Protheus

Introduo
Afinal, o que um WebService?
Meio pelo qual diferentes aplicaes podem interagir, independente da linguagem que foram escritas ou arquitetura que se encontram Um objeto, que contm mtodos e assinaturas

Sistema X

Quando devo usar ou criar um WS?

Quando existe a necessidade ou se deseja comunicar dois sistemas em tempo real Quando existe a necessidade ou se deseja disponibilizar um recurso para aplicaes de diferentes tipos ou plataformas

WebService

Quando NO devo usar ou criar um WS?

Quando no existe um ambiente propcio para o suporte e disponibilidade do servio Quando o volume de processamento por transao for muito grande Quando o recurso for criado para uso exclusivo de uma nica aplicao

Sistema Y

WebServices com Tecnologia Protheus

Introduo
Exemplos de uso de um WS: Consulta de CEP

WebServices com Tecnologia Protheus

Introduo
Exemplos de uso de um WS: Integrao entre aplicaes de diferentes tipos

WebServices com Tecnologia Protheus

Tecnologia
SOAP - Simple Object Access Protocol Protocolo para troca de informaes estruturadas As mensagens so documentos XML / especificao da W3C Envelope de mensagens, regras de codificao SOAP depende de transporte subjacente para enviar e receber mensagens (normalmente HTTP), forma mais simples e eficiente de comunicao em um ambiente B2B

WebServices com Tecnologia Protheus

Tecnologia

WSDL - Web Service Description Language WSDL descreve a interface de um webService usando um padro XML especifica como acess-lo e quais as operaes ou mtodos disponveis informaes de vinculo e localizao da publicao do webService Permite com que as empresas publiquem suas interfaces de servios de uma forma padronizada

WebServices com Tecnologia Protheus

Estrutura de um WebService
De forma simplificada, um WebService pode conter:
Atributos simples Estruturas de dados Mtodos

Isso o que compe a assinatura WSDL de um WebService!

WebServices com Tecnologia Protheus

Estrutura de um WebService / Cdigo
Mtodo

Estrutura

Atributo

WebServices com Tecnologia Protheus

Gerando um Client

10

WebServices com Tecnologia Protheus

Gerando um Client
Porque gerar?

Quando gerar?
Como gerar:
No Development Studio, abrir um novo fonte em branco Acessar o menu Ferramentas/Gerar cliente WebServices... Colar a URL do WSDL fornecido

Salvar o fonte, adicionar ao grupo de projetos e compilar no ambiente desejado

11

WebServices com Tecnologia Protheus

Testando um WebService

12

WebServices com Tecnologia Protheus

Configurao
Parar o servio do Protheus Server. Substituir o arquivo totvsappserver.ini da pasta \bin\appserver pelo contido

na pasta \bin\backup\
Iniciar novamente o Server Pelo TotvsSmartClient, rodar o srvwizard

13

WebServices com Tecnologia Protheus

Configurao
Marcar o item Mdulos Web e clicar no boto Novo mdulo

14

WebServices com Tecnologia Protheus

Configurao
Preencher conforme abaixo

15

WebServices com Tecnologia Protheus

Configurao
Caso esta caixa aparea, responder Sim

16

WebServices com Tecnologia Protheus

Configurao
Preencher conforme abaixo e clicar em Relacionar

17

WebServices com Tecnologia Protheus

Configurao
Preencher conforme abaixo e clicar em Finalizar

18

WebServices com Tecnologia Protheus

Configurao
Ateno: a porta usada na seo HTTP deve ser a mesma configurada no servio (no nosso caso, 8084). Se estiver diferente, altere!

19

WebServices com Tecnologia Protheus

Configurao
PRONTO! Agora s reiniciar o Server e testar pelo browser, colocando o host definido: http://172.16.93.173:8084/ws Se aparecer a lista de servios, porque funcionou!!!

(e se no aparecer, porque a configurao foi mal-sucedida, ento basta voltar ao Wizard e rever o processo)!!!

20

WebServices com Tecnologia Protheus

Configurao
Olhando o totvsappserver.ini, note isso:

21

WebServices com Tecnologia Protheus

Referncias para Pesquisa

http://www.w3.org/TR/ws-arch/ http://www.webservices.org/

http://www.w3schools.com/webservices/default.asp

22