Utilize qualquer Web Service a partir do Progress 4GL Luis B. Campos System Engineer.

Utilize qualquer Web Service a partir do Progress 4GL

Luis B. CamposSystem Engineer

2 Chame Qualquer Web Service a partir do Progress 4GL© 2005 Progress Software Corporation

Introdução Web Service Basics WSDL Analyzer Chamando um Web Service a partir do 4GL

Agenda


Web Service Client

Disponível no OpenEdge® 10.0A AppServer não é necessário Client de uma aplicação diferente


Web Services – Por que?

Conectividade heterogênea Na arquitetura SOA eles tornam os

serviços distribuídos possíveis Denominador comun menor que o EDI ou

CORBA


Web Services – Por que?

Provedores de Web service disponíveis– Produtos: OpenEdge, Oracle, IBM DB/2,

SalesForce.com, etc.

– Serviços: Google, e-Bay, Commonwealth of Massachusetts, etc.

Plataformas de Desenvolvimento: OpenEdge, .NET™, J2EE, Apache, WebSphere.


Web Services – Por que não?

Pode não ser eficiente Pode não estar disponível


Web Service Basics - Onde?

Usuários Usuários

Camada de Apresentação

Camadas de Serviços de Negócio

Camadas de Acesso a Dados

Fontes de Dados Gerenciadas

Fontes de Dados Gerenciadas

Fontes de DadosNão Gerenciadas

Fontes de DadosNão Gerenciadas

Serviços Empresariais

Serviços Empresariais

Camada de Integração

OpenEdge Reference Architecture



Agenda


Web Service Basics – SOAP Message

Envelope

Body

HeaderHeader Entry

…Body Entry

Body Entry

Header Entry

…

Entradas podem ser

SOAP Faults (erros)

Header opcional

Simple

Object

Access

Protocol


Web Service Basics - WSDL

Define Interface Codificação dos dados Transporte Endereço do serviço

Contrato entre o client e o server

Web

Service

Description

Language


Anatomia de uma Sessão Web Service

OpenEdge 4GL Client

Um provedor de Web Service

SOAP Request

SOAP Response

SOAP Request

SOAP Response

WSDL Request

WSDL Response


Introdução Web Service Basics WSDL Analyzer

– Introdução

– Demonstração do Analyzer Chamando um Web Service a partir do 4GL

Agenda


Dicionário 4GL/WSDL

4GL WSDLAppServer™..…......….............Web service

Persistent procedure..............Port type (interface)

Internal procedure..................Operation


Linha de Comando do WSDL Analyzer

Gera a documentação 4GL para um web service

C:\temp> bprowsdldochttp://api.google.com/GoogleSearch.wsdlgoogle

Documentation written tofile:///c:\temp\google\index.html

C:\temp>


Anatomia do Projeto do Client

WSDL Analyzer

Provedor do Web Service

WSDL Request

WSDL Response

Documentos Gerados

OpenEdge 4GL Client


Documentos Gerados

Data types

dados complexos

Operation Index

Port type

conexão & chamada

Service

index


Snapshots do Analyzer:Documentação do Serviço


Snapshots do Analyzer:Documento do Serviço


Snapshots do Analyzer :Port Type – Sumário da Conexão


Snapshots do Analyzer :Port Type – Sumário da Operation


Snapshots do Analyzer :Port Type – Exemplo da Operation


Snapshots do Analyzer :Port Type – Parâmetros da Operation


Snapshots do Analyzer :Port Type – Exemplo de Parâmetros Complexos


Dados Complexos como TEMP-TABLE

addCustomers

Procedure prototypePROCEDURE addCustomers: DEFINE INPUT PARAMETER TABLE FOR customerList. DEFINE OUTPUT PARAMETER TABLE FOR conflictList.END PROCEDURE.



ExemploDEFINE TEMP-TABLE customerList NAMESPACE-URI http://mycompany.com/schemas/customerList NAMESPACE-PREFIX "cust“ FIELD CustNum AS INTEGER FIELD Name AS CHARACTER XML-NODE-TYPE "Attribute“ FIELD Country AS CHARACTER FIELD Comments AS CHARACTER INDEX CustNum IS PRIMARY UNIQUE CustNum INDEX Name Name INDEX Comments IS WORD-INDEX Comments.



