使用解决方案运行状况中心解决问题

通过解决方案运行状况中心,您可以更好地了解环境的状态并检测 Dynamics 365 环境中的问题。 解决方案运行状况中心在实例中运行规则以验证环境的配置,规则可能会通过自然的系统运行在一段时间后更改。 一些规则特定于 Dynamics 365 Field Service,遇到问题时可以按需运行这些规则。 有些规则会在安装或更新 Field Service 时自动触发。 定期运行 Field Service 规则集可以监视环境的运行状况。

以下是解决方案运行状况中心检测到的一些常见问题:

  • 关键 Field Service 流程是否已停用。
  • 导致升级失败的流程是否分配给了禁用的用户。
  • 如果自定义的 Web 资源导致运行时问题。

除了运行 Solution Health Hub 之外,还可以查看 自定义 Dynamics 365 Field Service运行 Solution Checker 以改进脚本、插件、HTML 和工作流程的最佳实践

先决条件

  • Field Service v8.4.0.338+(统一接口)或 v7.5.7.87+ (Web)
  • 解决方案运行状况中心扩展 Power Apps 检查器以确保环境持续的健康运行。

运行运行状况检查

要为 Field Service 运行分析作业:

  1. 打开解决方案运行状况中心应用。

    导航中的解决方案运行状况中心的屏幕截图。

  2. 选择分析作业,创建新分析作业。

  3. 对话框打开时,选择 Field Service

  4. 选择确定,分析作业将开始。

查看运行状况检查结果

当分析作业完成运行后,系统会打开概览页面。

完整的分析作业概览的屏幕截图。

在分析作业中,每条规则都显示 Return Status ( 返回状态 ),指示规则是通过、失败还是有配置错误。 如果规则失败, 则 Severity (严重性 ) 表示问题的严重性。

规则返回状态 建议
故障 突出显示系统内的具体失败信息;请根据建议修改规则。
警告 请注意规则消息中提到的含义。
通过 表示此规则没有问题。 所有规则都应处于此状态。

协议工作订单生成

严重性:高

检查内容

此规则验证所有工作订单是否都是根据协议正确生成的。

失败的原因

此规则失败,因为协议重复周期未正确处理,并且工作订单未生成本应生成的工作订单。

修复方法

  1. 确定未生成工作订单的原因和失败的原因。
  2. 修复问题。
  3. 要重新开始记录生成,请将协议 System Status (系统状态 ) 更改回 'Estimate'(估计)。 然后将其更改为 'Active'。

注意

更改协议状态会删除所有具有 有效 状态的现有协议预订数据记录,但只会重新生成未来日期的记录。

解决方案运行状况中心的解决方案运行状况协议生成。

严重性:高

检查内容

此规则检查与协议相关的失败工作流程。

失败的原因

如果存在与协议预订设置或协议发票设置记录相关的失败工作流,则此规则将失败。

修复方法

选择分析结果,然后选择 Resolve

检查有效协议的结束日期是否为过去的日期

严重性:高

检查内容

此规则检查系统状态 为“活动”但结束日期为过去的协议 。 状态应为 'Expired'。

失败的原因

如果协议的系统状态为“活动”,则此规则将失败,即使其结束日期已过去。

修复方法

选择分析结果,查看协议,然后选择 解决。

注释和限制

  • 该规则将验证结束日期在过去 90 天内的协议。
  • 该规则会考虑过去具有活动系统状态和结束日期的前 5,000 个协议。
  • 该规则仅验证具有 协议预订设置 和 协议预订日期 的协议。

检查已删除的窗体库

严重性:中等

检查内容

此规则检测系统中是否有缺少 Field Service 库的 Field Service 表单。

失败的原因

如果 Field Service 窗体缺少任何 Field Service 库,则此规则将失败。

备注

此规则可能会在 'Price Level' 表单上显示误报失败。

修复方法

将缺少的库添加到表单中。 您可以通过与同一表中或其他组织中的其他表单进行比较来获取所需库的列表。 请联系支持人员寻求帮助。

检查窗体是否具有运行不正常的自定义项

