Ir al contenido

Riešenie problémov s API a údajmi

Protokoly reakcie na zlyhania hromadného extrahovania, latenciu siete OData a architektonické obmedzenia v Business Central.

0lecturas

V našej práci DevSecOps zabezpečujúcej integritu dátových kanálov (Data Pipelines) môže integrácia medzi Business Central a platformami Business Intelligence predstavovať úzke miesta a sieťové prekážky.

Tento dokument podrobne popisuje základné príčiny najzávažnejších zlyhaní a ich definitívne riešenia založené na implementovanej architektúre.

Incident 1: „Vzdialený hostiteľ vynútil prerušenie“ (Timeout OData)

Sección titulada «Incidente 1: “Host remoto forzó la interrupción” (Timeout OData)»

Pri pokuse aktualizovať historický súbor údajov (napr. viac ako 200 000 riadkov) z Power Query, Power BI Desktop alebo pomocou skriptu Python, pripojenie sa načítava niekoľko minút a potom sa náhle ukončí s chybou: La conexión subyacente se cerró: El host remoto forzó la interrupción de la conexión. (OData Timeout).

Toto je zlyhanie vyčerpania zdrojov v NST (Navision Server Tier). Dochádza k tomu, keď cieľový endpoint nie je optimalizované rozhranie API (dotaz), ale štandardná stránka publikovaná ako webová služba (napr. stránka 38). Keď sa požadujú tisíce riadkov zo štandardnej webovej stránky, server Business Central sa snaží vykresliť vizuálne komponenty, spustiť spúšťače a vypočítať zložité dopyty (FlowFields) v pamäti RAM pre každý riadok. Keď spracovanie prekročí časové limity (zvyčajne 10 alebo 15 minút), vyvažovač Azure preruší pripojenie HTTP z bezpečnostných dôvodov, aby sa zabránilo pádu ERP.

  1. Opustiť webové služby založené na stránkach: Odstrániť z architektúry akékoľvek hromadné spracovanie údajov prostredníctvom webových služieb typu stránka.
  2. Vyvinúť natívne rozhrania API (dotaz): Presunúť požiadavku na objekt query v jazyku AL. Týmto sa vykonanie presunie na úroveň SQL a čas odozvy sa zníži z 15 minút na menej ako 30 sekúnd.
  3. Stránkovanie (externé skripty): Ak používame jazyk ako Python pre ETL, musíme zabezpečiť, aby sme sledovali token @odata.nextLink vrátený serverom, pretože Business Central ukladá maximálny limit riadkov na stránku JSON.

Incident 2: Nemožnosť vytvoriť podpriečinky v cestách API

Sección titulada «Incidente 2: Imposibilidad de Crear Subcarpetas en Rutas API»

Počas vývoja nového rozhrania API v jazyku AL sa pri pokuse vytvoriť logickú hierarchiu oddelení vložením lomitej čiary (/) do vlastností rozhrania API, kompilátor Visual Studio Code vyhodí fatálnu chybu a zablokuje vygenerovanie súboru .app.

Príklad chybných kódov:

// ERROR FATAL DE COMPILACIÓN: Microsoft prohíbe las barras en metadatos de enrutamiento
APIGroup = 'portelcore/departamentos/finanzas';

Motor na generovanie OData V4 od spoločnosti Microsoft Business Central má prísne kódované továrenské cesty.

Server vždy a výlučne očakáva nemenný trojkrokový model: {APIPublisher} / {APIGroup} / {APIVersion}

Neexistuje technická kapacita ani povolenia na úrovni kontajnera na úpravu HTTP orchestrovateľa a pridanie ďalších segmentov alebo „podpriečinkov“ do adries URL vlastných API.

Prijať prísne konvencie pomenovania (Naming Conventions).

Keďže nie je možné vytvárať fyzické cesty oddelené /, simulujeme hierarchiu pomocou podčiarkovníc (Snake_case) v rámci APIGroup alebo APIPublisher.

  • Správna implementácia (logická skupina):

    APIPublisher = 'portelcore';
    APIGroup = 'api_portelcore_finanzas_1';
    APIVersion = 'v1.0';

    Výsledok OData: .../api/portelcore/api_portelcore_finanzas_1/v1.0/

  • Alternatívna implementácia (logický vydavateľ):

    APIPublisher = 'portelcore_finanzas';
    APIGroup = 'analitica';
    APIVersion = 'v1.0';

    Výsledok OData: .../api/portelcore_finanzas/analitica/v1.0/

3. Kontrolný zoznam diagnostiky rozhraní API a údajov

Sección titulada «3. Checklist de Diagnóstico de API y Datos»
  • ✓ Výkon: Úplná náhrada služieb typu stránka objektmi Query API na zabránenie časovému pretečeniu v dôsledku preplnenia pamäte RAM v NST.
  • ✓ Formát smerovania: Prísne dodržanie 3-úrovňovej schémy vyžadovanej kompilátorom AL, používajúcej Snake_Case pre logické hierarchie.
  • ✓ Synchronizácia: Predchádzajúce vymazanie lokálnych cache klienta na vynútenie znovuobjavenia schém po rekonfigurácii.