Integration overview

Edit online

When you import digital data into Maximo® Manage from Digital Twin Exchange, asset-related items, such as assets, spare parts, and job plans, are automatically created in the Manage database.

You use the Assets application to import digital data into Maximo Manage. You specify the digital data source and the connection parameters. The connection parameters are your IBMid and your Digital Twin Exchange key.

You request a preview of product data from Digital Twin Exchange. The connection parameters and the URL that is configured in the mxe.dtexendpoint system property are used to connect to Digital Twin Exchange and request the digital data.

The list of products that you are entitled to import is displayed, and you decide whether you want to import them. You can select individual products to import from the list.

When you import a digital product, asset-related and job-plan-related data is retrieved from Digital Twin Exchange for the product that you select, and corresponding records are created in the Manage database. Records for spare parts, attachments, and job plans can be created and updated during import processing. Asset records can be created but cannot be updated.

To prevent database dependency issues, records are created in the Manage database in the following order:
  1. Item records for spare parts
  2. Asset records
  3. Job plan records
  4. Attachment records
The value that is specified in the mxe.dtexprefix system property is prefixed to internal identifiers to set the item, spare part, and job plan numbers in the database.

The importing of each digital data product requires several calls to Digital Twin Exchange APIs. If an API call fails, that product and any remaining unimported products are not imported. For example, when you attempt to import four products, if the first two are imported successfully but the third is not because an API call fails, then both the third and fourth products are not imported.

During an import, asset-related and job-plan-related records are created in Maximo Manage for only the default site and organization that are associated with the current user session.