Access the Producer WSDL

As a Producer 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. We can find its value in 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.

URL format:

protocol://host_name:port_number/wsrp_context_root/wsrp_port_name

...where wsrp_context_root is the context root for the WSRP Producer facade servlet, provided with wps.ear in wps_facade.war, which controls access to the WSRP Web Service engine.

We can change context root for the WSRP Producer with the modify-servlet-path configuration task.

In addition, we can configure and override various settings to manipulate the contents of the WSDL file by specifying the appropriate parameters:

• 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.

To generate the service WSDL file in the Producer portal , the portal WSRP implementation uses the parameters in the following sequence:

1. URL parameters

2. Settings in the portal Config Service

3. Values from the incoming request.

This means that the portal provides a fallback mechanism for the parameters in the Producer WSDL file, depending on which parameters we specify:

1. If we 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.

2. If you do not define a parameter as URL parameter, then the Producer looks for entries in the portal Config Service.

3. 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

We can add the following URL parameters to the URL of the basic WSDL document in order to change the SOAP port URLs in the Producer WSDL file. Here is an example of a URL with all possible 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

The URL parameters do not modify the Producer settings and bindings, they only manipulate the WSDL output for debugging and tracing purposes

Settings in the portal Config Service

To control the default output for the WSDL document, set the following parameters in the portal configuration service:

wsrp.hostname = localhost

Specify a host name for the SOAP URLs in the WSRP service WSDL file of the Producer.

wsrp.port.http = 80

HTTP port used for the SOAP URLs in the WSRP service WSDL file of the Producer.

wsrp.port.https = 443

HTTPS port used for the SOAP URLs in the WSRP service WSDL file of the producer.

Parent: Use the portal as a WSRP Producer
Next: Prepare security for a WSRP Producer portal
Related:
Change the portal URI