Technical Blog Post
Abstract
Installing and Removing ACM Assets with the Maximo Integration Framework
Body
Maximo Asset Configuration Manager (ACM) allows a complete history of the components which make up a complex a
Asset to be maintained and easily viewed for any given point in time.
The ACM 7.5.0.1 patch introduced the ability to use the Maximo Integration Framework (MIF) to perform many ACM functions and load data into associated tables.
The ACM 7.5.0.1 patch introduced the ability to use the Maximo Integration Framework (MIF) to perform many ACM functions and load data into associated tables.
One of the most common functions used within (ACM) is the and removal and installation of sub-assembly Assets. These operations are now achievable via the MIF and three separate transactions are possible:
1) Installation of an asset.
2) Removal of an asset.
3) Removal of an asset and installation of a different asset.
2) Removal of an asset.
3) Removal of an asset and installation of a different asset.
The object structure: PLUSAMXSAONOFF included with the ACM 7.5.0.1 patch exposes these operations and the provided processing class: psdi.plusa.iface.app.plusasa.MaxPlusACMSAOnOffProcess contains the logic to perform the transactions.
The identification of which node in an Asset's build hierarchy the installation or removal occurs for can be identified either by LCN value or Label and Position (LCN taking priority if it is specified).
The following xml gives examples of how to perform the actions:
Installation:
Removal:
<SyncPLUSAMXSAONOFF ...>
<PLUSAMXSAONOFFSet>
<PLUSASAONOFF action="AddChange">
<REMOVEASSET>1</REMOVEASSET> <!-- Indicates that a removal is taking place -->
<PARENTASSETNUM>A340-001</PARENTASSETNUM> <!-- Parent Asset from which the Asset is being removed-->
<ASSETNUM>TRENT001</ASSETNUM> <!-- Asset which is being removed -->
<LCN>L000002</LCN> <!-- LCN value used to identify from where the removal is occurring -->
<LABEL>720000-0100-00-001</LABEL> <!--If LCN is not specified in the inbound transaction Label and Position can be used -->
<POSITION>2</POSITION>
<OFFTIME>2012-03-21T13:05:30</OFFTIME> <!-- Date/time at which the removal occurred -->
<FOLLOWONWORKTYPE>OVHL</FOLLOWONWORKTYPE> <!-- Indicates that a work order should be created with the Work Type specified following the removal (optional) -->
<REMOVETOLOCATION>WEST</REMOVETOLOCATION> <!-- Location to where the Asset should be removed (optional) -->
<SITEID>BEDFORD</SITEID>
<ORGID>EAGLENA</ORGID>`
</PLUSASAONOFF>
</PLUSAMXSAONOFFSet>
</SyncPLUSAMXSAONOFF>
<SyncPLUSAMXSAONOFF ...>
<PLUSAMXSAONOFFSet>
<PLUSASAONOFF action="AddChange">
<REMOVEASSET>1</REMOVEASSET> <!-- Indicates that a removal is taking place -->
<PARENTASSETNUM>A340-001</PARENTASSETNUM> <!-- Parent Asset from which the Asset is being removed-->
<ASSETNUM>TRENT001</ASSETNUM> <!-- Asset which is being removed -->
<LCN>L000002</LCN> <!-- LCN value used to identify from where the removal is occurring -->
<LABEL>720000-0100-00-001</LABEL> <!--If LCN is not specified in the inbound transaction Label and Position can be used -->
<POSITION>2</POSITION>
<OFFTIME>2012-03-21T13:05:30</OFFTIME> <!-- Date/time at which the removal occurred -->
<FOLLOWONWORKTYPE>OVHL</FOLLOWONWORKTYPE> <!-- Indicates that a work order should be created with the Work Type specified following the removal (optional) -->
<REMOVETOLOCATION>WEST</REMOVETOLOCATION> <!-- Location to where the Asset should be removed (optional) -->
<SITEID>BEDFORD</SITEID>
<ORGID>EAGLENA</ORGID>`
</PLUSASAONOFF>
</PLUSAMXSAONOFFSet>
</SyncPLUSAMXSAONOFF>
Installation:
<SyncPLUSAMXSAONOFF ...>
<PLUSAMXSAONOFFSet>
<PLUSASAONOFF action="AddChange">
<PARENTASSETNUM>A340-001</PARENTASSETNUM> <!-- Parent Asset into which the Asset is being installed -->
<INSTALLASSET>TRENT002</INSTALLASSET> <!-- Asset being installed -->
<LCN>L000002</LCN> <!-- LCN value used to identify to where the installation is occurring -->
<LABEL>720000-0100-00-001</LABEL> <!--If LCN is not specified in the inbound transaction Label and Position can be used -->
<POSITION>2</POSITION>
<ONTIME>2012-03-21T14:55:00</ONTIME> <!-- Date/time at which the installation occurred -->
<SITEID>BEDFORD</SITEID>
<ORGID>EAGLENA</ORGID>
</PLUSASAONOFF>
</PLUSAMXSAONOFFSet>
</SyncPLUSAMXSAONOFF>
Combined Installation and Removal:
<SyncPLUSAMXSAONOFF ...>
<PLUSAMXSAONOFFSet>
<PLUSASAONOFF action="AddChange">
<REMOVEASSET>1</REMOVEASSET> <!-- Indicates that a removal is taking place -->
<PARENTASSETNUM>A340-001</PARENTASSETNUM> <!-- Parent Asset from which the Asset is being removed/installed-->
<ASSETNUM>TRENT001</ASSETNUM> <!-- Asset which is being removed -->
<INSTALLASSET>TRENT002</INSTALLASSET> <!-- Asset being installed -->
<LCN>L000002</LCN> <!-- LCN value used to identify from where the transaction is occurring -->
<LABEL>720000-0100-00-001</LABEL> <!--If LCN is not specified in the inbound transaction Label and Position can be used -->
<POSITION>2</POSITION>
<ONTIME>2012-03-21T16:25:30</ONTIME> <!-- Date/time at which the removal and installation takes place -->
<FOLLOWONWORKTYPE>OVHL</FOLLOWONWORKTYPE> <!-- Indicates that a work order should be created with the Work Type specified following the removal (optional) -->
<REMOVETOLOCATION>WEST</REMOVETOLOCATION> <!-- Location to where the Asset should be removed (optional) --
<SITEID>BEDFORD</SITEID>
<ORGID>EAGLENA</ORGID>
</PLUSASAONOFF>
</PLUSAMXSAONOFFSet>
</SyncPLUSAMXSAONOFF>
<SyncPLUSAMXSAONOFF ...>
<PLUSAMXSAONOFFSet>
<PLUSASAONOFF action="AddChange">
<REMOVEASSET>1</REMOVEASSET> <!-- Indicates that a removal is taking place -->
<PARENTASSETNUM>A340-001</PARENTASSETNUM> <!-- Parent Asset from which the Asset is being removed/installed-->
<ASSETNUM>TRENT001</ASSETNUM> <!-- Asset which is being removed -->
<INSTALLASSET>TRENT002</INSTALLASSET> <!-- Asset being installed -->
<LCN>L000002</LCN> <!-- LCN value used to identify from where the transaction is occurring -->
<LABEL>720000-0100-00-001</LABEL> <!--If LCN is not specified in the inbound transaction Label and Position can be used -->
<POSITION>2</POSITION>
<ONTIME>2012-03-21T16:25:30</ONTIME> <!-- Date/time at which the removal and installation takes place -->
<FOLLOWONWORKTYPE>OVHL</FOLLOWONWORKTYPE> <!-- Indicates that a work order should be created with the Work Type specified following the removal (optional) -->
<REMOVETOLOCATION>WEST</REMOVETOLOCATION> <!-- Location to where the Asset should be removed (optional) --
<SITEID>BEDFORD</SITEID>
<ORGID>EAGLENA</ORGID>
</PLUSASAONOFF>
</PLUSAMXSAONOFFSet>
</SyncPLUSAMXSAONOFF>
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSLKT6","label":"IBM Maximo Asset Management"},"Component":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]
UID
ibm11134585