Web Services Overview Consuming External Web Service Producing ABL Web Service State Free Web Service for State Aware App Stock Distribution Application Demo
Web Services Overview Consuming External Web Service Producing ABL Web Service State Free Web Service for State Aware App Stock Distribution Application Demo
A Web Service is a software system identified by a URI, whose public interfaces and bindings are defined and described by XML. Its definition can be discovered by other software systems. These systems may then interact with the Web Service in a manner prescribed by its definition, using XML based messages conveyed by internet protocols
Web Services ArchitectureW3C Working Draft 14 November 2002http://www.w3.org/TR/ws-arch/
An application that can be accessed over the Web or any network from another application using RPC style calls encoded using SOAP over HTTP where the interface is described using WSDL
Ken Wilner, Fellow PSC
Reality today
Web Services◦ A set of standards that comprise a platform for
building distributed, interoperable applications OpenEdge Web Services utilizes W3C
standards◦ WSDL 1.1 (W3C Note – de facto standard)◦ SOAP 1.1 HTTP Binding◦ 2001 XML Schema
W3C = World Wide Web Consortium, http://www.w3.org/
A lightweight xml-based protocol for message exchange
Supports message typing, strong typing, and structured data
Can be used in a variety of communication paradigms
Programming language and platform independent Highly extensible
◦ Transport independent◦ Encoding independent◦ Extra context via headers
Simple Object Access Protocol
Specifies interface, and network address◦ Service interface maps to business interface◦ Business methods (operations) that can be invoked ◦ Message structure for each method
Data fields, types◦ Bindings for the operations
SOAP over HTTP Generation approaches
◦ WSDL generated from business interface◦ Business interface generated from WSDL
Web Service Description Language
Web Services Overview Consuming External Web Service Producing ABL Web Service State Free Web Service for State Aware App Stock Distribution Application Demo
Obtain contract from Web service provider◦ i.e. WSDL and any documentation
Run the WSDL Analyzer over WSDL◦ Generates HTML information including ABL code
snippet examples Use WSDL Analyzer information to code
calls to Web service Call the Web service
Input WSDL (obtained from service provider)
Output HTML documentation ◦ ABL code snippets and examples◦ SOAP/XML samples◦ Textual information about service
proenv>bprowsdldoc C:\temp\MyService.wsdl orproenv>bprowsdldoc http://server/wsa/....
Initial connection is made◦ WSDL obtained◦ Client holds local port◦ Physical connection only when calling an
operation
CREATE SERVER hWebService.hWebService:CONNECT("-WSDL 'http://localhost:8080/wsa/wsa1/wsdl?targetURI=urn:wsProvider:Emp'").
DEFINE VARIABLE hWebService AS HANDLE.DEFINE VARIABLE hPortType AS HANDLE.
CREATE SERVER hWebService.
hWebService:CONNECT( wsdl url ).
RUN portTypeName SET hPortType ON SERVER hWebService.
RUN operationName(…) in hPortType.
DELETE PROCEDURE hPortType.hWebService:DISCONNECT().DELETE OBJECT hWebService.
FUNCTION DynDeptEmp RETURNS CHARACTER (INPUT pcDeptName AS CHARACTER, OUTPUT TABLE-HANDLE hDeptEmp) IN hPortType.
result = DynDeptEmp(pcDeptName, TABLE-HANDLE hDeptEmp).
RUN DynDeptEmp IN hPortType (INPUT pcDeptName, OUTPUT result, OUTPUT TABLE-HANDLE hDeptEmp).
RUN operationName IN hPortType (INPUT value1, OUTPUT value2) NO-ERROR.
IF ERROR-STATUS:ERROR THEN DO: DO iCnt = 1 TO ERROR-STATUS:NUM-MESSAGES: MESSAGE ERROR-STATUS:GET-MESSAGE(iCnt) VIEW-AS ALERT-BOX. END.
IF VALID-HANDLE(ERROR-STATUS:ERROR-OBJECT-DETAIL) THEN DO: MESSAGE "Fault Code:" ERROR-STATUS:ERROR-OBJECT-DETAIL:SOAP-FAULT-CODE SKIP "Fault Actor:" ERROR-STATUS:ERROR-OBJECT-DETAIL:SOAP-FAULT-ACTOR SKIP "Fault String:" ERROR-STATUS:ERROR-OBJECT-DETAIL:SOAP-FAULT-STRING
VIEW-AS ALERT-BOX.
IF VALID-HANDLE(ERROR-STATUS:ERROR-OBJECT-DETAIL:SOAP-FAULT-DETAIL) THEN MESSAGE "Fault Detail:" ERROR-STATUS:ERROR-OBJECT-DETAIL:SOAP-FAULT-DETAIL:GET-SERIALIZED()
VIEW-AS ALERT-BOX. END. END.
bprowsdldoc ABL example SOAP Faults
Web Services Overview Consuming External Web Service Producing ABL Web Service State Free Web Service for State Aware App Stock Distribution Application Demo
DevelopAppServerapplication
Design Web service
Generate Web service
definition
Dev
elop
DevelopAppServerapplication
Design Web service Install/
Configure the WSA
Deploy Web service
to WSA
Configure and Enable Web
service
Generate Web service
definition
Dev
elop
Dep
loy/
Adm
in
DevelopAppServerapplication
Design Web service Install/
Configure the WSA
Deploy Web service
to WSA
Configure and Enable Web
service
DevelopTest Client Application
Re-configure Web Service
Generate Web service
definition
Dev
elop
Dep
loy/
Adm
in
Adm
in
Tomcat WSA State Free Application Server Simple Login Web Service Generate service definition (WSM) Deploy and enable Web Service Test Web Service
Web Services Overview Consuming External Web Service Producing ABL Web Service State Free Web Service for State Aware App Stock Distribution Application Demo
State Aware Application: Start session Connect DB to session Identify user Instantiate Session State
◦ Start support procedures◦ Set session variables◦ etc
User remains connected
State Free Web Service State Free Web Service for State Aware for State Aware ApplicationApplication
Time consuming expensive operations
State Free Web Service: Start State Free agents when broker starts Connect DB to App Server at startup Start support procedures Identify user as separate Web Service call
◦ Issue Session ID and save in DB◦ Save as much session state as needed with the Session ID
For each subsequent API, re-instantiate session state based on Session ID
Web Services Overview Consuming External Web Service Producing ABL Web Service State Free Web Service for State Aware App Stock Distribution Application Demo
Web Services Produced Product Catalogue Purchase Orders PO Receipting Sales Orders Sales Order Dispatched Stock Adjustment
Web Services Consumed PO Received Delivery Notification Dispatch Notification PO Receipt Notification
UNIBIS is a Financial, Distribution, Service and Manufacturing application developed over 15 years with Progress Technology, and supported by a small dynamic team out of the ComOps Melbourne Office.
Our objectives are to provide solutions that allow our customers to capture data without traditional data entry. Volume and efficiency through data collaboration.
Web Services are part of the strategy of using the UNIBIS ERP as a data repository . Specific processing that can easily sit on top of what are standard ERP business outcomes.
Web Service Login to retrieve session ID Using Excel to call ABL Web Service
Robin Smith