Código M (Power Query) Avanzado
Scripts y patrones de extracción determinista en lenguaje M para el consumo robusto de APIs OData V4.
Para gobernar la extracción de datos desde nuestras APIs Nativas (ELT) hacia el modelo semántico de Power BI, nosotros evitamos la interfaz gráfica y redactamos el código de Power Query (Lenguaje M) directamente en el Editor Avanzado.
Esto nos acerca a un desarrollo determinista y controlable, donde nosotros gobernamos cada parámetro de la petición HTTP subyacente.
1. El Patrón Base de Extracción OData
Sección titulada «1. El Patrón Base de Extracción OData»El núcleo de nuestra ingesta utiliza la función OData.Feed. En lugar de depender del autogenerado, nosotros estandarizamos este snippet base para todas las extracciones desde 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 OrigenExplicación de los Parámetros Críticos (DevSecOps)
Sección titulada «Explicación de los Parámetros Críticos (DevSecOps)»Implementation="2.0": Fuerza a Power Query a usar la versión más moderna del motor OData. Optimiza la lectura de JSON a nivel binario y el parseo de metadatos.Timeout=#duration(Días, Horas, Minutos, Segundos): Nuestro seguro contra bloqueos de sistema. Si bien nuestra API en AL está optimizada para tardar ~30 segundos, inyectamos un límite estricto de 10 minutos (0, 0, 10, 0). Si el ERP de Microsoft sufre una degradación grave, Power BI abortará la carga sin mantener procesos en memoria de forma indefinida.
2. Ingestas Desplegadas en Producción
Sección titulada «2. Ingestas Desplegadas en Producción»Estos son los scripts exactos que tenemos integrados en nuestros Datasets principales para nutrir el modelo de inteligencia de negocio.
2.1. Movimientos de Producto (Hechos Logísticos)
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. Líneas de Compra
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. Líneas de Venta
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. Consideraciones de Transformación Post-Carga
Sección titulada «3. Consideraciones de Transformación Post-Carga»Dado que nuestra arquitectura se basa en Pushdown Computation (ELT), la regla fundamental de nuestros scripts M es mantener la carga computacional local en cero.
- Sin filtros (
WHERE) enM: Toda exclusión de filas (ej. omitir ciertos almacenes o fechas) ya fue ejecutada en el motor SQL de Business Central mediante la propiedadDataItemTableFilter. - Sin eliminación de columnas en
M: Solo transitan por la red HTTP las columnas estrictamente proyectadas en el endpoint. No debemos traer 100 columnas para borrar 90 en Power Query. - Lo único que realizamos localmente es el tipado de datos final (Type Casting) mediante
Table.TransformColumnTypes, asegurando que el modelo DAX reciba datos inmutables (ej.Int64.Type,type date,type number).
4. Checklist de Desarrollo M
Sección titulada «4. Checklist de Desarrollo M»- ✓ Implementación M: Uso explícito del parámetro
Implementation="2.0"en todas las consultas para una carga de datos acelerada. - ✓ Control de Latencia: Inyección preventiva de
Timeoutde 10 minutos para proteger la estabilidad de la cola de actualizaciones en Power BI Service. - ✓ Optimización ELT: Cero filtros locales aplicados a nivel de Power Query, manteniendo toda la lógica pesada de datos en el backend de SQL.

