X++ & standards Microsoft D365

Depuis Dynamics 365 F&O 7.0 (anciennement AX 7), Microsoft a remplacé l'over-layering par un modèle d'extension. Le code core Microsoft n'est plus modifiable directement ; vous ajoutez votre logique métier en utilisant 3 patterns officiels.

Skalp AI utilise exclusivement ces 3 patterns. Aucun over-layering n'est jamais généré, garantissant que vos développements survivent aux release waves One Version (semestrielles) et aux upgrades majeurs sans intervention humaine.

Le choix du pattern dépend du besoin métier : étendre une table → Table Extension ; modifier un comportement existant → Chain of Command ; réagir à un événement → Event Handler. Skalp AI sélectionne le pattern le plus approprié et le documente dans le commentaire de la Pull Request.

Chain of Command (CoC) permet d'étendre une méthode existante sans la remplacer. Vous wrappez la méthode standard Microsoft avec votre propre logique avant et/ou après l'appel original. C'est le pattern recommandé pour modifier le comportement d'une classe, table ou formulaire standard.

Skalp AI génère des classes d'extension en CoC quand vous avez besoin d'ajouter une validation, un calcul, un side-effect ou une transformation autour d'une méthode existante. Le code suit la convention [ExtensionClassName]_Extension avec attribut [ExtensionOf(classStr(StandardClass))].

Exemple type : ajouter un contrôle de cohérence à la validation d'une commande PurchOrder avant la sauvegarde, sans toucher au code Microsoft. Le ticket génère une classe wrapper qui appelle next puis ajoute votre vérification métier.

Les event handlers souscrivent à des événements pré- ou post-méthode publiés par les objets standards Microsoft. Quand l'événement est déclenché (onValidatingWrite, onInsert, onClicked, etc.), votre handler s'exécute.

Skalp AI génère des event handlers quand le besoin métier est asynchrone par nature : déclencher une intégration, envoyer une notification, alimenter un log d'audit, ou réagir à un changement de statut. Le code est packagé dans une classe statique avec attributs [SubscribesTo(...)].

Avantage clé : un event handler est complètement découplé du code principal. Il peut être désactivé sans impact sur le flux standard. Idéal pour les fonctionnalités optionnelles ou liées à un module spécifique.

Les extension classes permettent d'ajouter des champs, méthodes, contrôles ou valeurs à une entité standard Microsoft sans la dupliquer. C'est le pattern le plus simple : il étend la définition de l'objet plutôt que son comportement.

Skalp AI génère des Table Extensions pour ajouter des champs métier (centre de profit, indicateur RGPD, référence externe…), des Form Extensions pour adapter les écrans (ajout d'onglet, masquage conditionnel, bouton custom), et des Enum Extensions pour étendre les listes de valeurs métier.

L'extension respecte automatiquement la convention de nommage Microsoft : suffixe .Extension, prefixe métier cohérent avec votre modèle (ex : SKL_CustTable_Extension), attribut [ExtensionOf(...)] systématique.

L'over-layering (modification directe du code Microsoft via la couche SLN, USR, etc.) était la norme jusqu'à AX 2012. Microsoft l'a déprécié officiellement depuis D365 F&O 7.0 et l'a rendu impossible techniquement dans les environnements cloud à partir de 10.0.

Skalp AI ne génère JAMAIS d'over-layering, même en migration depuis AX 2012. Tout code AX 2012 over-layered est systématiquement réécrit en pattern d'extension (CoC, event handler ou extension class selon le cas) lors de la migration.

Conséquence pratique : votre code Skalp AI survit aux release waves One Version sans intervention. Vous évitez la dette technique majeure qui freine la plupart des clients D365 lors des upgrades.

Microsoft livre One Version sous forme de release waves successives (typiquement 8 vagues par an, avec service updates intermédiaires). Chaque vague peut introduire des changements de signature de méthode, des dépréciations ou des nouveaux events.

Skalp AI génère du code qui suit les contrats publics actuels documentés par Microsoft. Quand une signature change dans une release wave, vos extensions CoC peuvent nécessiter une mise à jour mineure (changement de signature) — détectée automatiquement lors du build CI.

Pour chaque release wave, Microsoft publie un "upgrade analyzer" qui flagge les extensions impactées. Si une de vos extensions générées par Skalp AI est impactée, vous pouvez soumettre un ticket de mise à jour (typiquement 200 € pour adapter à la nouvelle signature, parfois requalifié comme bonus sans facturation).

Statistiquement, moins de 5 % des extensions sont impactées à chaque release wave. Le ratio s'améliore avec les patterns d'extension qui sont la voie supportée par Microsoft long-terme.