Einführung in AL und die Umgebung
Vertiefte Grundlagen der Application Language (AL), die zugrunde liegende Architektur sowie die fortgeschrittene Konfiguration von VS Code und dem Tenant.
In unserer DevSecOps- und Data-Engineering-Kultur ist es unerlässlich, ERP-Systeme (wie Dynamics 365 Business Central) nicht länger als „Blackboxen“ oder einfache Weboberflächen zu behandeln. Um die maximale Leistung herauszuholen und das System auf Kernebene anzupassen, müssen wir auf die Quellcode-Ebene hinabsteigen und seine zugrundeliegende Architektur verstehen.
1. Was ist AL (Application Language)?
Sección titulada «1. ¿Qué es AL (Application Language)?»AL ist eine strukturierte, deklarative und stark typisierte Programmiersprache. Sie wurde exklusiv von Microsoft entwickelt, um die Geschäftslogik und das Datenmodell von Business Central zu erweitern (und ersetzt das alte C/AL).
Die Arbeit mit AL ähnelt stark der Arbeit mit Infrastruktur als Code (IaC) (wie Terraform oder Ansible). Wir ändern die Datenbank nicht, indem wir auf eine Schnittstelle klicken; wir definieren in Klartextdateien (.al), wie die Datenbank (Tabellen), die Logik (Codeunits), die Schnittstelle (Seiten) und die APIs (Abfragen) sein sollen.
Anschließend wird dieser Code in ein Paket oder eine Erweiterung (.app) kompiliert und auf dem Server bereitgestellt. Microsoft erlaubt es nicht, den Standard-Basiscode zu ändern; unsere gesamte Programmierung fungiert als eine „zusätzliche Schicht“ (Erweiterung), die an das ERP angekoppelt wird.
2. Zugrundeliegende Architektur (Der NST und SQL Server)
Sección titulada «2. Arquitectura Subyacente (El NST y SQL Server)»Um effizient zu programmieren, müssen wir verstehen, wie Business Central unsere Anweisungen verarbeitet:
- Datenschicht: Unterhalb davon befindet sich alles auf einem Microsoft SQL Server-Motor (in Azure SQL für Cloud-Umgebungen).
- Anwendungsschicht (NST): Der Navision Server Tier ist das „Gehirn“. Er übersetzt unseren AL-Code in SQL-Abfragen und rendert das HTML/JSON, das von Benutzern angezeigt wird oder von APIs verbraucht wird. Das Verständnis hierfür ist wichtig, um eine Überlastung des NST-Speichers zu vermeiden.
3. Vorbereitung der lokalen Entwicklungsumgebung
Sección titulada «3. Preparación del Entorno de Desarrollo Local»Wir entwickeln lokal, kompilieren aber gegen eine Sandbox-Umgebung in der Cloud. Dies ist unsere Basiskonfiguration:
3.1. Obligatorische Werkzeuge
Sección titulada «3.1. Herramientas Obligatorias»- Visual Studio Code (VS Code): Unsere integrierte Entwicklungsumgebung (IDE).
- „AL Language“-Erweiterung (Microsoft): Sie stellt den Compiler, die Autovervollständigung (IntelliSense), die Debugging-Tools und die Verbindung zum Tenant bereit.
- (Optional, empfohlen) „AL Object Designer“-Erweiterung: Ein sehr nützlicher visueller Explorer, um durch die Microsoft-Basistabellen zu navigieren und herauszufinden, wie die Standardfelder benannt sind.
3.2. Projektinitialisierung (Das „Scaffolding“)
Sección titulada «3.2. Inicialización del Proyecto (El “Scaffolding”)»Um ein neues Projekt zu erstellen, öffnen wir die Befehlspalette von VS Code (Ctrl + Shift + P) und führen AL: Go! aus. Der Assistent wird uns fragen:
- Einem lokalen Pfad zum Speichern des Projekts.
- Das Deployment-Ziel: Wir werden immer „Microsoft cloud sandbox“ wählen (NIEMALS Produktion für Entwicklungsphasen).
Dies erstellt die Grundstruktur, einschließlich des versteckten Ordners .vscode mit der Datei launch.json und der Root-Datei app.json.
4. Routing und Verbindung (launch.json)
Sección titulada «4. Enrutamiento y Conexión (launch.json)»Die Datei .vscode/launch.json ist unsere Nabelschnur zum Microsoft-Server. Eine fehlerhafte Konfiguration ist hier die Hauptursache für Verbindungs- und Deployment-Fehler.
Wir müssen sie mit höchster Präzision konfigurieren und generische Werte (wie default) vermeiden.
{ "version": "0.2.0", "configurations": [ { "name": "Conexión a Sandbox PORTELCORE", "request": "launch", "type": "al", "environmentType": "Sandbox", // 1. Nombre EXACTO del entorno (Sensible a mayúsculas y minúsculas) // Esto se obtiene del Admin Center de Business Central. "environmentName": "Sandbox-Dev", // 2. Tenant ID: Usar el GUID alfanumérico garantiza que evitamos fallos de DNS o redirección. "tenant": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d", // 3. Objeto de inicio: 22 es la lista de clientes. Cuando pulsemos F5, se abrirá esta pantalla. "startupObjectId": 22, "startupObjectType": "Page", "breakOnError": "Default", "launchBrowser": true, // 4. Parámetros de Telemetría y Debugging avanzados "enableLongRunningSqlStatements": true, "enableSqlInformationDebugger": true } ]}5. Metadaten- und Abhängigkeitsmanagement (app.json)
Sección titulada «5. Gestión de Metadata y Dependencias (app.json)»Die Datei app.json ist das Manifest unserer Erweiterung. Es definiert, wer wir sind, welche Version wir veröffentlichen und, was am wichtigsten ist, von was wir abhängig sind.
Im AL-Ökosystem können wir nicht kompilieren, wenn wir nicht zuvor die „Symbole“ (die vorkompilierten Bibliotheken des ERP) herunterladen. Die app.json teilt VS Code mit, welche genaue Version der Symbole es auf dem Server suchen muss.
{ "id": "56a4f575-efca-45f3-8a35-43c3ab4c9adf", "name": "Entradas_Salidas_AL", "publisher": "Portelcore DevSecOps", "version": "1.0.0.0", "brief": "Gestión optimizada de datos y extensiones.",
// Dependencias de otras apps. Si no usamos módulos raros, dejar vacío o con lo básico. "dependencies": [],
// EL PUNTO DE RUPTURA: La versión de "application" debe coincidir con la de nuestro Sandbox. // Si pedimos la 27.0 y el server tiene la 25.0, todo el proyecto fallará. "application": "25.0.0.0", "platform": "25.0.0.0", "runtime": "15.0", // Versión del motor de ejecución (NST).
"idRanges": [ { "from": 50100, "to": 50149 // Nuestro bloque de IDs reservados. } ]}6. Umgebungssynchronisation (Der Symbol-„Pull“)
Sección titulada «6. Sincronización del Entorno (El “Pull” de Símbolos)»Der letzte Schritt, bevor wir unsere erste Codezeile schreiben, ist die Synchronisation unseres VS Code mit der Cloud.
- Wir prüfen, ob unser versteckter Ordner
.alpackagesleer ist (oder erstellt wurde). - Wir führen den Befehl aus:
Ctrl + Shift + P->AL: Download Code(oderAL: Download Symbols). - Das System fordert uns zur Authentifizierung (Device Login) mittels eines Codes im Browser auf. Wir verwenden unsere Administrator-Anmeldedaten.
- Wenn die Dateien
launch.jsonundapp.jsonkorrekt sind, werden wir in der Konsole sehen, dass Pakete wieMicrosoft_Application.appheruntergeladen werden.
Unsere lokale Maschine kennt nun die gesamte Datenbankstruktur des ERPs. Wir sind bereit zum Programmieren.
7. Checkliste für Synchronisation und Validierung
Sección titulada «7. Checklist de Sincronización y Validación»- ✓ Konnektivität: Erfolgreicher Download von Symbolen in der VS-Code-Konsole (Exit-Code
0). - ✓ Version: Konsistenz der Richtlinie
runtimeundapplicationinapp.jsonmit der aktiven Version des NST. - ✓ Authentifizierung: Abgeschlossener Anmeldevorgang über Device Login mittels OAuth 2.0.

