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

项目
12/05/2023

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

作为弹出窗口打开工作订单子网格

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

显示简化的工作订单命令

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

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

自定义工作订单状态

工作订单系统状态应该从不编辑，因为系统作业和插件依赖这些状态。管理员可以改为创建自定义工作订单子状态，映射到工作订单系统状态。有关详细信息，请参阅不编辑选项集（选择项）值。

将必应地图添加到工作订单窗体

如果从现成工作订单窗体中手动删除必应地图控件，则无法将其添加回来。

要在窗体设计器中启用必应地图按钮，至少有一个地址类型属性应该在窗体中添加了掩码 ValidForMap。

<DisplayMask>ValidForAdvancedFind\|ValidForForm\|ValidForGrid\|ValidForMap</DisplayMask>

在沙盒环境中创建一个解决方案，其中包括需要添加必应地图控件的窗体。将其作为托管解决方案导出。
在解决方案的 customizations.xml 文件中，转到它的 formxml 部分。
将以下地图控件添加到 <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>

在同一个文件中搜索“必应地图”。
将带有以下代码的控件添加到需要添加的任何行和单元格中。

    <control disabled="false" id="msdyn\_mapcontrol" classid="{F9A8A302-114E-466A-B582-6771B2AE0D92}" uniqueid="{8b67ae03-1701-54d2-09be-35295876ca8a}" datafieldname="msdyn\_mapcontrol"/>

保存文件并从该文件创建一个新的托管解决方案 zip 文件。
将解决方案导入受影响的环境。

小费

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

新工作订单体验的组件

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

小费

配置字段级安全性，以确保用户只更新所需的字段。在某些情况下，例如，如果窗体中的字段设置为只读，用户可能仍会更新某些字段。但是，如果用户没有正确的字段级安全性，系统将不会保存更新的窗体。

工作订单窗体

窗体页眉和命令栏

页眉：完全可自定义。制作者可以更改 Maker Portal 中显示的信息。还可以隐藏部分或选项卡，以及创建自己的自定义选项卡。
窗体切换器：制作者可以根据安全角色控制用户可以看到的窗体。
命令栏：默认使用简化的命令栏。管理员可以关闭显示简化工作订单命令设置。如果自定义添加的命令不存在，您可以转到 Maker Portal，使其再次可见

工作订单 Copilot 概括

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

此控件适用于默认和自定义工作订单窗体，但不适用于除工作订单之外的实体。

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

工作订单状态

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

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

Field Service 不支持自定义系统状态。如果您添加，将没有状态图标。您无法更改系统状态的颜色。

工作订单优先级

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

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

时间线计数

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

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

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

位置卡

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

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

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

联系人卡

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

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

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

资产卡

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

此控件可以放在自定义工作订单窗体，但不适用于非工作订单实体。

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

预订卡

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

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

财务摘要卡

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

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

确保启用成本和定价功能以查看此控件中的数据。您可以为此控件设置不同于为工作订单设置的 NTE 邻近值。

产品和服务子网格

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

此控件适用于自定义工作订单窗体。请记住以下限制。
此控件绑定到工作订单产品。您可以选择映射第二个实体：
- 工作订单产品：“服务”选项卡空白
- 工作订单服务：“产品”选项卡被绑定到工作订单服务，但该选项卡仍然在界面中引用产品。
此控件不适用于工作订单实体，因为它依赖于工作订单产品和工作订单服务。

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

任务摘要卡

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

此控件适用于自定义工作订单窗体。
确保控件使用的视图中包含已完成百分比、估计持续时间和实际持续时间字段。

任务子网格

允许您使用内联操作管理工作订单中的任务，以将任务标记为完成并输入检查结果的控件。可以在侧窗格中对字段进行详细更改。

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

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

引用 > 知识文章卡

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

此控件适用于自定义工作订单窗体。
它不适用于非工作订单实体，因为它严重依赖工作订单和知识文章。

引用 > 指南卡

将链接的 Dynamics 365 Guides 汇总到工作订单中任务的控件。您无法从 Web 预览指南，但可以看到它们的名称和关联的文件夹。

此控件可用于自定义工作订单窗体。
此控件不能用于非工作订单实体，因为它严重依赖工作订单服务任务和工作订单实体。

引用 > 媒体卡

显示已附加到时间线注释的媒体缩略图的控件。

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

工作订单网格

网格和操作栏

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

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

已知问题和限制：

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

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

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

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

侧窗格

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

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

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

产品：工作订单产品
服务：工作订单服务
任务：工作订单服务任务

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

通过