使用功能区显示规则控制功能区元素的显示时间,因此命令仅在相应的客户端、窗体、表或用户上下文中显示。
- 使用
/RuleDefinitions/DisplayRules/DisplayRule元素定义用于控制何时显示功能区元素的规则。 - 使用元素将
/CommandDefinitions/CommandDefinition/DisplayRules/DisplayRule特定的显示规则与命令定义相关联。
控制何时显示功能区元素
通过在规则定义中定义显示规则,可以对许多命令定义使用相同的显示规则。 为命令定义定义定义多个显示规则时,所有显示规则都必须计算为 true,才能显示功能区元素。
所有显示规则都提供一个可选参数,用于指定规则的默认值是 true 还是 false,以及一个可选 InvertResult 参数,以便在测试的项返回 true 时返回负结果。
该 /RuleDefinitions/DisplayRules/DisplayRule 元素支持以下类型的规则:
<CommandClientTypeRule>
指定一个规则,用于检测正在使用的演示文稿的类型。
这些 Type 值对应于以下内容:
| 价值 | 演示 |
|---|---|
Modern |
命令栏使用适用于平板电脑的 Dynamics 365 显示。 |
Refresh |
命令栏使用更新的用户界面显示。 |
Legacy |
功能区以表格的形式显示,这些表未更新,或在Outlook Dynamics 365的列表视图中显示。 |
<CrmClientTypeRule>
根据使用的客户端类型定义规则。
Type 选项包括:
WebOutlook
<CrmOfflineAccessStateRule>
使用此条件可基于脱机访问Microsoft Office Outlook Dynamics 365当前是否处于脱机状态来显示功能区元素。
<CrmOutlookClientTypeRule>
如果要为Outlook的特定类型Dynamics 365显示按钮,请使用此规则。
Type 选项如下所示:
CrmForOutlookCrmForOutlookOfflineAccess
<CrmOutlookClientVersionRule>
检测Microsoft Office Outlook的Microsoft Dynamics 365版本。
有效值:
200320072010
<EntityPrivilegeRule>
当用户具有表的特定权限时,请使用此类规则显示功能区元素。 必须指定要检查的权限深度和特定权限。
<EntityPropertyRule>
使用此规则可以根据特定表属性的布尔值定义规则。 选项 PropertyName 包括:
DuplicateDetectionEnabledGridFiltersEnabledHasStateCodeIsConnectionsEnabledMailMergeEnabledWorksWithQueueHasActivitiesIsActivityHasNotes
<EntityRule>
使用此规则评估当前表。 定义应用于表模板而不是特定表的自定义操作时,此规则非常有用。 例如,你可能希望向除某些特定表之外的所有表添加功能区元素。 为应用于所有表的表模板定义自定义操作更容易,然后使用筛选器 EntityRule 筛选出要排除的表模板。
其中包括 EntityRule 一个可选上下文参数,用于指定表是以窗体还是列表(HomePageGrid)显示。 将可选 AppliesTo 参数 PrimaryEntity 设置为或 SelectedEntity 区分表是否显示在子网格中。
<FormEntityContextRule>
指定一个规则,该规则可以检测窗体功能区是否显示在特定实体的上下文中。
<FormStateRule>
使用窗体状态规则确定显示记录的当前窗体类型。
State 选项如下所示:
CreateExistingReadOnlyDisabledBulkEdit
<FormTypeRule>
指定一个规则,用于检测Microsoft Dynamics 365窗体的类型。
这些 Type 值对应于以下内容:
| 价值 | 演示 |
|---|---|
Main |
应用程序中显示的窗体。 |
Preview |
表格预览窗体显示为网格中的展开元素。 |
AppointmentBook |
用于服务计划用户界面的约会、设备、serviceappointment 和 systemuser 表。 |
Dashboard |
表单定义仪表板。 |
Quick |
快速视图窗体。 |
QuickCreate |
快速创建窗体。 |
<HideForTabletExperienceRule>
指定在平板电脑设备上的移动浏览器中查看 Web 应用程序时将返回 false 的规则。
<MiscellaneousPrivilegeRule>
使用此规则检查不适用于特定表的权限,例如 ExportToExcel、MailMerge 或 GoOffline。
<OrganizationSettingRule>
如果启用了特定组织设置,请使用此规则显示功能区元素。 设置选项包括:
IsSharepointEnabledIsSOPIntegrationEnabledIsFiscalCalendarDefined
<OrRule>
使用此规则可替代多个显示规则类型的默认 AND 比较。 使用 OrRule 元素定义多个可能的有效组合进行检查。
<OutlookRenderTypeRule>
如果功能区以特定方式以Outlook显示,请使用此规则显示功能区元素。 选项 Type 包括:
WebOutlook
<OutlookVersionRule>
使用此规则可显示特定版本的Outlook的功能区元素。 选项 Version 包括:
200320072010
<PageRule>
此规则检查所显示页面的 URL。 如果地址匹配,则返回 true。
<ReferencingAttributeRequiredRule>
一个规则,用于检测实体的引用属性是否是必需的。
此规则适用于非常具体的情况。 当页面上有关系绑定的子网格或关联的网格时,请使用此规则。 此规则测试关系中使用的引用属性是否是必需的。 使用此规则可隐藏“ 添加现有 记录类型”按钮(如果不适合显示它)。
在实体关系中,可能需要相关记录(引用属性)中的查阅字段。 例如,不需要活动的 “关于 ”字段,但需要机会的 “潜在客户 ”字段。 “ 添加现有活动 ”按钮将 “关于 ”字段值设置为当前记录上下文,并且仅当 “关于 ”字段还没有值时,它才能正常工作。 所有机会记录在其 “潜在客户 ”字段中都有一个值,因此显示 “添加现有机会 ”按钮永远不会有意义。 此规则检测到引用属性是必需的,并返回 true。
<RelationshipTypeRule>
将此规则应用于网格中选择的记录。 它允许你确定关系的类型,如下所示:
OneToManyManyToManyNoRelationship
<SkuRule>
使用此规则可显示特定 SKU 版本Microsoft Dataverse的功能区元素,如下所示:
OnPremiseOnlineSpla
<ValueRule>
使用此规则检查窗体中显示的记录中特定列的值。
注释
对于使用更新的用户体验为表单定义的子网格的命令,无法在显示规则中使用值规则。 使用此元素隐藏 <EnableRule> 元素。