Расширенный M-код (Power Query)
Скрипты и шаблоны детерминированного извлечения на языке M для надежного потребления API OData V4.
Чтобы управлять извлечением данных из наших родных API (ELT) в семантическую модель Power BI, мы избегаем графического интерфейса и пишем код Power Query (язык M) напрямую в Расширенном редакторе.
Это приближает нас к детерминированной и контролируемой разработке, где мы управляем каждым параметром базового HTTP-запроса.
1. Базовый шаблон извлечения OData
Sección titulada «1. El Patrón Base de Extracción OData»Ядро нашей ингесты использует функцию OData.Feed. Вместо того, чтобы полагаться на автогенерацию, мы стандартизируем этот базовый фрагмент для всех экстракций из 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Объяснение критических параметров (DevSecOps)
Sección titulada «Explicación de los Parámetros Críticos (DevSecOps)»Implementation="2.0": Принуждает Power Query использовать самую современную версию движка OData. Оптимизирует чтение JSON на бинарном уровне и парсинг метаданных.Timeout=#duration(Días, Horas, Minutos, Segundos): Наш страховочный механизм против блокировок системы. Хотя наша API на AL оптимизирована для задержки ~30 секунд, мы вводим жесткий лимит 10 минут (0, 0, 10, 0). Если ERP Microsoft испытывает серьезную деградацию, Power BI прервет загрузку без сохранения процессов в памяти неопределенно.
2. Развернутые инжекции в производство
Sección titulada «2. Ingestas Desplegadas en Producción»Это точные скрипты, которые интегрированы в наши основные наборы данных для питания модели бизнес-аналитики.
2.1. Движения продукции (логистические факты)
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. Строки закупок
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. Строки продаж
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. Соображения пост-загрузки трансформации
Sección titulada «3. Consideraciones de Transformación Post-Carga»Поскольку наша архитектура основана на Pushdown Computation (ELT), фундаментальное правило наших скриптов M - поддерживать местную вычислительную нагрузку на уровне нуля.
- Без фильтров (
WHERE) вM: Все исключения строк (например, пропуск определенных складов или дат) уже были выполнены в SQL-движке Business Central через свойствоDataItemTableFilter. - Без удаления столбцов в
M: Через HTTP передаются только те столбцы, которые строго необходимы для проекции на конечной точке. Нам не следует передавать 100 столбцов, чтобы удалить 90 в Power Query. - Единственное, что мы делаем локально, - это окончательное типизирование данных (Type Casting) с помощью
Table.TransformColumnTypes, гарантируя, что модель DAX получает неизменяемые данные (например,Int64.Type,type date,type number).
4. Контрольный список разработки M
Sección titulada «4. Checklist de Desarrollo M»- ✓ Реализация M: Явное использование параметра
Implementation="2.0"во всех запросах для ускорения загрузки данных. - ✓ Контроль задержки: Профилактическая инъекция
Timeoutв течение 10 минут для защиты стабильности очереди обновлений в Power BI Service. - ✓ Оптимизация ELT: Нулевые местные фильтры, применяемые на уровне Power Query, сохраняя всю тяжелую логику данных на бэкенде SQL.

