Note: Because the System Application is part of Business Central 2019 release wave 2 it isn’t yet publicly available. To get access you’ll need to join the ReadyToGo program so that you can use Microsoft Collaborate and our insider builds.
- Get the latest Docker image.
- Prepare the environment for code customization.
- Publish and install a new version of System Application.
- Share your great work with others.
Get the latest Docker image
Start by pulling the latest Docker image (current walkthrough based on build 15.0.34197). To do that, run the following command.
docker pull bcprivate.azurecr.io/bcsandbox-master:base-ltsc2019
$credential = New-Object System.Management.Automation.PSCredential -argumentList "admin", (ConvertTo-SecureString -String "P@ssword1" -AsPlainText -Force) $imageName = "bcprivate.azurecr.io/bcsandbox-master:base-ltsc2019" $licensePath = "C:\..\l.flf" #put actual path to your license $containerName = "BC" New-BCContainer -accept_eula ` -updateHosts ` -containerName $containerName ` -auth NavUserPassword -Credential $credential ` -imageName $imageName ` -licenseFile $licensePath ` -doNotExportObjectsToText ` -includeAL ` -useCleanDatabase ` -memoryLimit 16g `
UnPublish-NavContainerApp -containerName $containerName ` -appName "System Application" ` -unInstall ` -doNotSaveData
Prepare the environment for code customization
Note: We need the latest version of the AL extension for VS Code. The PowerShell output contains the link to the .vsix file, so we can download it from the container.
Note: The project folder should be in a location that is shared with the container. For example, a folder in C:\ProgramData\NavContainerHelper will work.
- In GitHub, choose the Clone or Download button, and then Download ZIP.
- Open the downloaded archive and copy the content of the \ALAppExtensions-master\Modules\System folder to our AL project.
Publish and install your System Application
Publish-NavContainerApp -containerName $containerName ` -appFile "C:\ProgramData\NavContainerHelper\AL\DemoSolution\Microsoft_System Application_18.104.22.168.app" ` -skipVerification ` -sync ` -syncMode ForceSync ` -install
We’ll repeat the UnPublish-NavContainerApp, modify AL, and Publish-NavContainerApp steps until we’re happy with the results.
Share your improvement
The System Application is a work in progress, and new modules will be added in the future. If you want to peek at the latest, you can always go to the GitHub repository https://github.com/Microsoft/alappextensions. While you’re there, if you see something you think we’ve missed, you can submit a pull request and we might add it. Additionally, if you think we’ve left out a module, you can submit an idea on https://aka.ms/bcideas.
We're always looking for feedback and would like to hear from you. Please head to the Dynamics 365 Community to start a discussion, ask questions, and tell us what you think!