You are here:
Update Records For Asset Registration Event
The Update Records for Asset Registration Event flow automatically processes incoming Asset Registration Events in your org. Use the flow to automatically update fields of Asset Milestone, Entitlement and Asset Warranty records based on the information passed through the AssetRegistrationUpdateRecordDetails__stdctx context definition. This flow identifies the relevant Asset record through the matching Asset ID or Serial Number and uses the associated context data to update associated records.
Required Editions
| Available in: Lightning Experience |
| Available in: Automotive Cloud and Manufacturing Cloud. View edition availability. |
| User Permissions Needed | |
|---|---|
| To use the orchestration: | Design Actionable Event Orchestration Processes AND Manage Flow |
| To manage the Asset Warranty, Asset Milestone, and Entitlement records: | Read, Create access on Asset Warranty, Asset Milestone, and Entitlement. |
-
Modify the expression set template.
- From the App Launcher, find and select Expression Set Templates.
- Click Update Records for Asset Registration Event from the list view.
- Click Save As and select New Event Orchestration Builder Version.
- Change the name and save your changes.
-
Change the output variables and their corresponding formula, if necessary.
The Persist Data for a Context Definition action in the Update Records for Asset Registration flow requires at least one attribute in the context definition to change before processing event data. In this expression set template, warranty, milestone, and entitlement date fields are manually set to the current date, enabling the action to detect updates and modify context tags accordingly.
- Enter the label and API name.
- Click Save.
- Modify the elements and resources as required.
- Activate the flow.
-
Clone and activate the orchestration template.
- From the App Launcher, find and select Actionable Event Orchestration.
- Select the Update Records for Asset Registration record.
- Click Clone.
- For Execution Procedure Name, select the cloned and activated version of the Update Records for Asset Registration flow.
- For Event Type, select Update Asset Registration Records.
-
For Context Definition name, make sure you select
AssetRegistrationUpdateRecordDetails.
You can either use the context definition as is or use a new version of this definition.
-
For Context Mapping name, make sure you select
AssetRgstrUpdateRecordsMap.
You can either use the context mapping as is or use a new version of this mapping.
- Change other details as required.
- Save your changes.
- To activate the orchestration, select Active.
-
Refresh the decision table.
- From Setup, enter Decision in the Quick Find box, then select Decision Tables.
- Click Filter and Match Actionable Event Orchestrations from the list view.
- Click Refresh.
Flow Inputs and Outputs
| Variable | Direction | Description |
|---|---|---|
| Context ID | Input | The ID of the context definition record associated with the incoming Asset Registration Event. |
| Failure Message | Output | The descriptive error message for when any step in the flow fails. If the flow succeeds, this variable is empty. Use this in downstream processes to detect and handle failures. |
| Description | ||
|---|---|---|
| Context ID | Input | The ID of the context definition record associated with the incoming Asset Registration Event. |
| Failure Message | Output | The descriptive error message for when any step in the flow fails. If the flow succeeds, this variable is empty. Use this in downstream processes to detect and handle failures. |
Payload Field Reference
| Field | Required | Description |
|---|---|---|
| Source System Identifier | Yes | The unique identifier for the external system sending the event. For connected assets, it’s the asset ID and for connected vehicles, it’s the vehicle identification number (VIN). |
| Type | Yes | The developer name of the actionable event type. It must match the event type associated with the Update Records for Asset Registration actionable event orchestration record. |
| Subtype | No | The developer name of the actionable event subtype. It must match the event subtype associated with the Update Records for Asset Registration actionable event orchestration record. |
| Event Data | Yes | The structured event data, provided as a JSON-encoded string. This serialized string contains the attributes required to hydrate the context definition instance, which is then passed to the execution procedure based on the configured input mapping. |
Event Data Field Reference
| Field | Required | Description |
|---|---|---|
| Asset | Yes | The list of asset objects included in the event. |
| Asset Unique Identifier | Yes | The asset record ID or serial number, used by the flow to look up the corresponding asset record. |
| Asset Business Object Type | Yes | The object type for the orchestration engine. Must be “Asset”. |
| Asset Entitlement | No | The related entitlement records, including the Id, businessObjectType, EntitlementName, and EntitlementEndDate. |
| Asset Asset Milestone | No | The related asset milestone records, including id, businessObjectType, and MilestoneName. |
| Asset Asset Warranty | No | The related asset warranty records including id, businessObjectType, and WarrantyEndDate. |
Review the structural example for the payload template.
{
"sourceSystemIdentifier": "<your-system-identifier>",
"type": "Update_Asset_Registration_Records",
"subtype": "<aeo-event-sub-type>",
"eventData": "<stringified-JSON-of-the-structure-below>"
}Review this structural example for the event data template.
{
"Asset": [
{
"UniqueIdentifier": "<asset-salesforce-id-or-serial-number>",
"businessObjectType": "Asset",
"Entitlement": [
{
"id": "<entitlement-record-id>",
"businessObjectType": "Entitlement",
"EntitlementName": "<entitlement-name>",
"EntitlementEndDate": "<YYYY-MM-DD>"
}
],
"AssetMilestone": [
{
"id": "<asset-milestone-record-id>",
"businessObjectType": "AssetMilestone",
"MilestoneName": "<milestone-name>"
}
],
"AssetWarranty": [
{
"id": "<asset-warranty-record-id>",
"businessObjectType": "AssetWarranty",
"WarrantyEndDate": "<YYYY-MM-DD>"
}
]
}
]
}