Accessing the Producer WSDL
As a Producer you need to provide the URL for the Producer WSDL document to the Consumer. The basic WSDL document is available under the following URL: http://producer_portal_host:producer_port/WpsContextRoot/wsdl/wsrp_service.wsdl , where WpsContextRoot is the portal context root set at installation time. You can find its value in the file wkplc.properties.
This URL refers to a WSDL file with both the WSRP 1.0 and WSRP 2.0 SOAP ports. When a Consumer portal administrator configures the Consumer portal to interact with the Producer, the Consumer administrator must specify the WSDL URL. The Consumer accesses this URL and reads the contents of the WSDL document, which provides the SOAP URLs to the WSRP 1.0 and WSRP 2.0 SOAP ports. Consumers use these SOAP URLs to communicate with the Producer through the WSRP protocol.
protocol://host_name:port_number/wsrp_context_root/wsrp_port_name
wsrp_context_root references
the context root for the WSRP Producer facade servlet. The facade
servlet is provided with the wps.ear enterprise application in the WebSphere
Portal Server WSRP Facade web module (wps_facade.war) and
controls access to the WSRP Web Service engine.You can change the context root for the WSRP Producer with the modify-servlet-path configuration task, as described in Changing the portal URI
- The WSRP version: WSRP Version 1.0, WSRP Version 2.0, or both
- The host name for the SOAP URLs
- The transfer protocol: HTTP, HTTPS, or both
- The port number for HTTP URLs
- The port number for HTTPS URLs.
- URL parameters
- Settings in the portal Config Service
- Values from the incoming request.
- If you add parameters as URL parameters to the service WSDL URL, then the Producer portal uses these parameters for the SOAP URLs of the WSDL file.
- If you do not define a parameter as URL parameter, then the Producer looks for entries in the portal Config Service.
- If you did not specify the parameter in the Config Service, then the Producer uses the host name and port of the incoming request to generate the SOAP URLs in the WSDL file.
URL parameters
http://producer_portal_host:producer_port/wp_contextRoot/wsdl/wsrp_service.wsdl
?protocol=<protocolValue>&port=<httpPort>&securePort=<httpsPort>
&version=<WSRPVersion>&hostname=<hostname>
The following table lists possible values for URL parameters:URL parameter | Possible values | Results in WSDL file |
---|---|---|
protocol | http | WSRP SOAP port URLs with HTTP protocol |
https | WSRP SOAP port URLs with HTTPs protocol | |
mixed | WSRP SOAP port URLs with HTTP and with HTTPs protocol | |
version | v1 | WSRP SOAP ports for WSRP Version 1.0 |
v2 | WSRP SOAP ports for WSRP Version 2.0 | |
mixed | WSRP SOAP ports for WSRP Version 1.0 and Version 2.0 | |
port | Integer, for example 80 | Port number for HTTP SOAP port URLs |
portSecure | Integer, for example 443 | Port number for HTTPs SOAP port URLs |
hostname | Name of the host, for example localhost | Hostname used for SOAP port URLs |
Settings in the portal Config Service
- wsrp.hostname = localhost
- Use this property to specify a host name for the SOAP URLs in the WSRP service WSDL file of the Producer.
- wsrp.port.http = 80
- Use this property to specify the HTTP port that is used for the SOAP URLs in the WSRP service WSDL file of the Producer.
- wsrp.port.https = 443
- Use this property to specify the HTTPS port that is used for the SOAP URLs in the WSRP service WSDL file of the producer.