WSDL Service
The WSDL service provides technical information about a Web service that includes its description, how to connect to it, and what the service requires and returns.
The following table provides an overview of the WSDL service:
| Category | Description |
|---|---|
| System name | WSDL Service |
| Graphical Process Modeler (GPM) categories | All Services, Internet B2B > SOAP |
| Description | Web Services Description Language (WSDL) is a standard used to provide technical information about a Web service, including its description, how to connect to it, and what the service requires and returns. The WSDL Reader Service leverages this information to automate the connection to the Web service. |
| Business usage | The business value of this service is to make use of Web services easier for a business user. |
| Usage example | You discover a Web service to use (for example, by browsing UDDI directories) and download the WSDL describing it. The WSDL XML document should be checked in to and versioned by the application as a WSDL document object. The business use is at run time: when the business process goes to use the Web service, it queries the checked in WSDL document for connection information. |
| Preconfigured? | Yes |
| Requires third-party files? | None |
| Platform availability | All supported application platforms |
| Related services | This service is designed to be used in conjunction with the business process SendSOAPRequest. The WSDL service is designed to provide the SendSOAPRequest business process with SOAP connection information. |
| Application requirements | A valid WSDL document properly installed in the application. The specified operation exists in the specified WSDL document. |
| Initiates business processes? | No |
| Invocation | Runs as part of a business process |
| Business process context considerations | No |
| Returned status values | Returned status values:
|
| Restrictions | No |
| Persistence level | Full |
| Testing considerations | None |
How the WSDL Service Works
The WSDL service queries WSDL documents that have been checked in to the application for connection information during a business process. Before you can use the WSDL service, you need to check in the WSDL documents that you will use in your business process. WSDL documents can be checked in or created manually using the Deployment > Web Services > WSDL Check In menu option in the application.
Implementing the WSDL Service
To implement the WSDL service, complete
the following process:
- Create a WSDL service configuration.
- Configure the WSDL service.
- Use the WSDL service in a business process.
Configuring the WSDL Service
The following table describes the fields used to configure the WSDL service in the GPM:
| Field | Description |
|---|---|
| Config | Name of the service configuration. |
| Operation | Operation to process. Required. |
| WSDLFile | WSDL filename to read. Optional. Note: Either WSDLFile
or wsdlName must be entered. If both fields are filled in, the wsdlName
entry is used and the wsdlFile entry is ignored.
|
| wsdlName | Name given to the WSDL document when it is checked
in to the application. Note: Either WSDLFile or wsdlName must be entered.
If both fields are filled in, the wsdlName is used and the wsdlFile
is ignored.
|
| wsdlVersion | Version of the WSDL document to use, if more than one exists. Optional. |
Output from Service to Business Process
The following table describes the output from the WSDL service to the business process:
| Parameter Name(BPML Element Value) | Description |
|---|---|
| End Point URL (SOAPRequestURL) | The URL to configure the SOAP outbound client with. Required. |
| SOAP Action (SOAP_ACTION) | The header value SOAP-ACTION. Optional. |
Output from Business Process to Service
The following table describes the output from the business process to the WSDL service:
| Parameter Name(BPML Element Value) | Description |
|---|---|
| WSDL Operation name (operation) | Operation to process. Required. |
| WSDL Filename (wsdlFile) | WSDL filename to read. Optional. Note: Either wsdlFile
or wsdlName must be entered. If both fields are filled in, the wsdlName
entry is used and the wsdlFile entry is ignored.
|
| WSDL Object Name (wsdlName) | Name given to the WSDL document when it is checked
in to the application. Note: Either wsdlFile or wsdlName must be entered.
If both fields are filled in, the wsdlName is used and the wsdlFile
is ignored.
|
| WSDL Version (wsdlVersion) | Version of the WSDL document to use, if more than one exists. Optional. |