用途:在 Dynamics 365 Field Service 业务层上,通过 Dataverse Web API 管理工单全生命周期、预订与排程、资源、服务账户与资产、事件类型,以及 IoT 触发的服务联动。
主要能力:涵盖工单创建、状态流转(未排程/已排程/进行中/已完成/过账/已取消)、按事件类型自动填充任务与产品服务、完成工单并填写实际工时与解决说明;预订状态管理与创建预订;使用通用资源排程(URS)的 msdyn_SearchResourceAvailability 动作查找可用资源;创建可预订资源并分配技能特征;创建客户资产与功能位置;创建事件类型及其服务任务模板;通过 msdyn_CreateWorkOrderFromIoTAlert 将 IoT 告警转为工单,并查询告警与设备状态;创建协议用于预防性维护。
必要用法:所有数据操作走 {orgUrl}/api/data/v9.2/{entitySetName},API 版本 9.2。认证使用服务主体,例如 ClientSecretCredential 获取令牌,请求头含 Authorization: Bearer {token}、OData-MaxVersion: 4.0、OData-Version: 4.0 等。每个工作流需 tenantId、orgUrl,服务主体须在 Dynamics 中有 systemuser 记录并具 Field Service 安全角色;缺少 orgUrl 或环境未安装 Field Service 时应快速失败,错误输出需脱敏 org URL 与记录 GUID。
适用场景:工单与派工管理、资源可用性排程、资产与功能位置维护、事件类型模板化、IoT 告警转工单及预防性维护协议。
限制:限速为每用户每 5 分钟 6000 次 API 请求,批量操作建议用 $batch;429 需按 Retry-After 退避;状态非法转换会返回错误。收费、价格与具体平台支持情况暂未提供。