Ir al contenido

Introductie tot AL en de omgeving

Diepgaande fundamenten van Application Language (AL), onderliggende architectuur en geavanceerde configuratie van VS Code en de tenant.

0lecturas

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.

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:

  1. Visual Studio Code (VS Code): Onze geïntegreerde ontwikkelomgeving (IDE).
  2. Extensie 'AL Language' (Microsoft): Biedt de compiler, de autocompletie (IntelliSense), de debugging-tools en de verbinding met de tenant.
  3. (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.

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.

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.
}
]
}

De laatste stap voordat we onze eerste regel code schrijven, is het synchroniseren van onze VS Code met de cloud.

  1. We controleren of onze verborgen map .alpackages leeg is (of is aangemaakt).
  2. We voeren het commando uit: Ctrl + Shift + P -> AL: Download Code (of AL: Download Symbols).
  3. Het systeem zal ons om authenticatie vragen (Device Login) via een code in de browser. We zullen onze beheerdersgegevens gebruiken.
  4. Als de bestanden launch.json en app.json correct zijn, zullen we in de console zien dat pakketten zoals Microsoft_Application.app worden 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 runtime en application in app.json met de actieve versie van de NST.
  • ✓ Authenticatie: Inlogproces voltooid via Device Login met behulp van OAuth 2.0.