Codice M (Power Query) Avanzato
Script e pattern di estrazione deterministica nel linguaggio M per il consumo robusto di API OData V4.
Per governare l'estrazione dei dati dalle nostre API native (ELT) verso il modello semantico di Power BI, evitiamo l'interfaccia grafica e scriviamo il codice Power Query (Linguaggio M) direttamente nell'Editor Avanzato.
Questo ci avvicina a uno sviluppo deterministico e controllabile, in cui governiamo ogni parametro della richiesta HTTP sottostante.
1. Il Pattern Base di Estrazione OData
Sección titulada «1. El Patrón Base de Extracción OData»Il nucleo della nostra ingestione utilizza la funzione OData.Feed. Invece di dipendere dalla generazione automatica, standardizziamo questo snippet di base per tutte le estrazioni da 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 OrigenSpiegazione dei Parametri Critici (DevSecOps)
Sección titulada «Explicación de los Parámetros Críticos (DevSecOps)»Implementation="2.0": Forza Power Query a utilizzare la versione più recente del motore OData. Ottimizza la lettura di JSON a livello binario e il parsing dei metadati.Timeout=#duration(Días, Horas, Minutos, Segundos): La nostra protezione contro i blocchi di sistema. Sebbene la nostra API in AL sia ottimizzata per impiegare circa 30 secondi, iniettiamo un limite rigoroso di 10 minuti (0, 0, 10, 0). Se l'ERP di Microsoft subisce un grave degrado, Power BI interromperà il caricamento senza mantenere i processi in memoria indefinitamente.
2. Ingestion Distribuite in Produzione
Sección titulada «2. Ingestas Desplegadas en Producción»Questi sono gli script esatti che abbiamo integrato nei nostri Dataset principali per alimentare il modello di business intelligence.
2.1. Movimenti di Prodotto (Fatti Logistici)
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. Righe di Acquisto
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. Righe di Vendita
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. Considerazioni sulla Trasformazione Post-Caricamento
Sección titulada «3. Consideraciones de Transformación Post-Carga»Poiché la nostra architettura si basa su Pushdown Computation (ELT), la regola fondamentale dei nostri script M è mantenere il carico computazionale locale a zero.
- Senza filtri (
WHERE) inM: Ogni esclusione di righe (es. omettere determinati magazzini o date) è già stata eseguita nel motore SQL di Business Central tramite la proprietàDataItemTableFilter. - Senza eliminazione di colonne in
M: Solo le colonne strettamente proiettate nell'endpoint transitano sulla rete HTTP. Non dobbiamo recuperare 100 colonne per eliminarne 90 in Power Query. - L'unica operazione che eseguiamo localmente è la tipizzazione finale dei dati (Type Casting) tramite
Table.TransformColumnTypes, assicurando che il modello DAX riceva dati immutabili (es.Int64.Type,type date,type number).
4. Checklist di Sviluppo M
Sección titulada «4. Checklist de Desarrollo M»- ✓ Implementazione M: Uso esplicito del parametro
Implementation="2.0"in tutte le query per un caricamento dati accelerato. - ✓ Controllo della latenza: Iniezione preventiva di
Timeoutdi 10 minuti per proteggere la stabilità della coda di aggiornamento in Power BI Service. - ✓ Ottimizzazione ELT: Zero filtri locali applicati a livello di Power Query, mantenendo tutta la logica pesante dei dati nel backend SQL.

