Work with multiple AL project folders within one workspace

Visual Studio Code offers the multi-root workspace feature, which enables grouping different project folders into one workspace. The AL Language extension for Microsoft Dynamics 365 Business Central also supports the multi-root functionality and allows you to work with multiple AL folders including roots and projects within one workspace.

Work with multiple project folders

Go through the following steps to work simultaneously on several related projects.

  1. On the File tab of Visual Studio Code, choose Add Folder to Workspace... .
  2. Save the workspace file if you plan to open it again.
    This will create a code-workspace file that contains an array of folders with either absolute or relative paths. If you want to share your workspace files, choose the relative paths.
  3. Modify the settings of your files in the Settings editor. You can change your user settings, global workspace settings, or individual folder settings.

For more information about multi-root workspaces in Visual Studio Code, see Multi-root Workspaces.

Group a set of disparate project folders into one workspace

It isn't mandatory to use only AL-based roots. Different kinds of projects can be mixed, and each AL project will have its configuration values for the following settings:

  • al.packageCachePath
  • al.enableCodeAnalysis

The al.packageCachePath setting allows you to specify the path to a folder that will act as the cache for the symbol files used by your project. It can be specified in the User Settings, Workspace Settings, or Project Settings. The al.enableCodeAnalysis setting allows you to enable the execution of code analyzers on your project. It can likewise be specified in the User Settings, Workspace Settings, or Project Settings. For more information, see AL Language Extension Configuration.

Making sure that your project or workspace is updated


When working in a project or workspace, some operations require that you run a Reload Window command (Ctrl+R) for your project or workspace to ensure that it’s updated correctly. Examples are; source control operations like Git Pull, changes made to the app.json file, or updating User or Workspace settings for AL.

See also

Development in AL
Best Practices for AL
Working with Multiple Projects and Project References