Siebel Field Service Guide > Business Service Methods Reference for Field Service > Asset Management >
SwapAssetEntitlements is used to swap asset entitlements. Service activities often include the replacement of one asset with another. When two assets are swapped, the entitlements of the uninstalled asset can be transferred to the installed asset on an individual basis.
For contracts which include entitlements for the removed asset, those entitlements' asset values on the Service Agreement Product business component are updated with the installed asset's number, replacing the asset number of the uninstalled asset. When this business component is updated, the Asset # field on the Agreements screen > List > Entitlements > Products view changes to display the new asset.
Asset swaps also transfer any hierarchical relationships from the uninstalled asset to the installed asset, with one exception. The exception is that if an uninstalled asset is a child asset, the uninstalled asset's parent becomes the installed asset's parent, but the uninstalled asset keeps any children it may have.
This method is invoked when a record in the FS Activity Part Movements List Applet (used in the Activities screen > Part Tracker view) includes the following:
- Serialized asset
- Valid Swap Part Mvmt # value
- Commit flag set to Y (by selecting the check box or clicking the Commit button).
This method can also be invoked from eScript.