You are here:
Configure Flexcard on Vehicle Page to Get Real-Time Status and Diagnostics
Add the ConnectedServicesVehicleStatusParentCard Flexcard to a Vehicle record page. The Flexcard shows key metrics of a vehicle’s real-time state as shared by the telematics provider. Users can also refresh the data on demand right from the Flexcard.
Required Editions
| Available in: Enterprise, Unlimited, and Developer Editions. |
| User Permissions Needed | |
|---|---|
| To modify a page layout: | Customize Application |
Make sure you know the API names of the metrics that the telematics provider sends to MuleSoft or any other integration layer that you use. If you use Qualcomm’s Car-to-Cloud telematics services, the data is sent to Salesforce via MuleSoft as part of the GET/sensor-elements API response.
-
Open a vehicle record page and click Setup.
Make sure the Connected Services Active checkbox is selected for the vehicle.
- Click Edit Page.
-
Drag the Flexcard component to the page.
We recommend you add the component to the Connected Services tab on the page.
- On the Component Properties panel, for Flexcard Name, search and select ConnectedServicesVehicleStatusParentCard.
-
For First Metric Name, enter the API name of the metric that you want to show.
The name must match the API name of the metric that the telematics provider sends.
- For First Metric Label, enter the name of the metric as shown to the user.
-
For First Metric Display Type, enter Text or
ProgressBar.
A metric appears as a progress bar only when the telematics provider sends the maximum and minimum values for the metric. By default, all metrics appear as text values.
-
To show more metrics, repeat steps 4–6.
For example, to show two metrics, fill out fields such as Second Metric Name, Second Metric Label, and Second Metric Display Type.
- Save your changes..
- Click Activation.
The telematics provider for Neo Motors sends this response when the Get Vehicle Status API is triggered:
{
"message": "Successfully fetched the current values",
"responseData": {
"dataList": [
{
"id": 291504901,
"name": "ENGINE_RPM",
"unit": "rpm",
"value": "27",
"updatedTime": 1677296744089
},
{
"id": 291504644,
"name": "ODOMETER_READING",
"unit": "km",
"value": "25.0",
"updatedTime": 1677296744996
},
{
"id": 291504905,
"name": "EV_BATTERY_LEVEL",
"unit": "wh",
"maxvalue": "100",
"minvalue": "20",
"updatedTime": 1677296742209
}Here’s how the admin specifies the Flexcard properties in Lightning App Builder for this response.
| Field | Value | Explanation |
|---|---|---|
| First Metric Name | ENGINE_RPM | The name of the metric as shared by the telematics provider. |
| First Metric Label | Revolutions Per Minute | The name of the metric that the user sees on a Vehicle record page. |
| First Metric Display Type | Text | The data appears as text that shows the current value based on the Value field of the metric as shared by the telematics provider. |
| Second Metric Name | ODOMETER_READING | The name of the metric as shared by the telematics provider. |
| Second Metric Label | Latest Odometer Reading | The name of the metric that the user sees on a Vehicle record page. |
| Second Metric Display Type | Text | The data appears as text that shows the current value based on the Value field of the metric as shared by the telematics provider. |
| Third Metric Name | EV_BATTERY_LEVEL | The name of the metric as shared by the telematics provider. |
| Third Metric Label | Charge Remaining | The name of the metric that the user sees on a Vehicle record page. |
| Third Metric Display Type | ProgressBar | The data appears with a progress bar that computes the remaining charge based on the maximum and minimum values of the metric as shared by the telematics provider. |
