IBM Support

Configuring automatic refresh of work orders for IBM Maximo Assist

How To


Summary

After IBM Maximo Assist 8.1.0 is deployed and activated in IBM Maximo Application Suite, as the application administrator, you must configure automatic refresh of work orders. By configuring automatic refresh, the latest work order details are automatically available from Maximo Assist. Application users do not need to manually upload the latest work order details into the application.

Steps

To configure automatic refresh, you configure Maximo integration framework components. The Maximo integration framework supports asynchronous message processing by using Apache Kafka or JMS queues. Topics from Apache Kafka use a data store for outbound publish or notification channel messages and for inbound enterprise service messages. The processing model for Kafka queues and JMS queues is similar. Both options support sequential and continuous message processing. 
Complete the following steps in the Maximo server for Maximo Assist. 
  1. Add a template to the MXAPIWODETAIL object structure.
    1. In the Object Structures application, open the MXIAPIWODETAIL object structure. 
    2. In the More actions menu, click Query template
    3. Add a template. 
      1. In the Template Name field, specify EMA. 
      2. In the Page Size field, specify 1. 
    4. Add the following values to the Query Template Attributes: 
      • actstart
        description
        description_longdescription
        owner
        rel$asset.assetnum*
        rel$asset.assettype*
        rel$asset.description*
        rel$asset.rel$classstructure.classificationid*
        rel$assignment.laborcode*
        rel$classstructure.classificationid*
        rel$failure.description*
        rel$failure.failurecode*
        rel$location.description*
        rel$location.location*
        reportdate
        schedstart
        status
        targstartdate
        wonum
        siteid
        rel$asset.siteid*
        rel$location.siteid*
        rel$woactivity.taskid*
        rel$woactivity.description*
  2. Create a publish channel. 
    1. In the Publish Channels application, create a new publish channel. 
    2. In the Name field, specify MXINTEMA. 
    3. In the Object Structure field, specify MXAPIWODETAIL. 
    4. In the Template Name field, specify EMA. 
    5. Select the Publish JSON checkbox.
    6. Click Enable Event Listener. 
    7. Save the publish channel. 
  3. Create an end point. 
    1. In the End Points application, create a new end point. 
    2. In the Name field, specify EMA. 
    3. In the Handler field, specify HTTP. 
    4. For headers, specify the following text. Replace variables with your values. 
      X-TENANT-ID:{tenant ID}
      X-API-KEY:{API key for document management}
      Content-Type: application/json
    5. For the HTTPMETHOD, specify POST. 
    6. For the URL, specify the following text. Replace the {collection ID} variable with your collection ID: https://ea-prod-cluster.us-south.containers.appdomain.cloud/api/v1/document-management/collections/{collection ID}/workorders/json
    7. Click Test
    8. Specify the following test data: 
      { "member": [ { "wonum": "1", "status": "OPEN" }, { "wonum": "2", "status": "CLOSE" } ] }
    9. Click Test

      If the response is {}, continue to step 4.

      If the response contains java.security.cert.CertificateException, complete the steps in the SSL Configuration for IoT Platform and Cloudant Database section of the Configuring the Watson IoT Platform for Maximo Asset Health Insights 7.6 article to add the Maximo Assist certificate. If the 'Received fatal alert: protocal_version' error occurs, complete the steps in the Configuring WebSphere Application Server to support TLS 1.2 for NIST SP 800-131 topic. After these steps are completed, restart the Maximo server and then repeat steps 3.7 - 3.9. 
  4. Create an external system. 
    1. In the External Systems application, create a new external system. 
    2. In the Name field, specify EMA. 
    3. In the End Point field, specify EMA. 
    4. In the Outbound Sequential Queue field, specify borissquot.
    5. Select the Enabled checkbox.
    6. On the Publish Channels tab, click Select Channel and for MXINTEMA, select the Enabled checkbox. 
    7. Save the external system.

Document Location

Worldwide

[{"Type":"SW","Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSRHPA","label":"IBM Maximo Application Suite"},"ARM Category":[{"code":"a8m3p000000GoD8AAK","label":"Maximo Assist"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.4.0"}]

Document Information

Modified date:
19 May 2021

UID

ibm16445445