适用于：Dynamics 365 Sales
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当卖方希望推动业务流程推进记录时，例如将机会推进到下一个销售阶段，可以使用此功能。
它的作用是什么
助理在记录的业务流程实例上设置激活阶段。 你提供业务流程实体的逻辑名称、BPF实例记录的GUID和目标阶段的GUID。 目标阶段会根据实例进程进行验证，遍历历史则在服务器端推导出来。
试试像这样的提示
- 将此机会移至提案阶段。
- 将交易推进到下一个销售阶段。
- 设定业务流程阶段。
- 将领先优势移至资格赛。
你在聊天中会看到的内容
助手会显示文本回复，确认舞台已更新。 该助手没有显示该功能的互动应用聊天组件。
有用的提示
- 对于一个机会，用 来解析业务流程实例和目标阶段的 GUID
get_opportunity_bpf。 - 对于潜在客户，使用
get_lead_bpf，并只选择参与实体为lead的阶段。 在开箱即用流程中，开发及后续阶段属于由潜在客户资格认证创造的机会。 - 在移动唱片之前，先和卖家确认目标阶段。
- 目标阶段必须属于实例的进程;访问阶段的顺序列表会自动记录。
接下来会发生什么
- 总结一下这个机会。
- 添加产品。
- 起草一封下一步邮件。
- 请查看本次交易的活动时间表。
这会改变数据吗？
是的，这可能会改变数据。
先决条件
该工具需要在所选 Dynamics 365 环境中编写业务流程实例记录的权限。
工具摘要
| 财产 | 价值 |
|---|---|
| 面向用户的名称 | 更新业务流程阶段 |
| 内部工具名称 | update_bpf_stage |
| Purpose | 在记录的业务流程流程中设置激活阶段。 |
工具行为
该工具更新了指定业务流程实例的活跃阶段查询，并记录服务器导出的遍历历史（由实例当前阶段、现有路径及验证目标构建）。 它不会移动底层记录的其他字段，也不会验证超出Dataverse强制执行范围的阶段录入业务规则。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
该工具会修改数据。 |
destructiveHint |
false |
这个工具不会进行破坏性改变。 |
idempotentHint |
true |
再次设置同一个活跃阶段，仍然保持同一阶段。 |
openWorldHint |
未设置 | 使用默认行为。 |
输入概念
业务流程流
| Input | 说明 | Required |
|---|---|---|
bpfEntityLogicalName |
业务流程流程实体的逻辑名称，如 opportunitysalesprocess 或 leadtoopportunitysalesprocess。 |
Yes |
bpfInstanceId |
Dataverse 活动业务流程实例记录的 GUID。 | Yes |
targetStageId |
Dataverse GUID 是流程阶段的激活。 必须属于实例的进程。 | Yes |
响应与用户界面行为
响应类型
仅文本
没有渲染任何交互组件。
路由注释
当用户想通过业务流程移动记录时使用 update_bpf_stage 。 不要用 update_bpf_stage 来更新普通字段（使用 update_entity_record）或关闭或重新开启交易。
相关工具
| 工具 | 关系 |
|---|---|
get_opportunity_bpf |
解决商机的活跃业务流程实例及其阶段GUID——获取和获取机会的首选方式bpfInstanceIdtargetStageId。 |
get_lead_bpf |
解析潜在客户的活跃BPF实例，识别参与潜在客户与由此产生的机会的阶段。 |
get_entity_record |
读取BPF实例和阶段记录，解析除机会外其他记录类型的GUID。 |
list_entity_records |
查找记录的业务流程实例。 |
update_entity_record |
更新记录中的非阶段字段。 |
数据变异分类
写作/变异。
当工具在业务流程实例中设置活跃阶段时，会更改Dataverse数据。 重复同一阶段的更新是幂等型。