API de projets

L'API standard de Microsoft Dynamics 365 Business Central crée et modifie des projets et des enregistrements de temps, mais ne fait que lire les tâches projet et les lignes planning projet. L'extension MCP Guard ajoute deux pages API qui comblent cette lacune, de sorte qu'un assistant IA peut créer et modifier des tâches projet et des lignes planning projet. Les pages fonctionnent sur les versions 28 et 29 de Business Central.

Le point de terminaison

https://api.businesscentral.dynamics.com/v2.0/{environment}/api/vangelderSolutions/projects/v1.0/companies({companyId})/…

Entité	Objet	Opérations
`projectTasks`	Page 73633189 MCP Guard Project Tasks API	Lecture, création, modification.
`projectPlanningLines`	Page 73633190 MCP Guard Proj. Plan Lines API	Lecture, création, modification.

Rien n'est supprimé par ces pages. Elles n'ont pas d'actions et ne valident rien. La consommation est validée via les feuilles et l'enregistrement de temps propres à Business Central.

Ce qu'il faut pour les utiliser

Attribuez l'ensemble d'autorisations MCP GUARD - USER. Depuis la version 1.13.0.0, il contient les deux pages, et rien sur les données métier. L'ensemble distinct MCP GUARD - PROJECTS n'existe plus. Voir Ensembles d'autorisations.
Donnez à l'utilisateur les autorisations propres à Business Central sur les projets.
Attribuez une licence MCP Guard.
Définissez Accès projets sur la règle de l'utilisateur. Modifier autorise les modifications. Créer et actions autorise aussi la création de tâches et de lignes planning. Voir Niveaux d'accès par module.
Ajoutez les deux pages à la configuration MCP avec les opérations souhaitées, et activez Unblock Edit Tools. Voir Configurations MCP.

Créer une tâche projet

Envoyez d'abord projectNumber et taskNumber, puis description et taskType. Un client peut aussi modifier totaling, le magasin et les axes analytiques.

Les totaux par tâche sont en lecture seule : budget, consommation, facturable et facturé. Pour obtenir les tâches d'un seul projet, filtrez sur projectNumber.

Créer une ligne planning projet

Envoyez d'abord projectNumber, taskNumber, lineType, planningDate, type et number, puis quantity et les prix. Les champs sont validés comme sur la page des lignes planning projet : l'ordre compte donc. Envoyez le type de ligne, le type et le numéro avant la quantité et les prix.

Sans lineNumber, la ligne reçoit le numéro suivant de sa tâche, par pas de 10000.

Sur une ligne existante, un client modifie la date de planning, la quantité, le coût unitaire, le prix unitaire ou la description. Pour obtenir les lignes d'une seule tâche, filtrez sur projectNumber et taskNumber.

Les clés ne changent jamais