Skip to main content

VS Code

VS Code Installation

Die aktuellste Version von Visual Studio Code hier herunterladen und anschließend installieren.

Benötigte und nützliche Extensions für VS Code

AL Language

Nach dem ersten Start von Visual Studio Code ist es notwendig, die AL Language Erweiterung zu installieren. Dazu bitte die folgenden Schritte in VC Code ausführen:

  1. Extension Menü öffnen
  2. Nach "AL Language" suchen
  3. Und das entsprechende Paket installieren

image-1633933338554.png

AL Object Designer und AL Dev Tools

Weitere, praktische Erweiterungen sind z.B. der AL Object Designer von Márton Sági und die AL Dev Tools von Andrzej Zwierzchowski. 

image-1633933945695.png

AL Object Designer

Mit dieser Erweiterung lassen sich, unter anderem, alle Objekte des Projektes auflisten und der entsprechende Code einsehen.

image-1633934535479.png

AL Dev Tools

Diese Erweiterung bietet, unter anderem, verschiedene Wizards und andere praktische Tools.

Erstellen und veröffentlichen einer ersten App aus VS Code heraus

Im Folgenden wird die Erstellung eines neuen Beispielprojektes in Visual Studio Code beschrieben sowie die Veröffentlichung der daraus resultierenden BC App gezeigt. Wir benutzen hierfür die aktuellste BC Version (Runtime Version 8, bzw. Anwendungsversion 19).

Projektinitialisierung

In VS Code F1 oder STRG+Shift+P drücken, um die Befehlszeile zu öffnen. Anschließend das Kommando AL: Go! ausführen.

image-1633938331635.png

Daraufhin wird der Pfad zu einem leeren Verzeichnis benötigt. Der Ordner (hier: ExampleAppBC19) muss im Vorfeld nicht erstellt werden.

image-1633938516012.png

Damit VS Code die Konfigurationsdatei app.json mit den korrekten Parametern erstellt, muss nun die Business Central Version ausgewählt werden, für die eine App entwickelt werden soll. In diesem Fall ist es die Version 8.0 (Runtime), bzw. Anwendungsversion 19.0.0.0.

image-1633939377386.png

Die launch.json, also die Konfigurationsdatei mit den Startparametern für die Veröffentlichung der App aus Visual Studio heraus, wird im nächsten Schritt entsprechend der Auswahl des Servers erstellt. In diesem Fall wird mit einem On-Prem Server gearbeitet (in Docker). 

image-1633939945601.png

Sofern noch eine Aufforderung zur Eingabe von Benutzername und Passwort folgt, kann diese mit ESC abgebrochen werden.

Download von Symbolen

Visual Studio Code benötigt nun noch Informationen zu den Objekten und Extensions, die in der BC Instanz existieren. Damit der Download der sogenannten Symbole möglich ist, müssen die Verbindungsdaten in der Projektdatei launch.json entsprechend der Konfiguration in Docker angepasst werden:

image-1633940941646.png

Anschließend in der Befehlszeile (F1) AL: Download symbols ausführen.

image-1633941374340.png

Wenn im Anschluss image-1633941487094.png angezeigt wird, hat alles geklappt. VS Code hat nun auch einen neuen Ordner mit Packages erstellt:

image-1633941599275.png

Je nachdem, wie die App später in BC bzw. im Store angezeigt werden soll, können nun noch Anpassungen an der app.json vorgenommen werden. Darüber hinaus kann hier festgelegt werden, für welches Ziel (Cloud oder On-Prem) entwickelt werden soll - dazu wird der Parameter target entsprechend gefüllt (hier: Cloud).

image-1633942262209.png

Veröffentlichung via VS Code

VS Code hat bereits eine HelloWorld.al Datei erstellt. Die Datei kann einfach gelöscht werden. Stattdessen bietet es sich an, eine neue, den best practices von Microsoft entsprechende, Datei zu erstellen. In diesem Fall eine Extension der Page "Customer List". Die Bezeichnung der Datei ist dann CustomerListExt.PageExt.al. Sinnvoll ist auch die Benutzung von Unterordnern (z.B. src, pages, pageextension etc.) - in diesem Beispiel nicht der Fall.

Back to top