How to access the Producer WSDL | HCL Digital Experience
As a Producer you must provide the URL for the Producer WSDL service description document to the Consumer.
http://producer_portal_host:producer_port/WpsContextRoot/wsdl/wsrp_service.wsdl
where
WpsContextRoot
is the portal context root that
was set at installation time. You can find its value in the file wkplc.properties
. This URL refers to a WSDL file with the WSRP 2.0 services. 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 endpoint addresses of the WSRP 2.0 services. Consumers use these endpoint addresses 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 HCL 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 endpoint addresses
- The transfer protocol: HTTP, HTTPS, or both
- The port number for HTTP URLs
- The port number for HTTPS URLs.
- Parameters from the URL of the request for the service description document
- Settings in the portal Configuration Service
- Settings that result from the request for the service description document.
- If the administrator of the Consumer portal adds parameters as URL parameters to the URL for requesting the service description document, then the Producer portal uses these parameters. For example, it can use the parameters for creating the endpoint addresses of the WSRP web services that are contained in the WSDL document.
- If you do not define such a parameter as a URL parameter in the service description document request, then the Producer looks for entries in the portal Configuration Service.
- If you do not specify the parameter in the Configuration Service, then the Producer uses the host name and port of the incoming request to generate the endpoint addresses of the WSRP web services that are contained in the WSDL document.
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 endpoint addresses with HTTP protocol |
https | WSRP endpoint addresses with HTTPs protocol | |
mixed | WSRP endpoint addresses with HTTP and with HTTPs protocol | |
version | v1 | WSRP services for WSRP Version 1.0 |
v2 | WSRP services for WSRP Version 2.0 | |
port | Integer, for example 80 | Port number for HTTP endpoint addresses |
portSecure | Integer, for example 443 | Port number for HTTPs endpoint addresses |
hostname | Name of the host, for example localhost | The host name that is used for endpoint addresses |
Settings in the portal Config Service
- wsrp.hostname = localhost
- Use this property to specify a host name for the endpoint addresses in the WSRP service WSDL document of the Producer.
- wsrp.port.http = 80
- Use this property to specify the HTTP port that is used for the endpoint addresses in the WSRP service WSDL document of the Producer.
- wsrp.port.https = 443
- Use this property to specify the HTTPS port that is used for the endpoint addresses in the WSRP service WSDL document of the Producer.