Introductie tot AL en de omgeving
Diepgaande fundamenten van Application Language (AL), onderliggende architectuur en geavanceerde configuratie van VS Code en de tenant.
In onze DevSecOps- en Data Engineering-cultuur is het noodzakelijk om ERP-systemen (zoals Dynamics 365 Business Central) niet langer te behandelen als "black boxes" of eenvoudige webinterfaces. Om de maximale prestaties eruit te halen en het systeem op kernniveau aan te passen, moeten we afdalen naar het niveau van de broncode en de onderliggende architectuur begrijpen.
1. Wat is AL (Application Language)?
Sección titulada «1. ¿Qué es AL (Application Language)?»AL is een gestructureerde, declaratieve en sterk getypeerde programmeertaal. Het is exclusief door Microsoft ontworpen om de bedrijfslogica en het datamodel van Business Central uit te breiden (ter vervanging van het oude C/AL).
Werken met AL lijkt erg op werken met Infrastructure as Code (IaC) (zoals Terraform of Ansible). We wijzigen de database niet door op een interface te klikken; we definiëren in platte tekstbestanden (.al) hoe de database (tabellen), de logica (codeunits), de interface (pagina's) en de API's (queries) eruit moeten zien.
Vervolgens wordt deze code gecompileerd in een pakket of extensie (.app) en op de server uitgerold. Microsoft staat het niet toe om hun standaard basiscode aan te passen; al onze programmering fungeert als een 'extra laag' (extensie) die wordt gekoppeld aan de ERP.
2. Onderliggende architectuur (De NST en SQL Server)
Sección titulada «2. Arquitectura Subyacente (El NST y SQL Server)»Om efficiënt te programmeren, moeten we begrijpen hoe Business Central onze instructies verwerkt:
- Datalaag: Onder de motorkap bevindt alles zich in een Microsoft SQL Server-engine (in Azure SQL voor cloudomgevingen).
- Applicatielaag (NST): De Navision Server Tier is het 'brein'. Het vertaalt onze AL-code naar SQL-queries en rendert de HTML/JSON die gebruikers zien of die door API's wordt geconsumeerd. Het begrijpen hiervan is essentieel om het geheugen van de NST niet te overbelasten.
3. Voorbereiding van de lokale ontwikkelomgeving
Sección titulada «3. Preparación del Entorno de Desarrollo Local»We ontwikkelen lokaal, maar compileren tegen een Sandbox-omgeving in de cloud. Dit is onze basisconfiguratie:
3.1. Verplichte tools
Sección titulada «3.1. Herramientas Obligatorias»- Visual Studio Code (VS Code): Onze geïntegreerde ontwikkelomgeving (IDE).
- Extensie 'AL Language' (Microsoft): Biedt de compiler, de autocompletie (IntelliSense), de debugging-tools en de verbinding met de tenant.
- (Aanbevolen optioneel) Extensie 'AL Object Designer': Een zeer handige visuele verkenner om door de Microsoft-basistabellen te navigeren en te ontdekken hoe de standaardvelden worden genoemd.
3.2. Projectinitialisatie (De "Scaffolding")
Sección titulada «3.2. Inicialización del Proyecto (El “Scaffolding”)»Om een nieuw project te maken, openen we de Command Palette van VS Code (Ctrl + Shift + P) en voeren we AL: Go! uit. De assistent zal ons vragen:
- Een lokaal pad om het project op te slaan.
- De doelbestemming voor de deployment: We kiezen altijd “Microsoft cloud sandbox” (NOOIT Productie voor ontwikkelingsfasen).
Dit genereert de basisstructuur, inclusief de verborgen map .vscode met het bestand launch.json, en het rootbestand app.json.
4. Routing en verbinding (launch.json)
Sección titulada «4. Enrutamiento y Conexión (launch.json)»Het bestand .vscode/launch.json is onze navelstreng met de Microsoft-server. Een te ruime configuratie hier is de belangrijkste oorzaak van verbindings- en deploymentfouten.
We moeten dit met uiterste precisie configureren en generieke waarden (zoals default) vermijden.
{ "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. Beheer van metadata en afhankelijkheden (app.json)
Sección titulada «5. Gestión de Metadata y Dependencias (app.json)»Het bestand app.json is het manifest van onze extensie. Het definieert wie we zijn, welke versie we publiceren en, het meest kritieke punt, waar we van afhankelijk zijn.
In het AL-ecosysteem kunnen we niet compileren zonder eerst de 'Symbolen' (de vooraf gecompileerde bibliotheken van de ERP) te downloaden. De app.json vertelt VS Code welke exacte versie van de symbolen het van de server moet ophalen.
{ "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. Omgevingssynchronisatie (De "Pull" van symbolen)
Sección titulada «6. Sincronización del Entorno (El “Pull” de Símbolos)»De laatste stap voordat we onze eerste regel code schrijven, is het synchroniseren van onze VS Code met de cloud.
- We controleren of onze verborgen map
.alpackagesleeg is (of is aangemaakt). - We voeren het commando uit:
Ctrl + Shift + P->AL: Download Code(ofAL: Download Symbols). - Het systeem zal ons om authenticatie vragen (Device Login) via een code in de browser. We zullen onze beheerdersgegevens gebruiken.
- Als de bestanden
launch.jsonenapp.jsoncorrect zijn, zullen we in de console zien dat pakketten zoalsMicrosoft_Application.appworden gedownload.
Onze lokale machine kent nu de volledige databasestructuur van het ERP. We zijn klaar om te programmeren.
7. Checklist voor Synchronisatie en Validatie
Sección titulada «7. Checklist de Sincronización y Validación»- ✓ Connectiviteit: Succesvolle download van symbolen in de VS Code-console (exitcode
0). - ✓ Versie: Consistentie van de directive
runtimeenapplicationinapp.jsonmet de actieve versie van de NST. - ✓ Authenticatie: Inlogproces voltooid via Device Login met behulp van OAuth 2.0.

