Projecten-API
De standaard-API van Microsoft Dynamics 365 Business Central maakt en wijzigt projecten en tijdregistraties, maar leest projecttaken en projectplanningsregels alleen. De MCP Guard-extensie voegt twee API-pagina's toe die dat gat vullen, zodat een AI-assistent projecttaken en projectplanningsregels kan maken en wijzigen. De pagina's werken op de versies 28 en 29 van Business Central.
Het eindpunt
https://api.businesscentral.dynamics.com/v2.0/{environment}/api/vangelderSolutions/projects/v1.0/companies({companyId})/…
| Entiteit | Object | Bewerkingen |
|---|---|---|
projectTasks | Pagina 73633189 MCP Guard Project Tasks API | Lezen, maken, wijzigen. |
projectPlanningLines | Pagina 73633190 MCP Guard Proj. Plan Lines API | Lezen, maken, wijzigen. |
Via deze pagina's wordt niets verwijderd. Ze hebben geen acties en ze boeken niet. Verbruik wordt geboekt via de eigen dagboeken en tijdregistratie van Business Central.
Wat er nodig is om ze te gebruiken
- Wijs de machtigingenset MCP GUARD - USER toe. Sinds versie 1.13.0.0 bevat ze de twee pagina's, en niets op bedrijfsgegevens. De aparte set MCP GUARD - PROJECTS bestaat niet meer. Zie Machtigingensets.
- Geef de gebruiker de eigen machtigingen van Business Central op projecten.
- Wijs een MCP Guard-licentie toe.
- Stel Toegang projecten in op de regel van de gebruiker. Wijzigen laat wijzigingen toe. Maken en acties laat ook toe taken en planningsregels te maken. Zie Toegangsniveaus per module.
- Voeg de twee pagina's toe aan de MCP-configuratie met de bewerkingen die u wilt, en schakel Unblock Edit Tools in. Zie MCP-configuraties.
Een projecttaak maken
Stuur eerst projectNumber en taskNumber, daarna description en taskType. Een client kan ook totaling, de vestiging en de dimensies wijzigen.
De totalen per taak zijn alleen-lezen: budget, verbruik, factureerbaar en gefactureerd. Filter op projectNumber om de taken van één project op te halen.
Een projectplanningsregel maken
Stuur eerst projectNumber, taskNumber, lineType, planningDate, type en number, daarna quantity en de prijzen. De velden worden gevalideerd zoals op de pagina Projectplanningsregels, dus de volgorde telt: stuur het regeltype, de soort en het nummer vóór het aantal en de prijzen.
Zonder lineNumber krijgt de regel het volgende nummer van haar taak, in stappen van 10000.
Op een bestaande regel wijzigt een client de planningsdatum, het aantal, de kostprijs per eenheid, de eenheidsprijs of de omschrijving. Filter op projectNumber en taskNumber om de regels van één taak op te halen.
De sleutels veranderen nooit
Het projectnummer en het taaknummer van een bestaande projecttaak kunnen niet via de API worden gewijzigd. Het project, de taak en het regelnummer van een bestaande projectplanningsregel evenmin. Business Central weigert zo'n wijziging met een melding. Zie Problemen met de API-pagina's oplossen.