定义功能区显示规则

注释

本主题介绍经典命令。

有一种定义命令的新方法。 请参阅新式命令概述(预览版)。

使用功能区显示规则控制功能区元素的显示时间,因此命令仅在相应的客户端、窗体、表或用户上下文中显示。

  • 使用 /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 选项包括:

  • Web
  • Outlook

<CrmOfflineAccessStateRule>

使用此条件可基于脱机访问Microsoft Office Outlook Dynamics 365当前是否处于脱机状态来显示功能区元素。

<CrmOutlookClientTypeRule>

如果要为Outlook的特定类型Dynamics 365显示按钮,请使用此规则。 Type 选项如下所示:

  • CrmForOutlook
  • CrmForOutlookOfflineAccess

<CrmOutlookClientVersionRule>

检测Microsoft Office Outlook的Microsoft Dynamics 365版本。

有效值:

  • 2003
  • 2007
  • 2010

<EntityPrivilegeRule>

当用户具有表的特定权限时,请使用此类规则显示功能区元素。 必须指定要检查的权限深度和特定权限。

<EntityPropertyRule>

使用此规则可以根据特定表属性的布尔值定义规则。 选项 PropertyName 包括:

  • DuplicateDetectionEnabled
  • GridFiltersEnabled
  • HasStateCode
  • IsConnectionsEnabled
  • MailMergeEnabled
  • WorksWithQueue
  • HasActivities
  • IsActivity
  • HasNotes

<EntityRule>

使用此规则评估当前表。 定义应用于表模板而不是特定表的自定义操作时,此规则非常有用。 例如,你可能希望向除某些特定表之外的所有表添加功能区元素。 为应用于所有表的表模板定义自定义操作更容易,然后使用筛选器 EntityRule 筛选出要排除的表模板。

其中包括 EntityRule 一个可选上下文参数,用于指定表是以窗体还是列表(HomePageGrid)显示。 将可选 AppliesTo 参数 PrimaryEntity 设置为或 SelectedEntity 区分表是否显示在子网格中。

<FormEntityContextRule>

指定一个规则,该规则可以检测窗体功能区是否显示在特定实体的上下文中。

<FormStateRule>

使用窗体状态规则确定显示记录的当前窗体类型。 State 选项如下所示:

  • Create
  • Existing
  • ReadOnly
  • Disabled
  • BulkEdit

<FormTypeRule>

指定一个规则,用于检测Microsoft Dynamics 365窗体的类型。

这些 Type 值对应于以下内容:

价值 演示
Main 应用程序中显示的窗体。
Preview 表格预览窗体显示为网格中的展开元素。
AppointmentBook 用于服务计划用户界面的约会、设备、serviceappointment 和 systemuser 表。
Dashboard 表单定义仪表板。
Quick 快速视图窗体。
QuickCreate 快速创建窗体。

<HideForTabletExperienceRule>

指定在平板电脑设备上的移动浏览器中查看 Web 应用程序时将返回 false 的规则。

<MiscellaneousPrivilegeRule>

使用此规则检查不适用于特定表的权限,例如 ExportToExcel、MailMerge 或 GoOffline。

<OrganizationSettingRule>

如果启用了特定组织设置,请使用此规则显示功能区元素。 设置选项包括:

  • IsSharepointEnabled
  • IsSOPIntegrationEnabled
  • IsFiscalCalendarDefined

<OrRule>

使用此规则可替代多个显示规则类型的默认 AND 比较。 使用 OrRule 元素定义多个可能的有效组合进行检查。

<OutlookRenderTypeRule>

如果功能区以特定方式以Outlook显示,请使用此规则显示功能区元素。 选项 Type 包括:

  • Web
  • Outlook

<OutlookVersionRule>

使用此规则可显示特定版本的Outlook的功能区元素。 选项 Version 包括:

  • 2003
  • 2007
  • 2010

<PageRule>

此规则检查所显示页面的 URL。 如果地址匹配,则返回 true。

<ReferencingAttributeRequiredRule>

一个规则,用于检测实体的引用属性是否是必需的。

此规则适用于非常具体的情况。 当页面上有关系绑定的子网格或关联的网格时,请使用此规则。 此规则测试关系中使用的引用属性是否是必需的。 使用此规则可隐藏“ 添加现有 记录类型”按钮(如果不适合显示它)。

在实体关系中,可能需要相关记录(引用属性)中的查阅字段。 例如,不需要活动的 “关于 ”字段,但需要机会的 “潜在客户 ”字段。 “ 添加现有活动 ”按钮将 “关于 ”字段值设置为当前记录上下文,并且仅当 “关于 ”字段还没有值时,它才能正常工作。 所有机会记录在其 “潜在客户 ”字段中都有一个值,因此显示 “添加现有机会 ”按钮永远不会有意义。 此规则检测到引用属性是必需的,并返回 true。

<RelationshipTypeRule>

将此规则应用于网格中选择的记录。 它允许你确定关系的类型,如下所示:

  • OneToMany
  • ManyToMany
  • NoRelationship

<SkuRule>

使用此规则可显示特定 SKU 版本Microsoft Dataverse的功能区元素,如下所示:

  • OnPremise
  • Online
  • Spla

<ValueRule>

使用此规则检查窗体中显示的记录中特定列的值。

注释

对于使用更新的用户体验为表单定义的子网格的命令,无法在显示规则中使用值规则。 使用此元素隐藏 <EnableRule> 元素。

另见

自定义命令和功能区
定义功能区启用规则
定义功能区操作