In your Business Central workspace some configuration files were created and an example AL file (see part 3). In this post we will get into more detail about the configuration files (JSON based).
The AL workspace contains configuration files:
- launch.json
- In this file serveral settings are defined like: servername, server instance and startupobject.
- Located in the .vscode folder
- Controls debug environment
- app.json
- This configuration file serves as a manifest and contains information about your app.
- Located in the workspace root
An example how the file launch.json looks like by default in BC16:
{ "version": "0.2.0", "configurations": [ { "type": "al", "request": "launch", "name": "Your own server", "server": "http://localhost", "serverInstance": "BC160", "authentication": "Windows", "startupObjectId": 22, "startupObjectType": "Page", "breakOnError": true, "launchBrowser": true, "enableLongRunningSqlStatements": true, "enableSqlInformationDebugger": true } ] }
Some more important launch.json settings explained:
Setting | Description | |
authentication | Windows, AAD (Azure Active Directory) or UserPassword | |
server | The url of your server | |
serverinstance | The name of the server instance running on your server (BC160 in my case) | |
startupObjectType | Specify the object type. This could be a page or table. In BC16 you also have the possibility to specify Report or Query. | |
startupObjectId | The object ID to start when you press [F5] |
An app.json looks like this by default:
{ "id": "45a1ebaf-28ba-4c4b-8b33-24a4df88f1f4", "name": "ALProject1", "publisher": "Default publisher", "version": "1.0.0.0", "brief": "", "description": "", "privacyStatement": "", "EULA": "", "help": "", "url": "", "logo": "", "dependencies": [ { "id": "63ca2fa4-4f03-4f2b-a480-172fef340d3f", "publisher": "Microsoft", "name": "System Application", "version": "16.0.0.0" }, { "id": "437dbf0e-84ff-417a-965d-ed2bb9650972", "publisher": "Microsoft", "name": "Base Application", "version": "16.0.0.0" } ], "screenshots": [], "platform": "16.0.0.0", "idRanges": [ { "from": 50100, "to": 50149 } ], "contextSensitiveHelpUrl": "https://ALProject1.com/help/", "showMyCode": true, "runtime": "5.0" }
Some app.json settings explained:
Setting | Description | |
name | The name of the app | |
publisher | The publisher of the app | |
platform | Version of the dependent platform. Version 16 is Business Central 2020 Wave 1. | |
runtime | The version of the runtime. At the moment of writing we have 5 major versions of the AL Runtime: 1.0 Business Central April 2018 release 2.0 Business Central October 2018 release CU 2 3.0 Business Central April 2019 release 4.0 Business Central 2019 release wave 2 (BC15) 5.0 Business Central 2020 release wave 1 (BC16) |
More detailed information about the JSON configuration file is available here on Microsoft Docs.