严重性:高

检查内容

对于所有工作订单表单,此规则检查子网格控件或查找控件的数量是否超过限制,这可能会影响性能。 限制为 4 个子网格或 20 个查找。 此规则会向系统管理员触发通知,说明哪些窗体具有过多的 subgrid 控件或 lookup 控件。

subgrid 控件是窗体中列出另一个表的记录的表。 例如,Field Service 中现成包含的工作订单窗体上的工作订单产品子网格控件。

lookup 控件是窗体上的一个字段,用于搜索另一个表的记录并允许您选择一个或多个记录来填充该字段。

失败的原因

如果任何工作订单窗体的默认选项卡(第一个选项卡)具有 4 个以上的子网格控件或 20 个以上的查找控件,则此规则将失败。 表单的 default 选项卡上的控件数量会影响加载性能。

修复方法

减少 default 选项卡上的查找字段和子网格控件的数量。将它们移动到表单上的其他选项卡,或者如果不需要,请从表单中隐藏它们。

查看改进窗体加载时间的更多方法。

检查字段的必需级别是否已修改

严重性:高

检查内容

此规则检查是否修改了工作订单或协议表单上系统必填字段的 required 级别。

失败的原因

如果修改了现成的 Field Service 工作订单或协议窗体中系统必填字段的 required 级别,则此规则将失败。

修复方法

  1. 在 Power Apps 中,选择 全部> 并搜索 工作订单 或 协议 。
  2. 选择表。
  3. 架构下面,选择。 查找并选择分析中列出的字段。
  4. 在 Edit column 窗格中,将 Required 更改为 'Business Required' 并保存。

备注

此规则仅针对工作订单和协议表单上的现成必填字段实施。

检查协议预订日期与协议预订设置的修订是否不匹配

严重性:高

检查内容

此规则验证协议预订日期修订是否 与相应 协议预订设置 的修订匹配。

失败的原因

如果与协议预订日期的修订值不匹配,并且它是相应的协议预订设置,则此规则将失败。 此规则仅考虑预订日期少于 90 天的有效预订日期记录。 如果存在不匹配,则系统可能不会为该预订日期生成工作订单。

修复方法

联系支持。

注释和限制

此规则根据最新的预订日期考虑过去三个月内前 5,000 个有效的 协议预订日期 记录。

检查协议发票设置的协议发票日期的修订是否不匹配

严重性:高

检查内容

此规则验证协议发票日期修订是否 与相应 协议发票设置 的修订匹配。

失败的原因

如果协议发票日期的修订值不匹配,则此规则将失败,并且该版本与相应的协议发票设置不匹配。 此规则考虑发票日期少于 90 天的有效协议发票日期记录。 如果存在不匹配,系统可能不会为该发票日期生成发票。

修复方法

联系支持。

注释和限制

此规则根据最新发票日期考虑过去三个月中前 5,000 条活动的 协议发票日期 记录。

“Connected Field Service”应用模块上的自定义

严重性:低

检查内容

此规则检查是否存在已弃用且不应自定义的 Connected Field Service 应用模块的自定义项。

失败的原因

如果组织中的 Connected Field Service 应用模块上有任何自定义项,则此规则将失败。

修复方法

从 Connected Field Service 应用模块中删除自定义项。

自定义的选项集

严重性:高

检查内容

此规则检测 Field Service 中是否存在不应自定义的任何选项集的自定义。 自定义选项集可能导致意外行为。

失败的原因

如果任何默认 Field Service 选项集上有任何自定义项,则此规则将失败。 向选项集添加内容不会计为失败,只会将修改选项集内的选项计为失败。

修复方法

从 Field Service 选项集中手动删除自定义项。

自定义的 Web 资源

严重性:高

检查内容

此规则检测哪些自定义的 Web 资源不属于 Field Service 包。 自定义 Web 资源不会随 Field Service 更新而更新,并且可能会导致功能问题。

失败的原因

如果存在任何不属于 Field Service 包的自定义 Web 资源,则此规则将失败。

修复方法

