Ir al contenido

Código M (Power Query) Avanzado

Scripts y patrones de extracción determinista en lenguaje M para el consumo robusto de APIs OData V4.

0lecturas

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.

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
Origen

Explicació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.

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
Origen
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
Origen
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
Origen

3. 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.

  1. Sin filtros (WHERE) en M: Toda exclusión de filas (ej. omitir ciertos almacenes o fechas) ya fue ejecutada en el motor SQL de Business Central mediante la propiedad DataItemTableFilter.
  2. 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.
  3. 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).
  • ✓ 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 Timeout de 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.