Skip to content

03. Features Overview

Ana Silva edited this page Mar 11, 2025 · 19 revisions

Menu Commands

The Accenture SFMC DevTools VS Code Extension allows you to run SFMC DevTools commands through various Menu Command Options. These options are available in the File Explorer, File Editor Title, File Editor Context, and Command Palette. You can access these Menu Command options only from within the deploy and retrieve folders by right-clicking on a file or folder in the Explorer, File tab, or File editor, or by using the command palette.

The following commands should be visible as Menu Command Options depending on the supported metadata types:

  • mcdev: Copy/Copy and Deploy to Business Unit...
  • mcdev: Delete from Server
  • mcdev: Deploy
  • mcdev: Retrieve

--File Explorer Menu--

image

--File Editor Title Menu--

image

--File Editor Menu--

image

--Command Palette Menu (ctrl+shift+p)--

image

> Copy/Copy and Deploy to Business Unit...

The Copy/Copy and Deploy to Business Unit feature allows users to efficiently clone or clone and deploy Marketing Cloud components across different business units. This feature is designed to streamline the process of sharing assets, ensuring consistency and saving time.

Menu Command Option only available from the retrieve folder and for file components.

Accenture SFMC DevTools command

mcdev clone and mcdev deploy

Supported Metadata Types

asset,automation,dataExtension,dataExtract,domainVerification,emailSend,event,fileTransfer,folder,importFile,journey,mobileKeyword,mobileMessage,query,role,script,sendClassification,senderProfile,transactionalEmail,transactionalPush,transactionalSMS,triggeredSend,user,verification

Key Features

  • Copy Components: Duplicate components from one business unit to another. The duplicated components will appear in the deploy folder of the selected business unit.
  • Copy and Deploy Components: Duplicate components from one business unit to another and immediately deploy them to the selected business unit.

How to use

  1. Accessing the Feature:

    • Navigate to the retrieve folder in your project.
    • Right-click on the desired file in File Explorer, File tab, or File editor.
    • Alternatively, use the Command Palette to access the feature.
  2. Copying Components:

    • Select the option mcdev: Copy to Business Unit....
    • Select the option Copy.
    • Choose the target credential and business unit.
    • Wait for the command to finish running. Afterwards, verify that the component has been copied to the selected credential or business unit in the deploy folder.
  3. Copying and Deploying Components:

    • Select the option mcdev: Copy to Business Unit....
    • Select the option Copy and Deploy.
    • Choose the target credential and business unit.
    • Wait for the two commands to finish running. Afterwards, verify that the component has been copied to the selected credential or business unit in the deploy folder and deployed to Marketing Cloud.

Note: If only one credential or business unit is configured, the credential/business unit selection will be skipped, and the extension will automatically copy to the single existing credential or business unit.

> Delete from Server

The Delete from Server feature enables users to remove selected components from the source business unit in Marketing Cloud without manually performing this action in the instance. Use this command with caution, as deleting components will result in the permanent loss of any associated data.

Menu Command Option only available from the retrieve folder and for file components.

Accenture SFMC DevTools command

mcdev delete

Supported Metadata Types

asset,automation,dataExtension,dataExtensionField,dataExtract,domainVerification,emailSend,event,fileTransfer,importFile,journey,list,mobileKeyword,mobileMessage,query,script,sendClassification,senderProfile,transactionalEmail,transactionalPush,transactionalSMS,triggeredSend,verification

Key Features

  • Delete From Server: Deletes the selected components from the source business unit in Marketing Cloud.

How to use

  1. Accessing the Feature:
    • Navigate to the retrieve folder in your project.
    • Right-click on the desired file in File Explorer, File tab, or File editor.
    • Alternatively, use the Command Palette to access the feature.
  2. Deleting Components:
    • Select the option mcdev: Delete From Server.
    • Confirm that you really wish to delete the components from the business unit.
    • Wait for the command to finish running. Afterwards, verify that the component has been deleted from source business unit in Marketing Cloud.

> Deploy

The Deploy feature allows users to easily deploy the selected components to target business units in Marketing Cloud.

Menu Command Option available from the retrieve and deploy folders and for both folders (credential, business unit and metadata type) and file components.

Accenture SFMC DevTools command

mcdev deploy

Supported Metadata Types

asset,automation,dataExtension,dataExtract,domainVerification,emailSend,event,fileTransfer,folder,importFile,journey,mobileKeyword,mobileMessage,query,role,script,sendClassification,senderProfile,transactionalEmail,transactionalPush,transactionalSMS,triggeredSend,user,verification

Key Features

  • Deploy (deploy folder): Deploys the selected components from the deploy folder to the target business unit in Marketing Cloud.
  • Deploy (retrieve folder): Deploys the selected components from the retrieve folder to the target business unit in Marketing Cloud. Only accessible to file components.

How to use

  1. Accessing the Feature:
    • Navigate to the retrieve or deploy folder in your project.
    • Right-click on the desired folder or file in File Explorer, File tab, or File editor.
    • Alternatively, use the Command Palette to access the feature.
  2. Deploying Components:
    • Select the option mcdev: Deploy.
    • Wait for the command to finish running. Afterwards, verify that the component has been deployed to the target business unit in Marketing Cloud where the command was executed.

> Retrieve

The Retrieve feature allows users to easily retrieve multiple components from the selected business units in Marketing Cloud.

Menu Command Option only available from the retrieve for both folders (credential, business unit and metadata type) and file components.

Accenture SFMC DevTools command

mcdev retrieve

Supported Metadata Types

asset,attributeGroup,attributeSet,automation,campaign,contentArea,dataExtension,dataExtensionField,dataExtensionTemplate,dataExtract,dataExtractType,deliveryProfile,discovery,domainVerification,email,emailSend,event,fileLocation,fileTransfer,filter,folder,importFile,journey,list,mobileCode,mobileKeyword,mobileMessage,query,role,script,sendClassification,senderProfile,transactionalEmail,transactionalPush,transactionalSMS,triggeredSend,user,verification

Key Features

  • Retrieve: Retrieves components to the retrieve folder based on the selected business units or metadata selection in Marketing Cloud.

How to use

  1. Accessing the Feature:
    • Navigate to the retrieve in your project.
    • Right-click on the desired folder or file in File Explorer, File tab, or File editor.
    • Alternatively, use the Command Palette to access the feature.
  2. Deploying Components:
    • Select the option mcdev: Retrieve.
    • Wait for the command to finish running. Afterwards, verify that the components have been retrieved to selected business unit in the retrieve folder where the command was executed.

Clone this wiki locally