定义功能区显示规则
发布日期: 2017年1月
适用于: Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online
在配置功能区元素时,您可以定义用于控制何时显示功能区元素的特定规则。
使用 /RuleDefinitions/DisplayRules/<DisplayRule> (RibbonDiffXml) 元素定义控制何时显示功能区元素的规则。
使用 /CommandDefinitions/CommandDefinition/DisplayRules/<DisplayRule> (RibbonDiffXml) 元素将特定显示规则关联到命令定义。
控制何时显示功能区元素
通过在规则定义中定义显示规则,您可以针对多个命令定义使用相同的显示规则。 如果针对某个命令定义而定义了多个显示规则,那么对于要显示的功能区元素,所有显示规则的评估结果都必须为 true。
所有显示规则都会提供一个用于指定规则的默认值是 true 还是 false 的可选属性,以及在所测试的项目返回 true 时允许返回负数结果的可选 InvertResult 属性。
/RuleDefinitions/DisplayRules/DisplayRule 元素支持以下类型的规则:
<CommandClientTypeRule> (RibbonDiffXml)
指定用于检测使用中的演示类型的规则。Type 值对应于以下内容:
值
演示文稿
Modern
使用 适用于平板电脑的 Microsoft Dynamics 365 展示命令栏。
Refresh
使用更新的用户界面展示命令栏。
Legacy
功能区在未更新实体的窗体中展示,或在 Microsoft Dynamics 365 for Outlook 中的列表视图中展示。
<CrmClientTypeRule> (RibbonDiffXml)
允许根据所使用的客户端类型定义规则。Type选项如下:Web
Outlook
<CrmOfflineAccessStateRule> (RibbonDiffXml)
使用此条件根据 带脱机访问功能的 Microsoft Dynamics 365 for Microsoft Office Outlook 当前是否脱机来显示功能区元素。<CrmOutlookClientTypeRule> (RibbonDiffXml)
使用此规则仅针对特定类型的 Microsoft Dynamics 365 for Outlook 显示按钮。Type选项如下:CrmForOutlook
CrmForOutlookOfflineAccess
<CrmOutlookClientVersionRule> (RibbonDiffXml)
检测 Microsoft Dynamics 365 for Microsoft Office Outlook 版本。有效值包括:
2003
2007
2010
<EntityPrivilegeRule> (RibbonDiffXml)
使用此规则在用户对某实体具有特定权限时显示功能区元素。 您必须指定权限深度和要检查的特定权限。<EntityPropertyRule> (RibbonDiffXml)
允许根据特定实体属性的布尔值定义规则。 PropertyName选项如下:DuplicateDetectionEnabled
GridFiltersEnabled
HasStateCode
IsConnectionsEnabled
MailMergeEnabled
WorksWithQueue
HasActivities
IsActivity
HasNotes
<EntityRule> (RibbonDiffXml)
实体规则允许评估当前实体。 在定义应用于实体模板而非特定实体的自定义操作时,此功能非常有用。 例如,您可能想要将功能区元素添加到除某些特定实体以外的所有实体。 简单的做法就是,定义应用于所有实体的实体模板自定义操作,然后使用某个实体规则筛选掉那些应排除在外的实体。实体规则还包括用于指定实体是显示在窗体中还是列表中的可选上下文属性 (HomePageGrid)。 可选 AppliesTo 属性可以设置为 PrimaryEntity 或 SelectedEntity,以便区分实体是否显示在子网格中。
<FormEntityContextRule> (RibbonDiffXml)
指定一项规则,该规则可检测窗体功能区是否显示在特定实体的上下文中。<FormStateRule> (RibbonDiffXml)
使用窗体状态规则确定显示记录的窗体的当前类型。State选项如下:Create
Existing
ReadOnly
Disabled
BulkEdit
<FormTypeRule> (RibbonDiffXml)
指定用于检测 Microsoft Dynamics 365 窗体类型的规则。Type 值对应于以下内容:
值
演示文稿
Main
在应用程序中显示的实体窗体。
Preview
显示为网格中展开元素的实体预览窗体。
AppointmentBook
用于“服务计划”用户界面的约会、设备、服务约会和系统用户实体。
Dashboard
窗体定义仪表板。
Quick
快速视图窗体。
QuickCreate
快速创建窗体。
<HideForTabletExperienceRule> (RibbonDiffXml)
指定当在平板电脑设备上使用移动浏览器查看 Web 应用程序时,会返回错误的规则。<MiscellaneousPrivilegeRule> (RibbonDiffXml)
使用此规则检查不适用于特定实体(例如 ExportToExcel、MailMerge 或 GoOffline)的权限。<OrganizationSettingRule> (RibbonDiffXml)
使用此规则在启用特定组织设置时显示功能区元素。 设置选项如下:IsSharepointEnabled
IsSOPIntegrationEnabled
IsFiscalCalendarDefined
<OrRule> (RibbonDiffXml)
此规则使您可以替代针对多个显示规则类型的默认 AND 比较。 使用 OrRule 元素可定义几种可能的有效组合以进行检查。<OutlookRenderTypeRule> (RibbonDiffXml)
使用它在功能区以特定方式显示在 Microsoft Outlook 中时显示功能区元素。 Type选项如下:Web
Outlook
<OutlookVersionRule> (RibbonDiffXml)
使用它针对 Microsoft Outlook 的特定版本显示功能区元素。Version选项如下:2003
2007
2010
<PageRule> (RibbonDiffXml)
此类型的规则可检查所显示页面的 URL。 如果地址匹配,它会返回 true。<RelationshipTypeRule> (RibbonDiffXml)
此类型的规则适用于在网格中选择的记录。 它使您能够确定关系的类型,如下所示:OneToMany
ManyToMany
NoRelationship
<SkuRule> (RibbonDiffXml)
使用此规则针对 Microsoft Dynamics 365 的特定 SKU 版本显示功能区元素,如下所示:OnPremise
Online
Spla
<ValueRule> (RibbonDiffXml)
使用此规则检查窗体中所显示记录的特定字段的值。备注
对于在使用“更新用户体检”的窗体中针对子网格定义的命令,显示规则内不能使用值规则。 在 <EnableRule> (RibbonDiffXml) 内使用此元素以隐藏元素。
另请参阅
Microsoft Dynamics 365
© 2017 Microsoft。 保留所有权利。 版权