In these exercises, you will build a solution that allows a business application to call a web service operation and receive results from it without having to concern itself with any of the web service protocols and standards. The technical details have been taken care of by the LANSA Integrator SOAP Agent service and by the code generated by the SOAP Wizard.
There are three exercises in this set which together, demonstrate how to implement a SOAP web service using LANSA Integrator Studio. These exercises need to be completed in sequence.
The exercises create a web service called GetEmployees.
The SOAP Agent, or client, consuming the GetEmployees web service will pass a department and section to the server.
A list of employees for that department and section will be returned by the publisher, the SOAP Server, as an array.
If only a department is passed, a list of employees in all sections for that department will be returned.
If no department and section is provided, then all employees for the company will be returned.
The following summarizes the steps you will follow in the three exercises to build and test your SOAP Service:
INT009A – SOAP Service – Define Server
A form accepts department and section code and runs the IIIEMPLOYEEAGENT service on the server
Sets IIIEMPLOYEEAGENT operation to GETEMPLOYEES
Sets parameters to program variables
CALLs the service
Web Server invokes JSMDIRECT which runs the function implementing IIIEMPLOYEESERVER
Form receives employees list and populates list view to display results.
Define SOAP Server Types – the variables to be handled by this service
Create a SOAP Server solution using the SOAP Server Wizard.
Map parameters to program variables
Build the solution, creates WSDL and jar file for iiiEmployeeServer.
The WSDL defines the GetEmployees SOAP service
Use the generated RDMLX to create function which supports the iiiEmployeeServer service and add your business logic
Register the function as a JSMDIRECT service.
INT009B – SOAP Service – Define Agent
Create a new solution using the SOAP Agent Wizard
Define the SOAP Agent iiiEmployeeAgent based on the WSDL created in INT009A
Map parameters to program variables
Build the solution creates a jar file, properties file and sample RDMLX
Create the form iiiFRM04 based on the generated RDMLX and add your business logic.
INT009C – SOAP Service – Test
The form accepts department and section code and runs the IIIEMPLOYEEAGENT service on the server
Sets IIIEMPLOYEEAGENT operation to GETEMPLOYEES
Sets parameters to program variables
CALLs the service
Web Server invokes JSMDIRECT which runs the function implementing IIIEMPLOYEESERVER
Form receives employees list and populates list view to display results.
To achieve this objective you must perform these steps in this sequence: