Skip to content

02. Getting Started

Ana Silva edited this page Mar 7, 2024 · 9 revisions

Pre Requisites

To be able to use Accenture SFMC DevTools extension, certain pre requisites steps must be completed:

Install Node.js with npm

  1. Check if node is already installed on your computer by typing at the OS command prompt: node --version
    • If this command reports Node version 15.0.0 or later, you can proceed to the next pre requisite installation.
    • If the reported version is earlier than 15.0.0, continue to step 2.
    • If you get a “command not found” error message, continue to step 2.
  2. Go to nodejs.org
  3. Download and run the latest LTS installer for your operating system.
  4. When the installer finishes, try step 1 again. If it fails, please restart your terminal. If it still does not work, reboot your computer and check the version by running the same command as in the 1st step.

Install the Git Command Line

  1. Check if git is already installed on your computer by typing at the OS command prompt: git version
    • If this command reports a git version such as “git version 2.31.0” (or "git version 2.31.0.windows.1" on Windows), you can proceed to the next pre requisite installation.
    • If you get a “command not found” error message, continue to step 2.
  2. Go to git-scm.com/downloads.
  3. Under Downloads, click the icon for your operating system.
  4. Run the installer.
  5. When the installer finishes, try step 1 again. If it fails, please restart your terminal. If it still does not work, reboot your computer and check the version by running the same command as in the 1st step.

Install Accenture SFMC DevTools

  1. Install Accenture SFMC DevTools by running npm install -g mcdev (prefix with sudo on MacOS)

When completed run mcdev --version and it will show you which version you installed (e.g. 4.2.0).

Install VS Code Extension

  1. Open Visual Studio Code and navigate to the Extension tab (alternatively you can also click Ctrl + Shift + X

    • Usually you can find the Extension tab at the left side of your screen and with the icon image

    image

Initialize SFMC DevTools Project

The extension currently does not support the initialization of a SFMC DevTools Project. If you are starting a new project you should execute the SFMC DevTools command mcdev init.

  1. In Visual Studio Code, go to Terminal and click on New Terminal.
  2. Enter the command mcdev init and follow the interactive instructions to initialize a new project. For more guidance, consult the official SFMC DevTools documentation here