ActvPlatformFieldValue Metadata Type in SFDX

Architectural Overview#

In enterprise Salesforce orgs running Einstein Activity Capture (EAC) or unified Activity Platform integrations, standard calendar and email fields rarely capture all business-critical context. The ActvPlatformFieldValue metadata type defines the declarative field value mappings between external activity payloads (such as Microsoft Exchange or Google Workspace headers) and Salesforce activity fields.

Architecturally, managing ActvPlatformFieldValue in version control ensures that environment promotions from integration sandboxes to production maintain deterministic activity enrichment without manual post-deployment setup.

SFDX Directory & File Suffix#

Key Metadata Fields#

Declarative XML & package.xml Examples#

Sample .actvPlatformFieldValue-meta.xml#

<?xml version="1.0" encoding="UTF-8"?>
<ActvPlatformFieldValue xmlns="http://soap.sforce.com/2006/04/metadata">
    <actvPlatformField>Meeting_Classification</actvPlatformField>
    <fieldValue>Executive_Briefing</fieldValue>
    <isActive>true</isActive>
    <masterLabel>Executive Briefing Category</masterLabel>
</ActvPlatformFieldValue>

Sample package.xml Manifest#

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types>
        <members>Enterprise_Meeting_Category</members>
        <name>ActvPlatformFieldValue</name>
    </types>
    <version>68.0</version>
</Package>

SFDX CLI Retrieval & Inspection#

Retrieve and deploy ActvPlatformFieldValue components directly via the Salesforce CLI (sf):

# Retrieve all ActvPlatformFieldValue components from the target org
sf project retrieve start --metadata "ActvPlatformFieldValue:*"

# Retrieve a specific activity platform field value definition
sf project retrieve start --metadata "ActvPlatformFieldValue:Enterprise_Meeting_Category"

# Validate deployment in a CI pipeline without committing changes
sf project deploy start --metadata "ActvPlatformFieldValue:Enterprise_Meeting_Category" --dry-run

Senior Architect Best Practices & Gotchas#

• Dependency Ordering: Always include the parent ActvPlatformField and any referenced CustomField on Activity in the same package.xml manifest when promoting across environments.
• Deactivation Over Deletion: In production orgs with historical synced activities, prefer setting <isActive>false</isActive> rather than destructively deleting ActvPlatformFieldValue records so historical audit mappings remain intact.
• Scratch Org Parity: Add "EinsteinActivityCapture" or the required activity sync features to config/project-scratch-def.json so automated CI builds do not fail with Invalid type: ActvPlatformFieldValue.

Frequently asked questions

What is the purpose of ActvPlatformFieldValue in Salesforce?

It maps external email and calendar platform attributes to specific Salesforce activity fields during Einstein Activity Capture and Activity Platform synchronization.

Where are ActvPlatformFieldValue files stored in an SFDX project?

They are stored in the force-app/main/default/actvPlatformFieldValues directory with the .actvPlatformFieldValue-meta.xml file extension.

Can I deploy ActvPlatformFieldValue before deploying the target custom activity field?

No, the target CustomField on the Activity object must exist in the org or be included in the same deployment package, otherwise the deployment fails with a missing dependency error.

How do I retrieve ActvPlatformFieldValue metadata using Salesforce CLI?

Run sf project retrieve start with the metadata parameter set to ActvPlatformFieldValue to pull all configured activity platform field value mappings into your local project.