Asset integration

The External Systems application provides an enterprise service for integrating asset and asset hierarchy data from Maximo® Monitor to Maximo Manage.

Assets integration

The following artifacts are used to integrate assets:
  • Enterprise Service: MASDDASSET
  • Object Structure: MXAPIASSET

All assets can be integrated.

If Maximo Monitor uses an asset type that does not exist in the Maximo Manage ASSETTYPE domain, the asset type is created in Maximo Manage as a synonym of the PRODUCTION type. This value is configurable. You can change it by changing the mxe.int.masdddfktassettype property.

The following table describes how statuses are mapped for the LOCASSETSTATUS domain from Maximo Monitor to Maximo Manage:
Table 1. Status assignments for the integration
Status in Maximo Monitor Status that is assigned in Maximo Manage
ACTIVE The default external value for the OPERATING internal value.
ARCHIVED A synonym of the OPERATING internal value.

If the imported description from Maximo Monitor exceeds the maximum length that is allowed in the Description field in Maximo Manage, the text is truncated. However, the full description is provided in the Long Description field.

Asset hierarchies are not integrated by using this integration. Hierarchies are integrated by using the asset hierarchy integration.

Mismatches in field lengths between Maximo Monitor and Maximo Manage can prevent accurate integration. Integration fails when a field length in Maximo Monitor is greater than the maximum field length in Maximo Manage.

When you integrate data from Maximo Monitor to Maximo Manage, adjustments are sometimes required for field lengths. The following table describes the default field lengths and data types that Maximo Manage uses for the asset attributes:
Table 2. Data types and lengths for asset attributes
Attribute Data type Length
ASSETNUM UPPER 25
SITEID UPPER 8
ASSETUID BIGINT 19
TYPE UPPER 20
STATUS ALN 20
DESCRIPTION ALN 100

Asset hierarchies integration

The following artifacts are used to integrate asset hierarchies:
  • Enterprise Service: MASDDASSETHIER
  • Object Structure: MXAPIOPERLOC
  • Query template: MASDDASSETHIER

You can integrate all asset hierarchies. Asset hierarchies are moved after assets are moved to ensure that hierarchies are accurately correlated with the assets.

Mismatches in field lengths between Maximo Monitor and Maximo Manage can prevent accurate integration of asset hierarchies. Adjustments are sometimes required for field lengths. The following table describes the default field lengths and data types that Maximo Manage uses for the asset hierarchy attributes:
Table 3. Data types and lengths for asset hierarchy attributes
Attribute Data type Length
ASSETNUM UPPER 25
PARENT UPPER 25
SITEID UPPER 8