Web service handler (JAX-WS)

The WEBSERVICE-JAX-WS handler is a Java client that can invoke any document-literal web service that is WS-I BP 1.1 compliant. The outbound integration message forms the payload (SOAP body) and the handler provides the SOAP headers and envelope.

This web service handler supports the implementation of web services for Maximo® Asset Management 7.6 and later. If you are implementing new web services, configure them to use this web service handler.

MEP property

This optional property specifies the message exchange pattern for the web service. The property supports the following values. If you do not provide a value, the default sendreceive value is used.

Value Web Service Operation Type
sendreceive Request and response
sendrobust Request with void or fault response
fireandforget Request only, no response, or fault

ENABLEAPPCONTEXT property

Set this property to 1 (true) when implementing support for WS-* policies.

ENDPOINTURL property

This required property specifies a valid web service URL on which to invoke a web service. You can use the WSEXIT class to override the value specified via the user interface just before the web service is invoked.

SERVICENAME property

This required property specifies the name of the target web service that the handler invokes.

SOAPACTION property

This optional property specifies the value of the SOAPAction HTTP header to be used when invoking the web service. The default value is an empty string. To set a value for the property, view the WSDL file for a web service to determine the action and specify this value. You can use the WSEXIT class to override the value specified in the user interface before you invoke the web service.

SOAPVERSION property

This optional property specifies the version of the SOAP specification used during web service call. Valid values are SOAP11 and SOAP12.

HTTPCONNTIMEOUT property

This optional property specifies the connection timeout value in milliseconds. The default value for this property is 60000 milliseconds.

HTTPREADTIMEOUT property

This optional property specifies the read timeout value in milliseconds. The default value for this property is 60000 milliseconds.

HTTPHEADER property

This optional property can add a comma-separated list of names and values to the header section of HTTP messages. The list includes name and value information in the format of Headername1:Headervalue1, Headername2:Headervalue2. If no value is provided in the property, custom code can inject the values into the transaction context during invocation channel processing.

USERNAME and PASSWORD properties

If the specified web service is secured (if HTTP basic authentication is enabled), specify a user name and password.

WSEXIT property

Tip: You also can configure SOAP endpoint exits by using automation scripts.

This optional property is used for customization. It specifies the fully qualified name of a custom Java class that implements the psdi.iface.router.WSExit interface. The property defines the following methods:

The responseOk() method is called after a successful invocation of the external web service.

public void responseError(Exception e) throws MXException

If an error occurs when the web service is called, the responseError() method is called with the originating exception as a parameter.

The default implementation of the WSExit interface is psdi.iface.router.DefaultWSExit.

CFGXMLPATH property

This property is obsolete. Do not use it.