API de planification et d'assemblage
L'extension MCP Guard ajoute à Microsoft Dynamics 365 Business Central des pages API pour la planification et pour les ordres d'assemblage. Un assistant IA peut recalculer le calendrier de capacité d'un centre de charge, calculer un plan dans une feuille planification, lire et ajuster les suggestions, et créer, lancer et valider des ordres d'assemblage. Les pages fonctionnent sur les versions 28 et 29 de Business Central.
Les points de terminaison
Les pages de planification se trouvent dans le groupe d'API production, les pages d'assemblage dans le groupe assembly :
https://api.businesscentral.dynamics.com/v2.0/{environment}/api/vangelderSolutions/production/v1.0/companies({companyId})/…
https://api.businesscentral.dynamics.com/v2.0/{environment}/api/vangelderSolutions/assembly/v1.0/companies({companyId})/…
| Entité | Groupe | Objet | Opérations |
|---|---|---|---|
workCenters | production | Page 73633184 MCP Guard Work Centers API | Lecture. Action calculateCalendar. |
planningWorksheets | production | Page 73633185 MCP Guard Planning Wksh. API | Lecture. Action calculatePlan. |
planningLines | production | Page 73633186 MCP Guard Planning Lines API | Lecture, modification (acceptActionMessage, quantity, dueDate). |
assemblyOrders | assembly | Page 73633187 MCP Guard Asm. Orders API | Lecture, création, modification. Actions release, reopen et post. |
assemblyLines | assembly | Page 73633188 MCP Guard Asm. Lines API | Lecture, modification. |
Rien n'est supprimé par ces pages.
Ce qu'il faut pour les utiliser
Les pages de planification et les pages d'assemblage se trouvent dans l'ensemble d'autorisations MCP GUARD - USER. Jusqu'à la version 1.12.0.0, elles se trouvaient dans les ensembles MCP GUARD - PROD et MCP GUARD - ASSEMBLY, qui n'existent plus. MCP GUARD - USER n'accorde rien sur les données métier : l'utilisateur a donc aussi besoin des autorisations propres à Business Central. Voir Ensembles d'autorisations. L'utilisateur a besoin d'une licence MCP Guard, et le niveau d'accès de sa règle décide de ce qui est autorisé : Accès planification pour les pages de planification, Accès assemblage pour les pages d'assemblage. Voir Niveaux d'accès par module.
Calculer le calendrier et le plan
calculateCalendar et calculatePlan prennent startingDate et endingDate dans le corps de la requête. Les deux dates sont requises, et la date de fin ne doit pas être antérieure à la date de début. Les deux actions exigent le niveau d'accès Créer et actions pour la planification.
calculateCalendar recalcule le calendrier de capacité du centre de charge et de ses postes de charge pour la période, et applique à nouveau les absences enregistrées.
calculatePlan calcule un plan régénératif dans la feuille : MPS et MRP, pour chaque article de stock, sans prévision. Les suggestions antérieures de la feuille sont remplacées.
Ajuster les suggestions
planningLines contient les suggestions des feuilles planification. Un client les lit et les accepte, les refuse ou les ajuste en modifiant acceptActionMessage, quantity ou dueDate. Filtrez sur worksheetTemplateName et journalBatchName pour une seule feuille.
L'exécution des messages d'action n'est pas proposée via l'API. Cette étape reste dans la feuille planification de Business Central.
Créer un ordre d'assemblage
Envoyez d'abord itemNumber, puis quantity et dueDate. L'ordre est enregistré avant que ses champs ne soient validés : l'article crée donc immédiatement les lignes de composants à partir de la nomenclature d'assemblage. Les lignes de composants se trouvent dans assemblyLines, où un client modifie quantityPer, quantity, quantityToConsume, le magasin ou l'emplacement. Filtrez sur documentNumber pour un seul ordre.
Valider un ordre d'assemblage
post valide la quantité à assembler et consomme les composants. Un ordre entièrement assemblé est supprimé par la validation.
Important
post est une validation. Deux paramètres la protègent. La règle de l'utilisateur doit accorder Validation pour Accès assemblage. Et Allow Actions dans la configuration MCP se définit par page : release, reopen et post sont donc activés ou désactivés ensemble. Pour laisser un assistant IA préparer des ordres d'assemblage sans les valider, accordez Créer et actions, ou utilisez une configuration sans Allow Actions sur la page des ordres d'assemblage.