---
schema_version: "1"
id: 97c5941a497d206569057222965dc6a800f55ccac5d09fc86802fd58d686607f
title: TelemetryActionDefinition
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/automotive_cloud/auto_metadata_api_telemetryactiondefinition.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.automotive_cloud.meta/automotive_cloud/auto_metadata_api_telemetryactiondefinition.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: ea00581df6f86f09abb121dbfa8968548a54650fbc6a6cca8c099d70c1949682
description: Represents the action taken on a telemetry signal sent from a connected asset or vehicle, such as getting the current status of a vehicle or its component, or sending a request to perform a remote action on the vehicle or its component.
---
# TelemetryActionDefinition

Represents the action taken on a telemetry signal sent from a connected asset or vehicle, such as getting the current status of a vehicle or its component, or sending a request to perform a remote action on the vehicle or its component.

## Parent Type

This type extends the Metadata metadata type and inherits its fullName field.

## File Suffix and Directory Location

TelemetryActionDefinition components have the suffix .TelemetryActionDefinition and are stored in the TelemetryActionDefinitions folder.

## Version

TelemetryActionDefinition components are available in API version 65.0 and later.

## Fields

### actionName

- **Field Type**: string
- **Description**: Required. The full name of the action related to a telemetry definition.

### description

- **Field Type**: string
- **Description**: The description of the telemetry action definition.

### developerName

- **Field Type**: string
- **Description**: The developer’s internal name for the API.
    
    For example, if you create a record with MyCustomRecord name, you cannot create another record with that same name.

### executionProcedure

- **Field Type**: string
- **Description**: The execution procedure that's used to fulfill telemetry action related processes.

### isActive

- **Field Type**: boolean
- **Description**: Indicates whether the telemetry definition version is active (true) or not (false).
- **Default value**: false

### isProtected

- **Field Type**: boolean
- **Description**: An auto-generated value that doesn’t impact the behavior of the metadata type.
- **Default value**: false

### masterLabel

- **Field Type**: string
- **Description**: Required. A user-friendly name for TelemetryActionDefinition, which is defined when the TelemetryActionDefinition is created.

### telemetryDefinitionVersion

- **Field Type**: string
- **Description**: Required. The telemetry definition version related to the action.

## Declarative Metadata Sample Definition

The following is an example of a TelemetryActionDefinition component.

<?xml version="1.0" encoding="UTF-8"?>
<TelemetryActionDefinition xmlns="http://soap.sforce.com/2006/04/metadata">
    <actionName\>HoodStatusControl</actionName\>
    <description\>Action to monitor and control vehicle hood open/close status and switch operations</description\>
    <developerName\>HoodStatusControl</developerName\>
    <executionProcedure\>HoodControlFlow</executionProcedureIdentifier\>
    <isActive\>true</isActive\>
    <isProtected\>false</isProtected\>
    <masterLabel\>Hood Status Control</masterLabel\>
    <telemetryDefinitionVersion\>VehicleBodyMonitoringv1</telemetryDefinitionVersion\>
</TelemetryActionDefinition\>

The following is an example package.xml that references the previous definition.

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types\>
        <members\>\*</members\>
        <name\>TelemetryActionDefinition</name\>
    </types\>
    <version\>65.0</version\>
</Package\>