工作订单表单的自定义注意事项

本文列出了在 Dynamics 365 Field Service 中自定义工作订单窗体时常见的注意事项。

以弹出窗口形式打开工作订单子网格

将工作订单子实体配置为以对话框形式弹出,然后可以无需离开工作订单窗体进行编辑。 此配置帮助调度员保持工作订单上下文。 管理员可以在设置区域中启用工作订单子网格记录以弹出窗口形式打开的设置。 有关详细信息,请参阅其他设置

显示简化的工作订单命令

工作订单命令栏默认使用简化视图,仅显示最相关的命令。 管理员可以禁用显示简化的工作订单命令设置来显示所有命令。 有关详细信息,请参阅工作订单/预订设置

您可以自定义命令栏来显示与您的上下文相关的命令。

自定义工作订单状态

工作订单系统状态绝对不能编辑,因为系统作业和插件依赖这些状态。 管理员可以创建自定义工作订单子状态,以便对应于工作订单系统状态。 有关详细信息,请参阅不编辑选项集(选择项)值

将地图添加到工作订单表单

如果从默认工单表单中手动删除地图控件,则无法将其添加回去。

若要在窗体设计器中启用“地图”按钮,至少一个类型地址的属性应该在窗体中添加掩码 ValidForMap

<DisplayMask>ValidForAdvancedFind\|ValidForForm\|ValidForGrid\|ValidForMap</DisplayMask>
  1. 在沙盒环境中创建一个解决方案,其中包括需要添加地图控件的窗体。 将其作为托管解决方案导出。

  2. 在解决方案的 customizations.xml 文件中,转到它的 formxml 部分。

  3. 将以下地图控件添加到 <controlDescriptions>

        <controlDescription forControl="{8b67ae03-1701-54d2-09be-35295876ca8a}">

        <customControl id="{4273EDBD-AC1D-40d3-9FB2-095C621B552D}">

        <parameters>

        <datafieldname>msdyn\_mapcontrol</datafieldname>

        </parameters>

        </customControl>

        <customControl formFactor="0" name="MscrmControls.Map.MapControl">

        <parameters>

        <value>msdyn\_mapcontrol</value>

        <mapSourceSwitch isGroup="true" static="true">CoordinatesGroup</mapSourceSwitch>

        <latitude>msdyn\_latitude</latitude>

        <longitude>msdyn\_longitude</longitude>

        <addressEditableSwitch isGroup="true" static="true">isAddressEditableYesGroup</addressEditableSwitch>

        <outputLatitude>msdyn\_latitude</outputLatitude>

        <outputLongitude>msdyn\_longitude</outputLongitude>

        </parameters>

        </customControl>

        <customControl formFactor="1" name="MscrmControls.Map.MapControl">

        <parameters>

        <value>msdyn\_mapcontrol</value>

        <mapSourceSwitch isGroup="true" static="true">CoordinatesGroup</mapSourceSwitch>

        <latitude>msdyn\_latitude</latitude>

        <longitude>msdyn\_longitude</longitude>

        <addressEditableSwitch isGroup="true" static="true">isAddressEditableYesGroup</addressEditableSwitch>

        <outputLatitude>msdyn\_latitude</outputLatitude>

        <outputLongitude>msdyn\_longitude</outputLongitude>

        </parameters>

        </customControl>

        <customControl formFactor="2" name="MscrmControls.Map.MapControl">

        <parameters>

        <value>msdyn\_mapcontrol</value>

        <mapSourceSwitch isGroup="true" static="true">CoordinatesGroup</mapSourceSwitch>

        <latitude>msdyn\_latitude</latitude>

        <longitude>msdyn\_longitude</longitude>

        <addressEditableSwitch isGroup="true" static="true">isAddressEditableYesGroup</addressEditableSwitch>

        <outputLatitude>msdyn\_latitude</outputLatitude>

        <outputLongitude>msdyn\_longitude</outputLongitude>

        </parameters>

        </customControl>

        </controlDescription>

  1. 在同一文件中搜索“地图”。

  2. 将带有以下代码的控件添加到需要添加的任何行和单元格中。

    <control disabled="false" id="msdyn\_mapcontrol" classid="{F9A8A302-114E-466A-B582-6771B2AE0D92}" uniqueid="{8b67ae03-1701-54d2-09be-35295876ca8a}" datafieldname="msdyn\_mapcontrol"/>
  1. 保存文件并从该文件创建一个新的托管解决方案 zip 文件。

  2. 将解决方案导入受影响的环境。

