Riešenie problémov vo vývoji AL
Sprievodca riešením bežných chýb nasadenia, závislostí a sťahovania symbolov v prostrediach Business Central.
V našej prevádzke DevSecOps väčšina blokád nie sú spôsobené chybami logiky v našom kóde, ale chybami konfigurácie prostredia, nesprávnymi verziami alebo problémami komunikácie siete medzi našim lokálnym IDE (VS Code) a prenajatým cloudom.
Toto je naša znalostná báza na okamžité riešenie incidentov zaznamenaných počas fáz vývoja a integrácie.
Incident 1: Chyba 404 Not Found (Stiahnutie symbolov)
Sección titulada «Incidente 1: Error 404 Not Found (Descarga de Símbolos)»Symptóm
Sección titulada «Síntoma»Pri spustení príkazu AL: Download Symbols (alebo pri pokuse o zostavenie pomocou F5) terminál (Výstup -> AL) vráti masívne bloky chýb podobné týmto:
[2026-03-24 10:15:23] Sending request to https://api.businesscentral.../v2.0/sandbox/dev/packages?publisher=Microsoft&appName=Application&versionText=27.4.45366[2026-03-24 10:15:24] Error: Not Found[2026-03-24 10:15:24] The request for path ... failed with code NotFound.error AL1022: A package with publisher 'Microsoft', name 'Application', and a version compatible with '27.4.45366' could not be found.Koreňová diagnostika (Citlivosť na verzie)
Sección titulada «Diagnóstico Raíz (Sensibilidad de Versiones)»Toto je chyba synchronizácie verzií v manifeste. Business Central je veľmi prísny (version-sensitive). Chyba naznačuje, že náš lokálny súbor app.json vyžaduje od servera, aby nám poslal základné knižnice vo verzii 27.4.45366. Avšak Sandbox, na ktorý sa zameriavame (konfigurovaný v launch.json), má nainštalovanú staršiu verziu (napríklad 25.0.0.0). Pretože server nemá verziu, ktorú vyžadujeme, vracia 404.
Riešenie krok za krokom
Sección titulada «Resolución Paso a Paso»- Identifikácia verzie servera: Môžeme skontrolovať skutočnú verziu vstupom na web Business Central -> Pomoc a podpora -> O.
- Uvoľnenie
app.json: Otvoríme súborapp.jsonv našom lokálnom projekte. - Znižujeme minimálnu požadovanú verziu. Upravujeme
"application"a"platform"na verziu, ktorá je bezpečná a univerzálna (napr.25.0.0.0). - Znižujeme motor vykonávania
"runtime"na kompatibilnú verziu (napr.13.0alebo16.0). - Vymazanie cache: Fyzicky vymažeme obsah skrytej zložky
.alpackages. - Opakovaný pokus: Opätovne vykonáme
AL: Download Symbols. Terminál by mal zobraziťAll reference symbols have been downloaded.
Incident 2: Chyba z dôvodu fiktívnych závislostí („API Reports“)
Sección titulada «Incidente 2: Error por Dependencias Fantasma (“API Reports”)»Symptóm
Sección titulada «Síntoma»Pri pokuse o stiahnutie symbolov alebo kompiláciu systém indikuje, že chýba špecifická závislosť, ktorú nemôžeme nájsť, napríklad: A package with publisher 'Microsoft', name 'API Reports - Finance', could not be found.
Koreňová diagnostika
Sección titulada «Diagnóstico Raíz»VS Code pri inicializácii projektov pomocou AL: Go! niekedy injektuje závislosti veľmi špecifických modulov (ako sú finančné moduly) do bloku "dependencies" app.json. Ak náš Sandbox server nemá nainštalovanú konkrétnu aplikáciu od Microsoftu, globálne balenie zlyhá.
Riešenie
Sección titulada «Resolución»Musíme očistiť závislosti nášho projektu.
- Otvoríme
app.json. - Hľadáme pole
"dependencies": [ ... ]. - Ak vyvíjame generické integrácie alebo jednoduché API, úplne odstránime bloky cudzích závislostí (ako
API Reports - Finance), pričom pole necháme prázdne[]alebo ponecháme len kritické závislosti našej vlastnej spoločnosti. - Vymazanie cache
.alpackagesa opätovné stiahnutie symbolov.
Incident 3: Mýtus o priečinkoch a názvoslaví (CamelCase vs Snake_case)
Sección titulada «Incidente 3: Mito de las Carpetas y Nomenclatura (CamelCase vs Snake_case)»Častá otázka/úvaha
Sección titulada «Consulta/Duda Frecuente»Otázka tímu: „Zlyhá kompilátor AL, ak zložky koreňa projektu na mojom pevnom disku (napr. Consulta_Datos_Comercial) nie sú napísané v camelSensitive / CamelCase?"
Aclaración Técnica DevSecOps
Sección titulada «Aclaración Técnica DevSecOps»Odpoveď je NE. Kompilátor AL nemá citlivosť na veľké písmená alebo formáty v názvoch fyzických zložiek systému Windows.
- File System: Visual Studio Code a Windows sú ľahostajné, či je cesta
C:/Proyectos/Consulta_Datosaleboc:/proyectos/cOnSuLtAdAtOs. - Chovanie kompilátora: Keď spustíme príkaz na kompiláciu, motor zabalí obsah výlučne na základe metadát uvedených v
app.json(vlastnosti"name"a"publisher"). Názov vášho lokálneho adresára je pre cloud server ignorovaný a irelevantný.
Doporučenie pre názvoslovie: Používame konvenciu Snake_Case (podčiarkovacie čiary) v adresároch (Entradas_Salidas_AL) výlučne pre čitateľnosť človeka a vizuálny poriadok v našich Git repozitároch, nie kvôli technickým obmedzeniam kompilátora.
4. Criterios de Éxito de Triage
Sección titulada «4. Criterios de Éxito de Triage»- ✓ Čistenie: Preventívne vyčistenie zložky
.alpackagespri vykonávaní štrukturálnych zmien vapp.json. - ✓ Validácia: Absolútna koherencia v súbore závislostí deklarovaných v manifeste s nainštalovanými rozšíreniami v cloude.
- ✓ Sledovanie: Monitorovanie výstupného kanála „AL Language“ z VS Code pre presnú diagnostiku chýb siete.

