build_d365fo_project
Compiles an entire Dynamics 365 Finance and Operations model with xppc in one blocking call, fixing stale-symbol errors and optionally syncing the database.
Instructions
Build a D365FO model with xppc.exe (compiles the ENTIRE model, not one project). Blocks until done — call ONCE per build, do NOT poll (wait:false = legacy polling mode). fullBuild:true fixes "not been successfully compiled since it was last changed" stale-symbol errors.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "build_d365fo_project"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Default true: one call returns the final result. false = legacy fire-and-forget. | |
| force | No | Kill any running build processes for this model and restart. | |
| aosUrl | No | restartAos root. Default: Infrastructure.HostUrl in AosService web.config; required on UDE. | |
| dbSync | No | On a SUCCESSFUL build, also run the database sync (SyncEngine.exe) — REQUIRED after any table/view/data-entity change. true = partial sync of the syncable objects in the project, full-model when it has none; an ARRAY syncs exactly those tables/views (much faster). With deploy: full sync in the environment. | |
| deploy | No | UDE: on a SUCCESSFUL build, deploy the model's package to the cloud runtime that run_systest_class tests run in. dbSync unset: syncs only if schema changed (~20 min, else ~3). | |
| bpCheck | No | On a SUCCESSFUL build, also run the best-practice checker and append its findings. Prefer this to a follow-up run_bp_check call: one build call instead of two round trips. | |
| fullBuild | No | Full recompile of TARGET model (not deps). Fixes stale symbols; auto when a table, EDT, enum or OData entity changes. | |
| modelName | No | D365FO model name to build (e.g. MyCustomModel). Auto-detected from workspace if omitted. | |
| restartAos | No | After a successful build (+dbSync), restart the local IIS/IIS Express AOS serving aosUrl. | |
| waitTimeoutMs | No | Max ms to block (default 30 min) before a "still running" snapshot; the build continues. |