Introduzione ad AL e all'ambiente
Fondamenti approfonditi di Application Language (AL), architettura sottostante e configurazione avanzata di VS Code e del tenant.
Nella nostra cultura DevSecOps e di Ingegneria dei Dati, è imperativo smettere di trattare i sistemi ERP (come Dynamics 365 Business Central) come “scatole nere” o semplici interfacce web. Per estrarre le massime prestazioni e personalizzare il sistema a livello core, dobbiamo scendere al livello del codice sorgente e comprendere la sua architettura sottostante.
1. Cos'è AL (Application Language)?
Sección titulada «1. ¿Qué es AL (Application Language)?»AL è un linguaggio di programmazione strutturato, dichiarativo e fortemente tipizzato. È stato progettato esclusivamente da Microsoft per estendere la logica di business e il modello di dati di Business Central (sostituendo il vecchio C/AL).
Lavorare con AL è molto simile a lavorare con Infrastruttura come Codice (IaC) (come Terraform o Ansible). Non modifichiamo il database cliccando su un'interfaccia; definiamo in file di testo semplice (.al) come vogliamo che sia il database (Tabelle), la logica (Codeunit), l'interfaccia (Pagine) e le API (Query).
Successivamente, questo codice viene compilato in un pacchetto o estensione (.app) e distribuito sul server. Microsoft non consente di alterare il proprio codice base standard; tutta la nostra programmazione agisce come uno “strato aggiuntivo” (Estensione) che si accoppia all'ERP.
2. Architettura Sottostante (L'NST e SQL Server)
Sección titulada «2. Arquitectura Subyacente (El NST y SQL Server)»Per programmare con efficienza, dobbiamo capire come Business Central elabora le nostre istruzioni:
- Strato di Dati: Sotto, tutto risiede in un motore Microsoft SQL Server (in Azure SQL per ambienti Cloud).
- Strato di Applicazione (NST): Il Navision Server Tier è il “cervello”. Traducono il nostro codice AL in query SQL e renderizzano l'HTML/JSON che vedono gli utenti o consumano le API. Capire questo è vitale per evitare di sovraccaricare la memoria del NST.
3. Preparazione dell'Ambiente di Sviluppo Locale
Sección titulada «3. Preparación del Entorno de Desarrollo Local»Sviluppiamo in locale, ma compiliamo contro un ambiente Sandbox nel cloud. Questa è la nostra configurazione base:
3.1. Strumenti Obbligatori
Sección titulada «3.1. Herramientas Obligatorias»- Visual Studio Code (VS Code): Il nostro ambiente di sviluppo integrato (IDE).
- Estensione “AL Language” (Microsoft): Fornisce il compilatore, l'autocompletamento (IntelliSense), gli strumenti di debugging e la connessione al tenant.
- (Opzionale consigliato) Estensione “AL Object Designer”: Un esploratore visuale molto utile per navigare tra le tabelle base di Microsoft e scoprire come si chiamano i campi standard.
3.2. Inizializzazione del Progetto (Lo “Scaffolding”)
Sección titulada «3.2. Inicialización del Proyecto (El “Scaffolding”)»Per creare un nuovo progetto, apriamo la Palette dei comandi di VS Code (Ctrl + Shift + P) ed eseguiamo AL: Go!. L'assistente ci chiederà:
- Un percorso locale per salvare il progetto.
- La destinazione del deployment: sceglieremo sempre “Microsoft cloud sandbox” (MAI Production per le fasi di sviluppo).
Questo genererà la struttura di base, inclusa la cartella nascosta .vscode con il file launch.json, e il file root app.json.
4. Routing e Connessione (launch.json)
Sección titulada «4. Enrutamiento y Conexión (launch.json)»Il file .vscode/launch.json è il nostro cordone ombelicale con il server Microsoft. Una configurazione permissiva qui è la causa principale di errori di connessione e di deployment.
Dobbiamo configurarlo con estrema precisione, evitando i valori generici (come default).
{ "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. Gestione dei metadati e delle dipendenze (app.json)
Sección titulada «5. Gestión de Metadata y Dependencias (app.json)»Il file app.json è il manifesto della nostra estensione. Definisce chi siamo, quale versione stiamo pubblicando e, cosa più critica, da cosa dipendiamo.
Nell'ecosistema AL, non possiamo compilare se non scarichiamo preventivamente i “Simboli” (le librerie precompilate dell'ERP). Il app.json dice a VS Code quale versione esatta dei simboli deve cercare sul server.
{ "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. Sincronizzazione dell'Ambiente (Il “Pull” dei Simboli)
Sección titulada «6. Sincronización del Entorno (El “Pull” de Símbolos)»Il passaggio finale prima di scrivere la nostra prima riga di codice è sincronizzare il nostro VS Code con il cloud.
- Verifichiamo che la nostra cartella nascosta
.alpackagessia vuota (o creata). - Lanzamos il comando:
Ctrl + Shift + P->AL: Download Code(oAL: Download Symbols). - Il sistema ci chiederà l'autenticazione (Device Login) tramite un codice nel browser. Useremo le nostre credenziali di amministratore.
- Se i file
launch.jsoneapp.jsonsono corretti, vedremo nella console che vengono scaricati pacchetti comeMicrosoft_Application.app.
La nostra macchina locale ora conosce l'intera struttura del database dell'ERP. Siamo pronti per programmare.
7. Checklist di Sincronizzazione e Validazione
Sección titulada «7. Checklist de Sincronización y Validación»- ✓ Connettività: Scaricamento riuscito di simboli nella console di VS Code (codice di uscita
0). - ✓ Versione: Coerenza della direttiva
runtimeeapplicationinapp.jsoncon la versione attiva del NST. - ✓ Autenticazione: Flusso di inizio di sessione completato tramite Device Login mediante OAuth 2.0.

