Ir al contenido

Code M (Power Query) Avancé

Scripts et modèles d'extraction déterministe en langage M pour la consommation robuste d'API OData V4.

0vues

Pour gouverner l'extraction de données de nos API natives (ELT) vers le modèle sémantique de Power BI, nous évitons l'interface graphique et rédigeons le code Power Query (Langage M) directement dans l'Éditeur Avancé.

Cela nous rapproche d'un développement déterministe et contrôlable, où nous gouvernons chaque paramètre de la requête HTTP sous-jacente.

Le cœur de notre ingestion utilise la fonction OData.Feed. Au lieu de dépendre de l'auto-génération, nous standardisons ce snippet de base pour toutes les extractions depuis 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
  • Implementation="2.0": Force Power Query à utiliser la version la plus récente du moteur OData. Optimise la lecture JSON au niveau binaire et l'analyse des métadonnées.
  • Timeout=#duration(Días, Horas, Minutos, Segundos): Notre assurance contre les blocages système. Bien que notre API en AL soit optimisée pour durer environ 30 secondes, nous injectons une limite stricte de 10 minutes (0, 0, 10, 0). Si l'ERP de Microsoft subit une dégradation grave, Power BI interrompra le chargement sans maintenir de processus en mémoire indéfiniment.

Ce sont les scripts exactos que nous avons intégrés dans nos Datasets principaux pour alimenter le modèle d'intelligence d'affaires.

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. Considérations sur la Transformation Post-Chargement

Sección titulada «3. Consideraciones de Transformación Post-Carga»

Étant donné que notre architecture repose sur le Pushdown Computation (ELT), la règle fondamentale de nos scripts M est de maintenir la charge de calcul locale à zéro.

  1. Sans filtres (WHERE) dans M: Toute exclusion de lignes (ex. omettre certains entrepôts ou dates) a déjà été exécutée dans le moteur SQL de Business Central via la propriété DataItemTableFilter.
  2. Sans suppression de colonnes dans M: Seules les colonnes strictement projetées dans l'endpoint transitent par le réseau HTTP. Nous ne devons pas importer 100 colonnes pour en supprimer 90 dans Power Query.
  3. La seule chose que nous effectuons localement est le typage de données final (Type Casting) via Table.TransformColumnTypes, garantissant que le modèle DAX reçoive des données immuables (ex. Int64.Type, type date, type number).

4. Liste de Contrôle de Développement M

Sección titulada «4. Checklist de Desarrollo M»
  • ✓ Implémentation M : Utilisation explicite du paramètre Implementation="2.0" dans toutes les requêtes pour un chargement de données accéléré.
  • ✓ Contrôle de la latence : Injection préventive de Timeout de 10 minutes pour protéger la stabilité de la file d'attente des mises à jour dans Power BI Service.
  • ✓ Optimisation ELT : Aucun filtre local appliqué au niveau de Power Query, maintenant toute la logique de données lourde dans le backend SQL.