Geavanceerde M-code (Power Query)
Scripts en deterministische extractiepatronen in de M-taal voor robuuste consumptie van OData V4-API's.
Om de data-extractie van onze native API's (ELT) naar het Power BI-semantische model te beheren, vermijden we de grafische gebruikersinterface en schrijven we de Power Query-code (taal M) rechtstreeks in de Geavanceerde Editor.
Dit brengt ons dichter bij een deterministische en controleerbare ontwikkeling, waarbij we elke parameter van het onderliggende HTTP-verzoek beheren.
1. Het Basispatroon voor OData-extractie
Sección titulada «1. El Patrón Base de Extracción OData»De kern van onze ingestie maakt gebruik van de functie OData.Feed. In plaats van te vertrouwen op de automatisch gegenereerde versie, standaardiseren wij deze basissnippet voor alle extracties vanuit Business Central:
let // 1. Definición de la URL absoluta apuntando a nuestro Endpoint AL (EntitySetName) UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/movimientos",
// 2. Invocación de la API con inyección de protecciones de red Origen = OData.Feed(UrlBase, null, [ Implementation="2.0", Timeout=#duration(0, 0, 10, 0) ])in OrigenUitleg van de Kritieke Parameters (DevSecOps)
Sección titulada «Explicación de los Parámetros Críticos (DevSecOps)»Implementation="2.0": Dwingt Power Query om de modernste versie van de OData-engine te gebruiken. Optimaliseert de JSON-lezing op binair niveau en het parsen van metadata.Timeout=#duration(Días, Horas, Minutos, Segundos): Onze verzekering tegen systeemblokkades. Hoewel onze AL-API is geoptimaliseerd om ongeveer 30 seconden te duren, voegen we een strikte limiet van 10 minuten (0, 0, 10, 0) toe. Als de Microsoft ERP een ernstige prestatievermindering ervaart, zal Power BI het laden afbreken zonder processen onbeperkt in het geheugen te houden.
2. Ingesties Geïmplementeerd in Productie
Sección titulada «2. Ingestas Desplegadas en Producción»Dit zijn de exacte scripts die we hebben geïntegreerd in onze belangrijkste Datasets om het business intelligence-model te voeden.
2.1. Productbewegingen (Logistieke Feiten)
Sección titulada «2.1. Movimientos de Producto (Hechos Logísticos)»let UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/movimientos", Origen = OData.Feed(UrlBase, null, [Implementation="2.0", ODataVersion=4, Timeout=#duration(0, 0, 10, 0)])in Origen2.2. Inkoopregels
Sección titulada «2.2. Líneas de Compra»let UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/lineasCompra", Origen = OData.Feed(UrlBase, null, [Implementation="2.0", ODataVersion=4, Timeout=#duration(0, 0, 10, 0)])in Origen2.3. Verkoopregels
Sección titulada «2.3. Líneas de Venta»let UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/lineasVenta", Origen = OData.Feed(UrlBase, null, [Implementation="2.0", ODataVersion=4, Timeout=#duration(0, 0, 10, 0)])in Origen3. Overwegingen voor Transformatie na het Laden
Sección titulada «3. Consideraciones de Transformación Post-Carga»Aangezien onze architectuur is gebaseerd op Pushdown Computation (ELT), is de fundamentele regel van onze scripts M om de lokale computationele belasting op nul te houden.
- Geen filters (
WHERE) inM: Elke uitsluiting van rijen (bijv. het uitsluiten van bepaalde magazijnen of datums) is al uitgevoerd in de SQL-engine van Business Central via de eigenschapDataItemTableFilter. - Geen kolomverwijdering in
M: Alleen de kolommen die strikt geprojecteerd zijn in de endpoint reizen via het HTTP-netwerk. We moeten niet 100 kolommen ophalen om er vervolgens 90 te verwijderen in Power Query. - Het enige wat we lokaal doen is de uiteindelijke datatypeconversie (Type Casting) via
Table.TransformColumnTypes, om ervoor te zorgen dat het DAX-model onveranderlijke gegevens ontvangt (bijv.Int64.Type,type date,type number).
4. M-ontwikkelingschecklist
Sección titulada «4. Checklist de Desarrollo M»- ✓ M-implementatie: Expliciet gebruik van de parameter
Implementation="2.0"in alle queries voor versnelde gegevensopname. - ✓ Latentiecontrole: Preventieve injectie van een
Timeoutvan 10 minuten om de stabiliteit van de updatewachtrij in Power BI Service te beschermen. - ✓ ELT-optimalisatie: Nul lokale filters toegepast op Power Query-niveau, waarbij alle zware datalogica in de SQL-backend wordt gehouden.

