Úvod do AL a prostředí
Hluboké základy Application Language (AL), podkladová architektura a pokročilá konfigurace VS Code a tenantu.
V naší kultuře DevSecOps a datového inženýrství je nezbytné přestat zacházet s ERP systémy (jako Dynamics 365 Business Central) jako s „černými skříňkami“ nebo jednoduchými webovými rozhraními. Abychom získali maximální výkon a přizpůsobili systém na základní úrovni, musíme sestoupit na úroveň zdrojového kódu a pochopit jeho základní architekturu.
1. Co je AL (Application Language)?
Sección titulada «1. ¿Qué es AL (Application Language)?»AL je strukturovaný, deklarativní a silně typovaný programovací jazyk. Byl navržen výhradně společností Microsoft k rozšíření obchodní logiky a datového modelu Business Central (nahrazuje starý C/AL).
Práce s AL je velmi podobná práci s infrastrukturou jako kód (IaC) (jako Terraform nebo Ansible). Databázi neupravujeme klikáním v rozhraní; v souborech s čistým textem (.al) definujeme, jak má databáze (tabulky), logika (codeunits), rozhraní (stránky) a API (dotazy) vypadat.
Následně se tento kód zkompiluje do balíčku nebo rozšíření (.app) a nasadí na server. Microsoft nepovoluje změnu svého standardního zdrojového kódu; veškeré naše programování funguje jako „dodatečná vrstva“ (rozšíření), která se připojuje k ERP.
2. Základní architektura (NST a SQL Server)
Sección titulada «2. Arquitectura Subyacente (El NST y SQL Server)»Abychom mohli efektivně programovat, musíme pochopit, jak Business Central zpracovává naše instrukce:
- Datová vrstva: Veškerá data jsou uložena v databázovém enginu Microsoft SQL Server (v Azure SQL pro cloudová prostředí).
- Aplikační vrstva (NST): Navision Server Tier je „mozkem“. Překládá náš kód AL do SQL dotazů a renderuje HTML/JSON, který uživatelé vidí nebo který konzumují API. Pochopení tohoto procesu je klíčové pro zamezení přetížení paměti NST.
3. Příprava lokálního vývojového prostředí
Sección titulada «3. Preparación del Entorno de Desarrollo Local»Vyvíjíme lokálně, ale kompilujeme proti cloudovému prostředí Sandbox. Toto je naše základní konfigurace:
3.1. Povinné nástroje
Sección titulada «3.1. Herramientas Obligatorias»- Visual Studio Code (VS Code): Naše integrované vývojové prostředí (IDE).
- Rozšíření „AL Language“ (Microsoft): Poskytuje kompilátor, automatické doplňování (IntelliSense), nástroje pro ladění a připojení k tenantovi.
- (Doporučené volitelné) Rozšíření „AL Object Designer“: Velmi užitečný vizuální průzkumník pro navigaci v základních tabulkách Microsoftu a zjišťování názvů standardních polí.
3.2. Inicializace projektu („Scaffolding“)
Sección titulada «3.2. Inicialización del Proyecto (El “Scaffolding”)»Pro vytvoření nového projektu otevřeme Paletu příkazů VS Code (Ctrl + Shift + P) a spustíme AL: Go!. Průvodce se nás zeptá:
- Lokální cestu pro uložení projektu.
- Cílové místo nasazení: Vždy zvolíme „Microsoft cloud sandbox“ (pro fáze vývoje NIKDY Production).
Toto vygeneruje základní strukturu, včetně skryté složky .vscode s souborem launch.json a kořenového souboru app.json.
4. Směrování a připojení (launch.json)
Sección titulada «4. Enrutamiento y Conexión (launch.json)»Soubor .vscode/launch.json je naší pupovou šňůrou k serveru Microsoft. Volná konfigurace zde je hlavním důvodem chyb připojení a nasazení.
Musíme jej nakonfigurovat s extrémní přesností a vyhýbat se obecným hodnotám (jako 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 metadat a závislostí (app.json)
Sección titulada «5. Gestión de Metadata y Dependencias (app.json)»Soubor app.json je manifestem naší rozšíření. Definuje, kdo jsme, jakou verzi vydáváme a co je nejdůležitější, na čem závisíme.
V ekosystému AL nemůžeme provést kompilaci, pokud si předem nestáhneme „Symboly“ (předkompilované knihovny ERP). app.json říká VS Code, jakou přesnou verzi symbolů má vyhledat na serveru.
{ "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. Synchronizace prostředí („Pull“ symbolů)
Sección titulada «6. Sincronización del Entorno (El “Pull” de Símbolos)»Posledním krokem před napsáním našeho prvního řádku kódu je synchronizace našeho VS Code s cloudem.
- Ověříme, zda je naše skrytá složka
.alpackagesprázdná (nebo zda byla vytvořena). - Spustíme příkaz:
Ctrl + Shift + P->AL: Download Code(neboAL: Download Symbols). - Systém nás požádá o ověření (Device Login) pomocí kódu v prohlížeči. Použijeme naše administrátorské přihlašovací údaje.
- Pokud jsou soubory
launch.jsonaapp.jsonsprávné, uvidíme v konzoli stahování balíčků jakoMicrosoft_Application.app.
Náš lokální počítač nyní zná celou strukturu databáze ERP. Jsme připraveni programovat.
7. Kontrolní seznam synchronizace a validace
Sección titulada «7. Checklist de Sincronización y Validación»- ✓ Konektivita: Úspěšné stažení symbolů v konzoli VS Code (výstupní kód
0). - ✓ Verze: Soulad direktivy
runtimeaapplicationvapp.jsons aktivní verzí NST. - ✓ Autentizace: Přihlašovací tok dokončen přes Device Login pomocí OAuth 2.0.