通过自定义的 Web 资源上的解决方案层 UI 删除自定义项。 在升级 Field Service 时,Web 资源可以正确升级。

删除 Field Service 唯一编号工作流检查

严重性:低到中等

检查内容

此规则验证批量删除自动编号工作流程是否正确运行。

失败的原因

如果 delete unique number 工作流失败,则此规则将失败。

修复方法

选择分析结果,然后选择 Resolve

删除的流程

严重性:高

检查内容

此规则检查任何已删除的进程。

失败的原因

如果删除了 Field Service 的任何现成流程,则此规则将失败。

修复方法

联系支持。

删除的 SDK 消息处理步骤

严重性:高

检查内容

此规则检查任何已删除的 SDK 消息处理步骤。

失败的原因

如果删除了任何现成的 Field Service SDK 消息处理步骤,则此规则将失败。

修复方法

联系支持。

删除的 Web 资源

严重性:高

检查内容

此规则检查任何已删除的 Web 资源。

失败的原因

如果从系统中删除了任何现成的 Field Service Web 资源,则此规则将失败。

修复方法

联系支持。

禁用的 SDK 消息处理步骤

严重性:高

检查内容

此规则检查任何已禁用的 SDK 消息处理步骤。 使用 Field Service 时,禁用的 SDK 消息处理步骤导致错误行为。

失败的原因

如果禁用了任何 Field Service SDK 消息处理步骤,则此规则将失败。

解决方法

启用已禁用的 SDK 消息处理步骤。

Field Service 预订设置元数据配置

严重性:高

检查内容

此规则验证 Field Service 预订设置元数据记录在系统中是否正确存在。 如果缺少此记录,计划功能可能无法按预期工作。

失败的原因

如果系统中不存在 Field Service 预订设置元数据记录,则此规则将失败。

修复方法

联系支持。

Field Service 设置

严重性:高

检查内容

此规则验证 Field Service 设置记录是否正确存在于系统中。

失败的原因

如果 Field Service 设置记录不存在或配置不正确,则此规则将失败。

修复方法

如果在正常使用 Field Service 期间不存在此记录,系统会重新创建此记录。 如果未自动重新生成此记录,请与支持部门联系。

窗体缺少执行上下文

严重性:高

检查内容

此规则检测系统中是否有任何表单具有引用 Field Service 库的事件处理程序,而不传递执行上下文参数。

失败的原因

此规则失败,因为 Field Service 代码需要在 OnLoad 事件处理程序中传递执行上下文参数。 如果缺少此值,则使用窗体时可能会导致错误。

备注

此规则出现故障的最常见情况是,存在以下一种现成窗体的副本(早于 8.X 的 Field Service 版本),然后升级 Field Service。 在这种情况下,从早期版本的 Field Service 中复制的这些窗体将缺少这些非现成窗体中的 ExecutionContext parameter

修复方法

  1. 在 Power Apps 中,选择 全部> 并搜索 工作订单 或 协议 。
  2. 选择表。
  3. 数据体验下,选择窗体
  4. 选择事件 选项卡。
  5. 选择每个 Event Handler 并启用 Pass execution context as first parameter
  6. 保存并发布窗体。

未完成 Field Service 升级

严重性:低

检查内容

此规则检测 Field Service 升级是否已启动但未成功完成。

失败的原因

如果 Field Service 升级已启动但未成功完成,则此规则将失败。

修复方法

重新启动 Field Service 升级。 升级成功后,此规则将重复 pass。 如果升级再次失败,请联系支持人员。

客户记录上的纬度和经度值

严重性:低

检查内容

此规则检查客户记录上是否有任何纬度或经度值。

失败的原因

如果客户记录中不存在纬度和/或经度,则此规则将失败。

修复方法

检查是否提供了客户窗体上的地址。 如果提醒,则通过选择客户窗体命令栏上的地理编码按钮对客户进行地理编码。

协议预订设置负责人的特权检查

严重性:高

检查内容

此规则检查协议预订设置记录所有者是否具有创建工作订单所需的权限。

失败的原因

如果协议预订设置所有者没有以下权限,则此规则将失败:

