Introduc
Hlboké základy aplikačného jazyka (AL), základnej architektúry a pokročilej konfigurácie VS Code a nájmu.
V našej kultúre DevSecOps a dátovej inžinierskej je nevyhnutné prestať zaobchádzať so systémami ERP (ako je Dynamics 365 Business Central) ako s „čiernymi skrinkami“ alebo jednoduchými webovými rozhraniami. Aby sme získali maximálny výkon a prispôsobili systém na úrovni jadra, musíme sa dostať na úroveň zdrojového kódu a pochopiť jeho základnú architektúru.
1. Čo je AL (Application Language)?
Sección titulada «1. ¿Qué es AL (Application Language)?»AL je štruktúrovaný, deklaratívny a silne typovaný programovací jazyk. Bol navrhnutý výlučne spoločnosťou Microsoft pre rozšírenie obchodnej logiky a modelu dát Business Central (nahrádzajúci starý C/AL).
Práca s AL je veľmi podobná práci s Infraštruktúrou ako kód (IaC) (ako Terraform alebo Ansible). My nemodifikujeme databázu kliknutím na rozhranie; my definujeme v obyčajných textových súboroch (.al) ako chceme, aby bola databáza (tabuľky), logika (codeunits), rozhranie (stránky) a API (dotazy).
Následne sa tento kód skompiluje do balíka alebo rozšírenia (.app) a nasadí na server. Spoločnosť Microsoft nedovolí meniť svoj štandardný základný kód; náš celý program pôsobí ako "dodatočná vrstva" (rozšírenie), ktorá sa pripája k ERP.
2. Základná architektúra (NST a SQL Server)
Sección titulada «2. Arquitectura Subyacente (El NST y SQL Server)»Pre efektívne programovanie musíme pochopiť, ako Business Central spracováva naše inštrukcie:
- Dátová vrstva: Všetko pod týmto leží v motore Microsoft SQL Server (v Azure SQL pre cloudové prostredia).
- Aplikačná vrstva (NST): Navision Server Tier je "mozog". Prekladá náš kód AL na dotazy SQL a vykresľuje HTML/JSON, ktoré vidia používatelia alebo spotrebúvajú API. Pochopenie toho je životne dôležité pre predchádzanie preťaženiu pamäte NST.
3. Príprava lokálneho vývojového prostredia
Sección titulada «3. Preparación del Entorno de Desarrollo Local»Vyvíjame lokálne, ale kompilujeme proti sandboxu v cloude. Toto je naša základná konfigurácia:
3.1. Povinné nástroje
Sección titulada «3.1. Herramientas Obligatorias»- Visual Studio Code (VS Code): Naše integrované vývojové prostredie (IDE).
- Rozšírenie "AL Language" (Microsoft): Poskytuje kompilátor, automatické dokončovanie (IntelliSense), nástroje na ladenie a pripojenie k tenantovi.
- (Voliteľné, odporúčané) Rozšírenie "AL Object Designer": Veľmi užitočný vizuálny prehliadač pre prechádzanie základnými tabuľkami spoločnosti Microsoft a zisťovanie názvov štandardných polí.
3.2. Inicializácia projektu (Scaffolding)
Sección titulada «3.2. Inicialización del Proyecto (El “Scaffolding”)»Ak chcete vytvoriť nový projekt, otvorte paletu príkazov VS Code (Ctrl + Shift + P) a spustite AL: Go!. Asistent vás požiada:
- Lokálnu cestu pre uloženie projektu.
- Cieľ nasadenia: Vždy si vyberieme "Microsoft cloud sandbox" (NIKDY nie Production pre vývojové fázy).
Toto vygeneruje základnú štruktúru, vrátane skrytého priečinka .vscode so súborom launch.json a koreňového súboru app.json.
4. smerovanie a pripojenie (launch.json)
Sección titulada «4. Enrutamiento y Conexión (launch.json)»Súbor .vscode/launch.json je naše spojenie so serverom spoločnosti Microsoft. Laxná konfigurácia tu je hlavnou príčinou chýb pripojenia a nasadenia.
Musíme ho nakonfigurovať s extrémnou presnosťou, čím sa vyhnete generickým hodnotám (ako 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. Správa metadát a závislostí (app.json)
Sección titulada «5. Gestión de Metadata y Dependencias (app.json)»Súbor app.json je manifestom našej rozšírenia. Definuje, kto sme, akú verziu publikujeme a čo je najdôležitejšie, od čoho závisíme.
V ekosystéme AL nemôžeme kompilovať, ak si predtým nestiahneme "symboly" (predkompilované knižnice ERP). app.json povie VS Code, ktorú presnú verziu symbolov má ísť vyhľadať na 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. Synchronizácia prostredia (Pull symbolov)
Sección titulada «6. Sincronización del Entorno (El “Pull” de Símbolos)»Posledným krokom pred napísaním nášho prvého riadku kódu je synchronizácia nášho VS Code s cloudom.
- Overíme, či je náš skrytý priečinok
.alpackagesprázdny (alebo vytvorený). - Spustíme príkaz:
Ctrl + Shift + P->AL: Download Code(aleboAL: Download Symbols). - Systém nás požiada o autentifikáciu (Device Login) pomocou kódu v prehliadači. Použijeme naše administrátorské prihlasovacie údaje.
- Ak sú súbory
launch.jsonaapp.jsonsprávne, vidíme v konzole, že sa sťahujú balíky akoMicrosoft_Application.app.
Naša lokálna машина teraz pozná celú štruktúru databáze ERP. Sme pripravení programovať.
7. Kontrolný zoznam synchronizácie a validácie
Sección titulada «7. Checklist de Sincronización y Validación»- ✓ Konektivita: Úspešné stiahnutie symbolov do konzoly VS Code (vstupný kód
0). - ✓ Verzia: Konzistencia direktívy
runtimeaapplicationvapp.jsons aktívnou verziou NST. - ✓ Autentifikácia: Dokončený tok prihlásenia prostredníctvom Device Login pomocou OAuth 2.0.

