Übung – Die Entwicklungsumgebung einrichten
Szenario
Sie benötigen einen Dynamics 365 Business Central-Mandant, Visual Studio Code und die AL-Spracherweiterung, um mit dem Schreiben von Erweiterungen für Business Central zu beginnen. Visual Studio Code ist ein plattformübergreifender Editor, den Sie zum Codieren und Debuggen verwenden.
Eine Sandboxumgebung einrichten
Führen Sie die folgenden Schritte aus, um eine Sandboxumgebung einzurichten:
Zu einer Sandbox vonDynamics 365 Business Central anmelden.
Folgen Sie dem Registrierungsprozess, und warten Sie, bis die Business Central-Umgebung bereit ist.
Öffnen Sie das Admin Center, indem Sie das Admin Center mit dem Menü Einstellungen verbinden, wenn Sie bei Business Central angemeldet sind.
Wählen Sie auf der Registerkarte Umgebungen im Business Central Admin Center im Aktionsmenüband die Aktion Neu aus.
Geben Sie im Abschnitt Umgebung erstellen einen Namen für die neue Umgebung an, beispielsweise Sandbox.
Wählen Sie Sandbox in der Liste Umgebungstyp aus.
Wählen Sie in der Liste Land das Land für die Umgebung aus. Das angegebene Land bestimmt die Lokalisierung für die Umgebung und die Azure-Region, in der die Umgebung erstellt und gespeichert wird.
Geben Sie in der Liste Version die relevante Anwendungsversion für die neue Umgebung an, wenn mehr als eine Version verfügbar ist.
Wählen Sie die Aktion Erstellen aus.
Die neue Umgebung ist erst verfügbar, wenn der Status als Aktiv angezeigt wird.
Wenn die neue Sandbox-Umgebung bereit ist, öffnen Sie sie.
Führen Sie die folgenden Schritte aus, um eine Entwicklungsumgebung einzurichten:
Laden SieVisual Studio Code herunter.
Die AL Language-Erweiterung herunterladen.
Um eine neue App zu erstellen, führen Sie die folgenden Schritte aus:
Drücken Sie die Alt+A, Alt+L Tastenkombinationen zum Auslösen des Befehls AL Go! aus, und wählen Sie dann einen Pfad zu einem neuen leeren Ordner und die auszuführende Version aus.
CustomerRewards für das Projekt als Namen verwenden
Wählen Sie als Server Microsoft Cloud Sandbox aus.
Geben Sie die Anmeldeinformationen ein, die Sie bei der Anmeldung angegeben haben.
Das System lädt jetzt Symbole herunter.
Wenn Fehler auftreten, aktualisieren Sie Ihre launch.json-Datei und stellen Sie sicher, dass das Parameter Umgebungsname genau mit dem Namen Ihrer Sandbox übereinstimmt, und laden Sie dann die Symbole erneut herunter.
- Es gibt in einem AL-Projekt zwei JSON-Dateien; die App.json-Datei und die launch.json-Datei, die automatisch generiert werden, wenn Sie ein neues Projekt starten. Die Datei „app.json“ enthält Informationen zu der Erweiterung, die Sie erstellen, z. B. Herausgeberinformationen, Name und die minimal unterstützte Version von Basisanwendungsobjekten, auf denen die Erweiterung erstellt wurde. Oft wird die Datei „app.json“ als das Manifest bezeichnet. Die Datei launch.json umfasst Informationen über den Server, auf dem die Erweiterung gestartet wird.
Drücken Sie die Taste F5 oder Ctrl+F5, um die Erweiterung auf Ihrem Online-Sandbox-Mandanten bereitzustellen und auszuführen.
Sie haben jetzt ein HelloWorld-Beispiel, das kompiliert und ausgeführt wird.
In einer Erweiterung sollten die .al-Dateien in einem Ordner mit dem Namen src gespeichert werden. Aus diesem Grund entfernen wir zuerst die HelloWorld.al-Datei und erstellen den src-Ordner.
Führen Sie die folgenden Schritte aus, um die Ordner vorzubereiten:
Die Datei „HelloWorld.al“ entfernen
Erstellen Sie eine neue Datei mit dem Namen: src