1.prvCreatemsdyn_workorder

修复方法

将权限分配给每个协议预订设置记录负责人。

协议账单设置负责人的特权检查

严重性:高

检查内容

此规则检查协议发票设置记录所有者是否具有创建发票所需的权限。

失败的原因

如果协议发票设置所有者没有以下权限,则此规则将失败:

1.prvCreateInvoice

修复方法

将权限分配给每个协议发票设置记录所有者。

处于草稿状态的流程定义

严重性:高

检查内容

此规则检查是否有任何流程定义处于草稿状态。 如果有处于草稿状态的流程,Field Service 将无法正常工作。

失败的原因

如果任何流程定义处于草稿状态,则此规则将失败。

修复方法

重新激活流程定义,使其不处于草稿状态。

由已禁用的用户负责的流程定义

严重性:中等到高

检查内容

此规则检查是否将任何进程定义分配给已禁用的用户。

失败的原因

如果将任何进程定义分配给已禁用的用户,则此规则将失败,这可能会导致升级失败。

修复方法

将进程的所有者更改为活动用户。

协议预订设置中的定期设置

严重性:高

检查内容

此规则检查是否在协议预订设置中配置了定期设置,以及它是否是有效的定期设置值。

失败的原因

如果协议的 系统状态 为“活动”,并且其协议预订设置记录的 自动生成工作订单 设置为“是”,但定期设置未配置或配置不正确,则此规则将失败。

修复方法

在“协议预订设置”上配置有效的重复周期并选择协议 > 协议预订设置 > 定期预订

Universal Resource Scheduling 版本兼容性检查

严重性:低

检查内容

此规则验证当前安装的 Field Service 版本是否与 Universal Resource Scheduling 版本兼容。

失败的原因

如果组织中安装的 Universal Resource Scheduling 解决方案与已安装的 Field Service 版本不兼容,则此规则将失败。 如果安装了另一个包含 Universal Resource Scheduling 解决方案的包,该包更新了 Universal Resource Scheduling 解决方案的版本,则可能会发生这种情况。

修复方法

升级警告消息中列出的解决方案,使其与 Field Service 兼容。

验证是否已启用自动编号

严重性:低

检查内容

此规则验证是否为组织选择了自动编号。 我们建议客户使用新的自动编号功能来确保 Field Service 表编号的唯一性。

失败的原因

如果组织未选择自动编号,则此规则将失败。

修复方法

在 Field Service 中选择自动编号。 在 Settings(设置 )区域中,选择 # Auto-Numbering(# 自动编号)。

验证 Field Service 和 Project Service Automation 解决方案是否兼容

严重性:低

检查内容

此规则验证当前安装的 Field Service 版本是否与安装的 Project Service Automation 版本兼容。

失败的原因

如果组织中安装的 Project Service Automation 解决方案版本与组织中安装的 Field Service 解决方案不兼容,则此规则将失败。

修复方法

升级警告消息中列出的解决方案,使其与 Field Service 兼容。

验证移动版用户安全角色

严重性:高

检查内容

此规则检查是否为有权访问 Field Service 移动应用的一线工作人员分配了 Field Service-Resource 角色和 Field Service-Resource 字段安全配置文件。

失败的原因

如果一线工作人员在没有 Field Service-Resource 角色或 Field Service-Resource 字段安全配置文件的情况下 有权访问 Field Service 移动应用,则此规则将失败。 如果组织中有多个业务部门,则会显示用户的业务部门。

修复方法

将 Field Service-Resource 安全角色和 Field Service-Resource 字段安全配置文件添加到用户。 了解更多: 设置一线工作人员

正在等待已禁用用户负责的工作流实例

严重性:高

检查内容

此规则检查是否将任何等待的工作流实例分配给已禁用的用户。 这些工作流将无法正确生成它们应该生成的记录。

失败的原因

如果将暂停的工作流分配给处于暂停状态的已禁用用户帐户,且原因为“正在等待”,则此规则将失败。

修复方法

重新触发工作流。 请参阅常规文档或联系支持部门。

后续步骤

Dynamics 365 Field Service 故障排除