Product(s):	APM Implementation and Performance Management
	Version(s):	7
	Environment:	N/A
	Area:	N/A
	Subarea:	N/A

Problem

APM Maximo Integration Messages are being received in APM as normal but the messages are erroring when APM tries to process them. Upon review the APM Maximo Integration inbound messages each contained 32-pages of text and had repeating entries.

Solution

The APM Maximo Integration is a two way integration, xml messages are generated in APM and sent to outbound to Maximo and xml messages are generated in Maximo and sent inbound to APM. These messages are staged in APM and then processed on a scheduled basis. When APM processes an inbound message, the xml must be structured in a certain way so that APM can translate the message into an APM object. If APM comes across a message with extra attributes or unrecognized attributes the integration message will error.

Typically a proper integration xml message will be around 1 page long and only contain message related to the asset that owns the object being integrated. For example, the xml message for an integrated Work Order should contain each of the integrated attributes, work order title, work order number, status, etc and one asset reference.

In this reported case, the xml message was malformed. It was 32-pages long and contained repeating entries and entries for assets unrelated to the APM Work Order being updated.

This indicated that Maximo Object Structures and filter were not appropriately set within Maximo, leading to the malformed xml that was being received in APM. The user needed to review the "Setting up the integration in Maximo 7.x" section > Create Object Structures subsection of the APM_Integration_Maximo guide. Other users may need to use the "Setting up the integration in Maximo 6.x" section.

The APM_Integration_Maximo guideis found wherever you store your APM documents. In a typical install, it is found in the following location:

C:\Program Files\Bentley\AssetWise Performance Management\Docs\English\Integration_Guides\

Please launch a Bentley Service Request if you need a copy of the guide.