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.
Isso nos aproxima de um desenvolvimento determinista e controlável, onde governamos cada parâmetro da requisição HTTP subjacente.
1. O Padrão Base de Extração 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 OrigenExplicação dos 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. Ingestões Implantadas em Produção
Sección titulada «2. Ingestas Desplegadas en Producción»Estes são os scripts exatos que temos integrados em nossos Datasets principais para nutrir o modelo de inteligência de negócios.
2.1. Movimentos de Produto (Fatos 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. Linhas 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. Linhas de Venda
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. Considerações de Transformação Pós-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) 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.
- 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 Desenvolvimento 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 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.

