Ir al contenido

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.

0lecturas

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)»

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.

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.

  1. Identifikácia verzie servera: Môžeme skontrolovať skutočnú verziu vstupom na web Business Central -> Pomoc a podpora -> O.
  2. Uvoľnenie app.json: Otvoríme súbor app.json v našom lokálnom projekte.
  3. 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).
  4. Znižujeme motor vykonávania "runtime" na kompatibilnú verziu (napr. 13.0 alebo 16.0).
  5. Vymazanie cache: Fyzicky vymažeme obsah skrytej zložky .alpackages.
  6. 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”)»

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.

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á.

Musíme očistiť závislosti nášho projektu.

  1. Otvoríme app.json.
  2. Hľadáme pole "dependencies": [ ... ].
  3. 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.
  4. Vymazanie cache .alpackages a 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)»

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?"

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.

  1. File System: Visual Studio Code a Windows sú ľahostajné, či je cesta C:/Proyectos/Consulta_Datos alebo c:/proyectos/cOnSuLtAdAtOs.
  2. 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.

  • ✓ Čistenie: Preventívne vyčistenie zložky .alpackages pri vykonávaní štrukturálnych zmien v app.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.