Fortgeschrittener M-Code (Power Query)
Skripte und Muster für deterministische Extraktion in der M-Sprache für den robusten Verbrauch von OData V4-APIs.
Um die Extraktion von Daten aus unseren nativen APIs (ELT) in das semantische Modell von Power BI zu steuern, vermeiden wir die grafische Oberfläche und schreiben den Power Query-Code (Sprache M) direkt im Advanced Editor.
Dies bringt uns einer deterministischen und kontrollierbaren Entwicklung näher, bei der wir jeden Parameter der zugrunde liegenden HTTP-Anfrage steuern.
1. Das OData-Extraktions-Basismuster
Sección titulada «1. El Patrón Base de Extracción OData»Der Kern unserer Ingestion nutzt die Funktion OData.Feed. Anstatt uns auf die automatisch generierte Version zu verlassen, standardisieren wir dieses grundlegende Snippet für alle Extraktionen aus 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 OrigenErklärung der kritischen Parameter (DevSecOps)
Sección titulada «Explicación de los Parámetros Críticos (DevSecOps)»Implementation="2.0": Erzwingt, dass Power Query die modernste Version der OData-Engine verwendet. Optimiert das Lesen von JSON auf Binärebene und das Parsen von Metadaten.Timeout=#duration(Días, Horas, Minutos, Segundos): Unsere Absicherung gegen Systemblockaden. Obwohl unsere API in AL so optimiert ist, dass sie etwa 30 Sekunden benötigt, injizieren wir ein striktes Limit von 10 Minuten (0, 0, 10, 0). Wenn das Microsoft ERP eine schwerwiegende Verschlechterung erfährt, bricht Power BI den Ladevorgang ab, ohne Prozesse unendlich lange im Speicher zu halten.
2. In Produktion bereitgestellte Ingestionen
Sección titulada «2. Ingestas Desplegadas en Producción»Dies sind die genauen Skripte, die wir in unsere Haupt-Datasets integriert haben, um das Business-Intelligence-Modell zu speisen.
2.1. Produktbewegungen (Logistische Fakten)
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. Einkaufszeilen
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. Verkaufszeilen
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. Überlegungen zur Post-Load-Transformation
Sección titulada «3. Consideraciones de Transformación Post-Carga»Da unsere Architektur auf Pushdown Computation (ELT) basiert, ist die Grundregel unserer Skripte M, die lokale Rechenlast bei Null zu halten.
- Keine Filter (
WHERE) inM: Jeder Zeilenausschluss (z. B. das Auslassen bestimmter Lager oder Daten) wurde bereits im SQL-Motor von Business Central über die EigenschaftDataItemTableFilterausgeführt. - Keine Spaltenlöschung in
M: Nur die im Endpoint strikt projizierten Spalten werden über das HTTP-Netzwerk übertragen. Wir sollten nicht 100 Spalten abrufen, um 90 davon in Power Query zu löschen. - Das Einzige, was wir lokal durchführen, ist das finale Datentypisieren (Type Casting) mittels
Table.TransformColumnTypes, um sicherzustellen, dass das DAX-Modell unveränderliche Daten erhält (z. B.Int64.Type,type date,type number).
4. M-Entwicklungs-Checkliste
Sección titulada «4. Checklist de Desarrollo M»- ✓ M-Implementierung: Explizite Verwendung des Parameters
Implementation="2.0"in allen Abfragen für eine beschleunigte Datenladung. - ✓ Latenzkontrolle: Präventive Injektion von
Timeoutvon 10 Minuten, um die Stabilität der Aktualisierungswarteschlange im Power BI Service zu schützen. - ✓ ELT-Optimierung: Keine lokalen Filter auf Power Query-Ebene, wodurch die gesamte schwere Datenlogik im SQL-Backend verbleibt.

