AssetRelationship

Represents a non-hierarchical relationship between assets due to an asset modification; for example, a replacement, upgrade, or other circumstance. This object is available in API version 41.0 and later.

Asset relationships appear in the Primary Assets and Related Assets related lists on asset records in the UI.

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

Fields

Field Name	Details
AssetId	Type reference Properties Create, Filter, Group, Sort Description The unique identifier of the new asset, which is the asset that is taking the place of the existing asset. This field is a relationship field. Relationship Name Asset Relationship Type Lookup Refers To Asset
AssetRelationshipNumber	Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description An auto-generated number identifying the asset relationship.
FromDate	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date when the new asset is installed.
LastReferencedDate	Type dateTime Properties Filter, Nillable, Sort Description The timestamp when the current user last accessed this record, a record related to this record, or a list view. Its label in the user interface is Last Modified Date.
LastViewedDate	Type dateTime Properties Filter, Nillable, Sort Description The timestamp when the current user last viewed this record or list view. If this value is null, the user might have only accessed this record or list view (LastReferencedDate) but not viewed it.
RelatedAssetId	Type reference Properties Create, Filter, Group, Sort, Update Description The existing asset that is being modified. This field is a relationship field. Relationship Name RelatedAsset Relationship Type Lookup Refers To Asset
RelationshipType	Type picklist Properties Create, Defaulted on create, Filter, Group, Nillable, Sort, Update Description The type of relationship between the existing asset and the new asset. This field comes with three values—Replacement, Upgrade, and Crossgrade—but you can create more values in Setup. Possible values are: `Crossgrade`—The new asset is a crossgrade of an existing asset. For example, changing a subscription to a plan with the same service, but that runs for a longer amount of time. `Replacement`—The new asset is replacing an existing asset. For example, a customer’s faulty widget that was under warranty is being replaced with a new one. `Upgrade`—The new asset is an upgrade of an existing asset. For example, upgrading a customer’s existing subscription plan to a new plan with more services. The default value is `Replacement`.
ToDate	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date when the modified asset is uninstalled.

Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

AssetRelationshipChangeEvent (Available in API version 57.0): Change events are available for the object.
AssetRelationshipFeed: Feed tracking is available for the object.
AssetRelationshipHistory: History is available for tracked fields of the object.
AssetRelationshipOwnerSharingRule (Available in API version 57.0): Sharing rules are available for the object.
AssetRelationshipShare (Available in API version 57.0): Sharing is available for the object.

Object Reference for the Salesforce Platform

AssetRelationship

Supported Calls

Fields

Associated Objects