build_d365fo_project
Idempotent
Compile a Dynamics 365 Finance and Operations model with xppc.exe, blocking until the build completes. Use fullBuild to resolve stale symbol errors.
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | When true (default) the tool blocks until the build finishes and returns the final result in a single call. The agent should make exactly one call per requested build. Set false for legacy fire-and-forget polling behaviour. | |
| force | No | Kill any running build processes for this model and restart. | |
| fullBuild | No | Full recompile of the TARGET model only (deps stay incremental). Use when xppc reports stale symbol errors. | |
| modelName | No | D365FO model name to build (e.g. MyCustomModel). Auto-detected from workspace if omitted. | |
| projectPath | No | (Legacy) Absolute path to a .rnrproj file — used only to extract the model name when modelName is not provided. | |
| waitTimeoutMs | No | Maximum time (ms) to block when wait:true before returning a "still running" snapshot. Defaults to 30 minutes. The build itself continues in the background. | |
| buildReferencedModels | No | DISABLED — always ignored. Rebuilding dependency models on every build slows the run down and referenced models are expected to already be compiled. |