Skip to content

hardis:project:metadata:activate-decomposed

Description

Command Behavior

Activate decomposed metadata types in Salesforce DX projects.

This command helps manage decomposed metadata types that can be split into multiple files in source format. It automatically decomposes all supported metadata types that exist in your project.

Supported metadata types (Beta): - CustomLabels - PermissionSet - ExternalServiceRegistration - SharingRules - Workflow

See Salesforce documentation on decomposed metadata

Key features: - Automatically detects and decomposes all applicable metadata types - Decomposes only metadata types that exist in your project - Interactive confirmation for decomposition operations - Handles all confirmation prompts automatically

Technical explanations

This command utilizes Salesforce CLI's decomposed metadata feature to split complex metadata types into smaller, more manageable components:

  • CustomLabels: Each custom label becomes a separate file, making it easier to track changes and manage translations.
  • PermissionSets: Permission sets are decomposed into multiple files based on the permissions they contain (field permissions, object permissions, etc.).
  • ExternalServiceRegistration: Decomposes external service registrations.
  • SharingRules: Decomposes sharing rules into individual components.
  • Workflow: Decomposes workflow rules into individual components.

The command wraps the underlying Salesforce CLI functionality and provides a more user-friendly interface with additional validation and error handling.

Note: All decomposed metadata features are currently in Beta in Salesforce CLI.

Parameters

Name Type Description Default Required Options
debug
-d
boolean Run command in debug mode
flags-dir option undefined
json boolean Format output as json.
skipauth boolean Skip authentication check when a default username is required
websocket option Websocket host:port for VsCode SFDX Hardis UI integration

Examples

$ sf hardis:project:metadata:activate-decomposed
$ sf hardis:project:metadata:activate-decomposed --debug