Řešení potíží s API a daty
Protokoly reakce na selhání hromadné extrakce, latenci sítě OData a architektonická omezení v Business Central.
V naší práci DevSecOps, která zajišťuje integritu datových kanálů (Data Pipelines), může integrace mezi Business Central a platformami Business Intelligence představovat úzká hrdla a síťové překážky.
Tento dokument podrobně popisuje hlavní příčiny nejzávažnějších zjištěných chyb a jejich definitivní řešení na základě implementované architektury.
Incident 1: „Vzdálený hostitel vynutil přerušení“ (Časový limit OData)
Sección titulada «Incidente 1: “Host remoto forzó la interrupción” (Timeout OData)»Příznak
Sección titulada «Síntoma»Při pokusu o aktualizaci historického souboru dat (např. více než 200 000 řádků) ze Power Query, Power BI Desktop nebo pomocí skriptu Python se připojení načítá několik minut a náhle se přeruší s chybou: La conexión subyacente se cerró: El host remoto forzó la interrupción de la conexión. (OData Timeout).
Kořenová diagnóza
Sección titulada «Diagnóstico Raíz»Este es un fallo por Agotamiento de Recursos en el NST (Navision Server Tier).\r Ocurre cuando el endpoint objetivo no es una API optimizada (Query), sino una página estándar publicada como Web Service (ej. Página 38). Al solicitar miles de filas a una página web, el servidor de Business Central intenta renderizar componentes visuales, ejecutar triggers y calcular subconsultas complejas (FlowFields) en la memoria RAM para cada fila. Cuando el procesamiento supera los límites temporales (habitualmente 10 o 15 minutos), el balanceador de Azure corta la conexión HTTP por seguridad para evitar una caída del ERP.
Řešení DevSecOps (Implementováno)
Sección titulada «Solución DevSecOps (Implementada)»- Opuštění Web Services založených na stránkách (Page): Odstranění jakékoli masivní konzumace dat prostřednictvím Web Services typu Page z architektury.
- Vývoj nativních API (Query): Přesun požadavku na objekt
queryv jazyce AL. Tímto způsobem se vykonávání přeskočí vrstvu rozhraní a převede na čistý SQL příkaz, což zkrátí dobu odezvy z 15 minut na méně než 30 sekund. - Stránkování (Externí skripty): Pokud používáme jazyk jako Python pro ETL, musíme se ujistit, že budeme respektovat a naprogramovat sledování tokenu
@odata.nextLinkvráceného serverem, protože Business Central vynucuje maximální počet řádků na jednu vrácenou JSON stránku.
Incident 2: Nemožnost vytvořit podsložky v trasách API
Sección titulada «Incidente 2: Imposibilidad de Crear Subcarpetas en Rutas API»Příznak (Názvosloví a směrování)
Sección titulada «Síntoma (Nomenclatura y Enrutamiento)»Při vývoji nové API v jazyce AL, při pokusu o vytvoření logické hierarchie oddělení zavedením lomítka (/) do vlastností API, vyhlásí kompilátor Visual Studio Code fatální chybu a zablokuje generování souboru .app.
Příklad chybného kódu:
// ERROR FATAL DE COMPILACIÓN: Microsoft prohíbe las barras en metadatos de enrutamientoAPIGroup = 'portelcore/departamentos/finanzas';Kořenová diagnóza
Sección titulada «Diagnóstico Raíz»Generovací engine OData V4 společnosti Microsoft Business Central má přísně hardcoded strukturální cesty.
El servidor espera siempre y únicamente un modelo de 3 niveles inmutables:\r
{APIPublisher} / {APIGroup} / {APIVersion}
Neexistuje žádná technická kapacita ani oprávnění na úrovni kontejneru ke změně orchestrátoru HTTP a přidání dalších segmentů nebo „podsložek“ do adres URL vlastních API.
Řešení / Architektonické náhradní řešení
Sección titulada «Solución / Workaround Arquitectónico»Dodržovat přísné konvence pojmenování (Naming Conventions).
Protože nelze vytvářet fyzické cesty oddělené /, simulujeme hierarchii pomocí podtržníků (Snake_case) v rámci APIGroup nebo APIPublisher.
-
Správná implementace (logická skupina):
APIPublisher = 'portelcore';APIGroup = 'api_portelcore_finanzas_1';APIVersion = 'v1.0';Výsledek OData:
.../api/portelcore/api_portelcore_finanzas_1/v1.0/ -
Alternativní implementace (logický publisher):
APIPublisher = 'portelcore_finanzas';APIGroup = 'analitica';APIVersion = 'v1.0';Výsledek OData:
.../api/portelcore_finanzas/analitica/v1.0/
3. Kontrolní seznam diagnostiky API a dat
Sección titulada «3. Checklist de Diagnóstico de API y Datos»- ✓ Výkon: Úplná náhrada služeb typu stránky objekty
Query APIpro vyhnutí se časovým limitům kvůli přetečení RAM na NST. - ✓ Formát směrování: Přísné dodržování tříúrovňového schématu vyžadovaného kompilátorem AL, používající Snake_Case pro logické hierarchie.
- ✓ Synchronizace: Předchozí čištění lokálních cache klienta pro vynucení opětovného objevení schémat po rekonfiguraci.

