Advanced Tools Suite for AL Language

A complete suite of utilities to enhance your development experience with AL Language

Features

These features are concluded at this moment:

launch.json manager

Store all launch.json files in a local or shared folder and select which one to use for the current project.
With these features you can easily share launchers with your colleagues:

• Import launch.json file on your workspace by command ATS: Import 'launch.json'
• Export launch.json file of your workspace by command ATS: Export 'launch.json'
• Open launch.json file of your workspace by command ATS: Open 'launch.json'
• Change default startup object on launch.json file by command ATS: Change default startup object and run Business Central
  
  

Run Business Central

The command ATS: Run Business Central allows running the Business Central client by selecting the configuration to use among the various configurations defined in the launch.json file.

You can define URL Forwarding Rules in vscode settings to run Business Central using a different URL than the one defined in the launch.json file for each configuration. This can be useful for custom setups or scenarios where URL conversion is needed.

Use Cases for Forwarding Rules:

• Public URL: Run the Business Central client using a public URL different from the local one specified in the launch.json file.
  

• HTTP to HTTPS Conversion: Automatically convert the URL from HTTP to HTTPS to ensure a secure connection to the Business Central client.

Rule Mechanism:
You can define rules to replace the entire URL or part of it.
When the command ATS: Run Business Central is executed, the specified URL is replaced or modified according to the forwarding rules.
Example:
Configuration in launch.json: http://mybcserver:8080
Applied Rule: Redirect to https://businesscentral.mydomain.com
These rules make running the Business Central client more flexible and secure without requiring manual adjustments to every configuration.

Namespace utilities

• Set object namespace based on current file path by command ATS: Set object namespace based on file path
  
  

• Namespace completion providers based on:

  • Current File path if ats.UseObjectFilePathAsNamespace setting is enabled
  • Default Root Namespace defined by al.RootNamespace setting
  • Default Root Namespace defined by ats.RootNamespace setting
  • Additional custom Namespaces defined in ats.DefaultNamespaces setting
    

Region utilities

• Create regions by snippet tregion
  

• Create region for the selected code in the current editor by command ATS: Create region by selection
  

• Region Path info on status bar:
  

Snippets

tsingleLineFields:

An easy way to organize page fields in a single-line structure.
With this structure you can create a complex grid like this:

tsingleLineFieldsWithCaptionTop:

An easy way to organize page fields in a single-line structure with caption at the top.
With this structure you can create a complex grid like this:

Extension settings

• ATS.DefaultLaunchArchiveFolder: Default archive folder for import/export utiltities of launch.json file;
• ATS.UseObjectFilePathAsNamespace: Allow usage of object file path for namespace declarations (default = false). The number of positions included depends on the value defined in the ATS.MaxNamespaceSize setting;
• ATS.RootNamespace: Namespace prefix to use for diagnositc rules and suggestions (if specified overrides the use of the al.rootNamespace setting);
• ATS.DefaultNamespaces: List of default namespaces that can be used for AL objects;
• ATS.MaxNamespaceSize: No. of max elements expected for namespace declaration in AL objects (default = 5);
• ATS.EnableNamespaceDiagnostics: Enable or disable warnings for wrong or missing namespace declarations in AL objects (default = false); Allowed values:
  • ATS.RootNamespace or AL.RootNamespace setting value;
  • Object file path (if ATS.UseObjectFilePathAsNamespace setting is enabled);
  • Custom namespaces defined in ATS.DefaultNamespaces setting.
• ATS.NamespaceMandatory: Enable or disable errors for missing namespace declarations in AL objects (default = false). This setting will be used only if the ATS.EnableNamespaceDiagnostics setting is enabled;
• ATS.URLForwardingRules: Conversion rules used by command ATS: Run Business Central to run Business Central Client with different URL instead of the URL defined into launch.json for each configuration (Public URL or http to https conversion);
• ATS.ObjectInfoOnStatusBar: Enable visibility of status bar with AL object info;
• ATS.RegionInfoOnStatusBar: Enable visibility of status bar with region details for current line in active editor.

Requirements

• AL Language extension