提示

如果执行这些步骤后地图控件在窗体上仍然不可见,请尝试删除活动的窗体自定义项。

新的工作订单界面的组件

新工单体验引入了多个供开发者在其表单和视图中使用的新代码组件。 以下各节列出了这些代码控件的选项和限制。 有关使用代码控件的详细信息,请参阅 Power Apps 开发人员文档中的代码控件

提示

配置字段级安全性,以确保用户仅更新预期字段。 例如,如果窗体中的字段设置为只读,用户仍可能会更新某些字段。 如果用户没有正确的字段级别安全性,则系统不会保存更新的表单。

工作订单表单

窗体页眉和命令栏

工作订单 Copilot 概括

在 Field Service 中 Copilot 的帮助下,汇总工作订单和相关预订(包括时间线注释)的控件。

此控件适用于默认和自定义工作订单窗体,但不适用于工作订单以外的其他项。

Copilot 当前无法汇总自定义字段。 它只汇总默认字段。

工作订单状态

用于选择工作订单状态和子状态的控件。

  • 您可以添加自定义系统子状态
  • 您可以在其他实体上使用状态下拉控件,但是:
    • 它不支持图标
    • 所有状态颜色均为紫色

Field Service 不支持自定义系统状态。 如果您添加一个,它不会有状态图标。 您无法更改系统状态的颜色。

工作订单优先级

用于设置工作订单优先级的控件。 它在工作订单窗体和工作订单网格上工作。

  • 您可以添加自定义优先级和颜色。
  • 您可以在工作订单窗体上使用此控件,但它不适用于除工作订单之外的实体。

时间线计数器

在时间线中显示数字注释的控件。 选择数字将转到窗体上的时间线选项卡。

  • 此控件不适用于自定义实体,即使其中包含时间线控件。
  • 此控件支持自定义工作订单窗体。

如果将此控件与时间线控件放在同一选项卡上,添加新注释时计数不会自动增加。 刷新页面可以查看更新的数字。 如果工作订单实体的活动和注释被禁用,计数始终显示零(准确显示)。

位置卡

显示完成工作的位置以及功能位置(如果有)信息的控件。

  • 此控件适用于自定义工作订单窗体,但不适用于除工作订单之外的实体。

默认缩放级别当前是固定的,您无法更改。 功能位置选取器只显示最下级实体,不显示更高级别的痕迹导航,如“建筑 > 楼层 > 房间”。

联系人卡片

显示服务或计费帐户联系人以及报告者联系人(如果可用)的控件。

  • 此控件适用于自定义工作订单窗体。 如果放在非工作订单窗体上,此控件不会进入编辑模式。

联系人可以映射到计费帐户联系人、服务帐户联系人、报告者联系人。 这不适用于任何其他类型的接触器。 指向非接联系人段时,查找不起作用。

资产卡

显示主要资产中的资产,以及通过工作订单中的产品、服务和任务设置的任何次要资产的控件。 此控件呈现资产的子节点。

此控件可以放在自定义工作订单表单上,但不能用于非工作订单实体。

如果此控件放在三列窗体布局中,不会加载用于打开全屏资产视图的图标,因为此控件会根据窄窗体规格调整。

预订卡

通过提供下一个操作建议帮助服务经理确保工作订单继续进行的控件。 对于未计划的工作订单,建议进行预订。 对于计划的工作订单,它显示预订详细信息。 完成工作订单后,它会提供摘要。

  • 此控件不适用于非工作订单实体。
  • 此控件需要正确配置系统状态、子状态和主要解决的映射。 否则,控件将无法加载。 特别是在系统状态未映射到正确的工作订单系统状态字段时。

财务摘要卡

