Understanding Web Service Adapters
The following topics describe the system functionality in more detail.
Importing a WSDL
Configuring a Web Service Adapter starts by identifying the WSDL (the web service description language document used to define the interface) that will be provided by the external system. The following steps describe the base product functionality provided to allow a user to import a WSDL.
• Navigate to the Web Service Adapter page in add mode and select the appropriate base business object.
• Enter a meaningful Web Service Name and appropriate descriptions.
• Provide the URL of the given WSDL.
• Click Import to retrieve the details of the WSDL. The system then parses the WSDL details and populates the WSDL Service Name, WSDL Source, WSDL Port, URL and a list of Operations (methods) defined in the WSDL.
• Determine which Operations should be active based on the business requirements for invoking this web service. Active operations are those that the implementation is planning to invoke from the system. These require appropriate request and response data areas generated for them. The following section provides more information about that.
• Specify the appropriate Security Type to configure the type of security to use when invoking this web service.
• Click Save.
At this point, a web service adapter record is created in pending status. The next step is to generate the request and response data areas for the operations configured as active.
Generating Request and Response Data Areas
Each active operation for the web service adapter requires a pair of data areas, request and response, that represent the request and response XML messages for the operation.
The base product provides steps to generate the data areas as follows:
• As described in the Importing a WSDL section above, the operations listed in the WSDL are generated for the web service adapter and the implementer should indicate which operation to activate.
• After saving the pending web service adapter, the display lists all the active operations and for each one includes a Generate button.
• After clicking Generate for an operation, a window appears where the names of the new Request and Response Data Areas may be defined. Click Save to generate the data areas.
The generated data areas provide the API for the implementer to use when implementing the web service call in an appropriate algorithm or service in the system. The data areas contain the appropriate mapping from the elements that the implementer works within the code that invokes the web services and the WSDL definitions.
To facilitate generating the request and response data areas, the base product invokes a special business service used to create the appropriate mapping. The business service is defined as a BO option on the Web Service Adapter business object. This allows an implementation to provide a custom business service to further enhance the request and response mapping where appropriate.
Note:
Generated data areas. It is possible to edit and modify the generated data areas after they are created. An implementer can change element names or remove unneeded elements if desired. Manually changing the generated data areas must be done only when absolutely necessary. This is because the system is not able to validate manual changes and issues with the data areas would only be detected at run time.
Activating Web Service Adapters
The business objects provided by the base package for web service adapters include a simple lifecycle of Pending and Active. Configure the web service adapter and its data areas while in Pending status and activate it when it is ready to be implemented in the appropriate system functionality.
Invoking Web Services
To make a call to a web service using a web service adapter, the system has provided a Web Service Dispatcher business service (F1-InvokeWebService) to submit a web service call. The calling program is responsible for retrieving all the information to correctly populate the request data required by the web service call before invoking the business service.
Note:
Refer to the detailed description of the business service for more information.
Limitations
The following points highlight limitations associated with the types of web services that the system supports:
• It is possible for one WSDL document to contain definitions for several web services. The system currently supports only one port or service per WSDL document.
• It is possible for a WSDL to support multiple message patterns. The system currently supports only request / response.
Parent topic