View Only

Maximo integration with Digital Twin Exchange

By Sarika Budhiraja posted Thu September 10, 2020 04:04 PM


IBM Maximo Asset Management version 7612 includes integration with the IBM Digital Twin Exchange. IBM Digital Twin Exchange allows manufacturers, OEMs, and 3rd Party content providers to share digital resources as digital twins. This integration facilitates bringing accurate data into Maximo and decrease time to value for customers. Maximo customers would be able to exchange common business practices around the maintenance of critical assets, minimize downtime, and create effective communication amongst asset owners, operators, and maintainers using this integration.


The following diagram illustrates how the messages flow between the Maximo and Digital Twin Exchange. Maximo requests the digital twin asset data by calling the Digital Twin REST API.

The following Digital Twin APIs are called by the Maximo Digital Twin service:

  • Product/Asset List API to get the product List bought by the user
  • Product/Asset API to get asset details
  • Spare Part API to get spare parts details for the asset
  • Job Plan API to get job plans/job tasks for the asset
  • Attachment API to get attachments for the asset

The data returned by the APIs is saved in the Maximo using internal MIF APIs.

IBM Digital Twin Exchange

Visit Digital Twin to browse and search for digital twin resources.

A digital twin exchange account needs to be created (see the IBM Digital Twin link section below), and a user can obtain the API key from the Digital Twin account.

The user can buy products from the digital twin exchange. The digital twin data can be imported in Maximo through this new integration.

Maximo integration with Digital Twin Exchange

This integration allows content providers and manufacturer’s digital assets data related to physical assets to be added or updated in Maximo. This data can be used to create work orders using job plans for asset maintenance. There is a new action “Import Digital Data” in the Assets application. When a user clicks on the action, the “Import Digital Twin Data” dialog gets displayed. The user needs to use the email id and key from the digital twin exchange account in this dialog and click on the Request Data button. It will call the API to get the product list that the user has bought using the IBM Digital twin exchange in a digital marketplace. The “Filter by Name” can be set to filter products by name. The multiple records can be selected to import the asset/product digital data. The “Import Data” button at the right bottom of the dialog needs to be clicked to import data. After the data is imported status field will get updated with Success or Fail. In case of failure, an information icon will get the display to show error(s). The digital data logger can be enabled to debug via system properties application.

Digital Twin Exchange data in Maximo

The “Import Digital Data” action creates the following data objects:

  • Item records with images.
  • The asset with Spare part records for the selected digital twin product with images and attachments.
  • Job plan and Job tasks with asset link record.

The Maximo digital twin service uses MXAPIASSETSPARE, MXITEM, and MXAPIJOBPLAN integration objects to add/update data.

Custom Integration Mapping

Additional fields in Maximo can be mapped with incoming data from IBM Digital Twin Exchange. An automation script can be used to customize mapping for an integration point in the Maximo-Digital Twin Exchange integration.

These APIs can be used for mapping additional fields from the Maximo Digital Twin service are as follows:

  • For additional mapping of the asset data, add mapping in the JSONObject by calling the following method.

public JSONObject getProducts (String productid)

  • For additional mapping of the spare part/item data, add mapping in the JSONObject by calling the following method.

Public JSONObject getSparts (String productid)

  • For additional mapping of the job plan data, add mapping in the JSONObject by calling the following method.

Public JSONObject getJobPlans (String productid)

A sample is in the product documentation.

Additional IBM Digital Twin Links:

Demo of the IBM Digital Twin Exchange and how to import digital twin data into IBM Maximo Asset Management.

Create an account before completing a purchase

Maximo integration with the IBM Digital Twin Exchange

IBM Digital Twin Exchange