根据与工作订单相关的产品和服务汇总工作订单的成本和价格的控件。

  • 此控件适用于自定义工作订单窗体。

确保启用成本和定价功能以查看此控件中的数据。 可以为此控件设置不同的不超过金额 (NTE) 邻近值,而不是使用为工作订单设置的值。

产品和服务子网格

让您可以编辑工作订单中的产品和服务的控件。 内联更新估计和实际持续时间和数量并更改状态。 可以在侧窗格中对字段进行详细更改。

  • 此控件适用于自定义工作订单窗体。
  • 此控件绑定到工作订单产品。 您可以选择映射第二个实体:
    • 工作订单产品:“服务”选项卡空白
    • 工作订单服务:“产品”选项卡被绑定到工作订单服务,但该选项卡仍然在界面中引用产品。
  • 此控件不适用于工单实体,因为它依赖于工单产品和工单服务这两个部分。

不支持自定义产品/服务状态值。 无法隐藏“产品”或“服务”选项卡。这两个选项卡都需要映射一个实体。

任务摘要卡

汇总工作订单中的任务的控件。

  • 此控件适用于自定义工作订单窗体。

  • 确保控件使用的视图中包含已完成百分比、估计持续时间和实际持续时间字段。

任务子网格

一个控件允许您使用在线操作来管理工作订单中的任务,能够标记任务为已完成并输入检查结果。 可以在侧窗格中对字段进行详细更改。

  • 此控件适用于自定义工作订单窗体
  • 此控件不适用于非工单实体。

如果完成百分比字段在视图中不可见,进度不会呈现,标记为完成或未完成的操作也不会起作用。

引用 > 知识文章卡

让您可以查看知识文章并将其链接到工作订单的控件。 此控件还允许您直接从工作订单创建新文章。

  • 此控件适用于自定义工作订单窗体。
  • 它无法应用于非工单实体,因为它对工单和知识文章存在强依赖性。

参考 > 指南卡片

汇总工作订单中为任务链接的 Dynamics 365 Guides 的控件。 无法预览 Web 上的指南,但可以看到其名称及其关联文件夹。

  • 此控件可用于定制的工作订单表单。
  • 此控件不能用于非工作订单实体,因为它与工作订单服务任务和工作订单实体存在硬依赖关系。

引用 > 媒体卡

用于显示附加到时间线笔记的媒体缩略图的控件。

  • 此控件适用于自定义工作订单窗体。
  • 此控件适用于自定义实体,只要该实体启用了活动和注释,并且存在时间线控件。

工作订单网格

网格和操作栏

用于查看和选择工作订单的控件。 此控件可让您对优先级进行内联编辑,并在侧窗格中进行进一步编辑。 系统状态是系统状态和子状态的组合字段。

此控件不能应用于非工单实体

已知问题和限制:

  • 将此控件应用于子网格时,视图选择器不可见。 只有你在 Maker 门户中选择的视图可见。
  • 如果您自定义了工作订单网格,由于解决方案分层规则,新控件不会呈现。 首先删除此类自定义以查看控件。
  • 新网格体验不支持列筛选。 更改为只读网格来筛选列。
  • 如果从环境中删除新网格控件,将无法再次安装。 请联系客户支持寻求帮助。
  • 已预订资源列 (msdyn_bookingsummary) 仅适用于新的工作订单体验。 经典网格视图中不支持它。

上下文菜单

当您选择工作订单以便快速执行操作时,会出现一个内联菜单。

  • 此控件对工作订单实体可用。
  • 上下文菜单选项会根据工作订单的状态改变。

您无法更改上下文菜单中的项目。

侧窗格

有多个窗体可以内联加载,以从工作订单窗体进行进一步编辑。

  • 工作订单:您可以通过修改工作订单轻量窗体来编辑侧窗格显示的信息。
  • 资产:您可以通过修改客户资产 – 简单窗体来编辑侧窗格显示的信息。

以下侧窗格呈现的窗体与打开完整记录时的窗体相同:

  • 产品:工作订单产品
  • 服务:工作订单服务
  • 任务:工单服务任务

一次只能打开一个侧窗格。 您不能更改窗格的宽度。

后续步骤