ParâmetroscustomerList

This value is defined as a TEMP-TABLE.

This value can also be expressed as a CustomerTable element inThe http://mycompany.com/schemas/customerListnamespace. As such, this parameter can be passed as aCHARACTER or LONGCHAR value containing an XMLdocument. View example of XML.



– Mapeamento de tipos de dados

– Conexão e chamada

– Manipulação do Header

– Manipulação de Erros

Agenda


Simples Mapeamento de Tipo de Dados

XML Schema Data Type Progress 4GL Data Typestring CHARACTER

boolean LOGICAL

decimal DECIMAL

integer INTEGER

float, double, duration CHARACTER

CHARACTER e LONGCHAR podem sempre ser usados

Para mapeamentos completos,veja a documentação


Dados Complexos

Representados de duas formas:

1. LONGCHAR/CHARACTER de documentos XML serializados

2. ProDataSet ou TEMP-TABLE quando possível (10.1A)

Analyzer mostra exemplos de ambos.


CREATE SERVER app-server-handle.app-server-handle:CONNECT(“appserver-connect-parms”).RUN persistent-proc PERSISTENT SET procedure-handle ON app-server-handle.RUN internal-proc IN procedure-handle(parameters).

CREATE SERVER web-svc-handle.web-svc-handle:CONNECT(“-WSDL wsdl-url ws-connect-parms”).RUN port-type-name SET port-type-handle ON web-svc-handle.RUN operation IN port-type-handle(parameters).

Conexão e ChamadaExatamente como um AppServer


Resultados Google no Browser


Exemplo de Conexão Selecionado


Exemplos de Conexão e Chamada Colados


Definições de Variáveis


Connect e Set Port


Chamada ao Google


Resultado da Pesquisa Utilizando DOM


Carga da TEMP-TABLE com os Resultados


Resultados no 4GL Client


Objetos 4GL SOAP HeaderEnvelope

Body

HeaderHeader Entry

…

Body Entry

Header Entry

SOAP-HEADER

SOAP-HEADER-ENTRYREF

…SOAP-HEADER-ENTRYREF


SOAP Headers Define um callback

port-type-handle:SET-CALLBACK-PROCEDURE( “REQUEST-HEADER | RESPONSE-HEADER”, “request-handler-name”, web-service-handle).

Escreve um callbackPROCEDURE request-handler-name: DEFINE INPUT PARAMETER soap-header-handle AS HANDLE. DEFINE INPUT PARAMETER operation-namespace AS CHARACTER. DEFINE INPUT PARAMETER operation-local-name AS CHARACTER.END.


Anatomia de um Erro no Web Service

OpenEdge 4GL Client

Provedor do Web ServiceSOAP Request

SOAP Response

(FAULT)

WSDL Request

WSDL Response


4GL SOAP Fault

Envelope

Body

Body Entry

fault code

fault string

fault actor

<faultdetail>


Fault Objects do 4GL

ERROR-STATUS

SOAP-FAULT

SOAP-FAULT-DETAIL

XML

fault info


SOAP Fault - Faultstring

An error was detected while executing the Web Service request. (10893)


SOAP Fault - Detail

<detail> <errorMessage> msg=The server application returned the error: Invoice not found; targetException=ERROR condition: The Server application has returned an error. (7243) (7211)] </errorMessage> <requestID> 172247e5b58beb30:5bb966:fb4fdb744a:-7fff#9 </requestID></detail>

47 SOA-07: Call Any Web Service from the Progress 4GL© 2005 Progress Software Corporation

Resumo

Chamar um web service é fácil Use o WSDL Analyzer

OpenEdge 4GL Client

Web Service ou

AppServer?


Perguntas?


Obrigado!


Date post:	21-Apr-2015
Category:	Documents
Upload:	internet
View:	165 times
Download:	6 times

Utilize qualquer Web Service a partir do Progress 4GL Luis B. Campos System Engineer.

Documents