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

URL format: 

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 Change the portal URI

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

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 you specify:

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

  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

You 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, you set the following parameters in the portal configuration service:
wsrp.hostname = localhost


wsrp.port.http = 80


wsrp.port.https = 443


Parent

Use the portal as a WSRP Producer


Next topic

Prepare security for a WSRP Producer portal


Related tasks


Change the portal URI

 


+

Search Tips   |   Advanced Search