Maximo Generic

Maximo Generic connector communicates with Maximo Web Services.

Configuration

The first step is Connector Configuration in Flow Studio (see picture below):

Communication with Web Services is always over the HTTP protocol.

The following parameters are configurable in the configuration:

• Maximo Web Service Address: The Maximo server name which hosts web services

• User name: The user name (credential) used in authentication. Note that if Maximo does not accept non-ASCII characters in the user names, you might need to add two parameters to the Java Virtual Machine generic arguments for WebSphere Portal. Example arguments which adds UTF-8 encoding support: "-Dfile.encoding=UTF-8 and -Dclient.encoding.override=UTF-8".

• Password: The password (credential) used in authentication. Note that if Maximo does not accept non-ASCII characters in the passwords, you might need to add two parameters to the Java Virtual Machine generic arguments for WebSphere Portal. Example arguments which adds UTF-8 encoding support: "-Dfile.encoding=UTF-8 and -Dclient.encoding.override=UTF-8".

• Authentication type: It decides how credentials are used when the web service is called. The connector uses an HTTP client to communicate with Maximo Web Services, but credentials can be used in two modes:

  • Basic: The credentials are sent in the Authentication header in plain text.

  • Base64: The credentials are encoded with Base64 digits and put into the HTTP request header.

• Soap version: The connector can communicate with web services in two SOAP versions: SOAP1.1 and SOAP 2.2

Get started

When the connector is configured we can use it in machine steps. We have to do the following steps:

1. Reload Maximo Web Services

Connector reads WSDL from Maximo Main Web Services from MaximoWebServiceAddress (configuration):

for example: http://{MaximoWebServiceAddress}/meaweb/wsdl/MXWSREGISTRY.wsdl

After that, it creates the web service client and calls Maximo Main Web Services.

Response from Maximo Main Web Service contains a list of all available Maximo Web Services.

1. Choose a specific Maximo Web Service

When a specific web service is chosen the connector reads the WSDL for the SelectedWebService from MaximoWebServiceAddress (configuration):

for example: http://{MaximoWebServiceAddress}/meaweb/wsdl/{SelectedWebService}.wsdl

After that, it creates a SOAP client and calls the selected Maximo Web Service.

Response from Selected Maximo Web Service contains a list of all available methods and their parameters.

1. Choose Method and fill method parameters

When a specific web service method is chosen, the connector reads all input parameters from the method definition and displays it:

When all required parameters are set we can use the connector (by running workflow or directly from Flow Studio to test it).

When Connector is executed it uses an HTTP client (created in point 2), executes the method, and reads the response data.