<ReferencingAttributeRequiredRule> (RibbonDiffXml)

应用到: CRM 2016 on-prem, CRM Online

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

语法

<ReferencingAttributeRequiredRule 
 Default=["0" | "1" | "true" | "false"]
 InvertResult=["0" | "1" | "true" | "false"]
 />

属性和元素

The following describes the attributes, child elements, and parent elements.

属性

Attribute Description Type Usage

Default

如果无法确定实际值,则设置规则的默认返回值。

Boolean

Optional

InvertResult

对此规则的返回值求反。

Boolean

Optional

子元素

此元素没有子元素。

父元素

Element Description

<DisplayRule> (RibbonDiffXml)

指定用于显示功能区元素的规则定义或指定对命令定义中的 DisplayRule 的引用。

<Or> (RibbonDiffXml)

指定一组必须一起评估的规则。

备注

This is a very specific rule for a very specific case. Use this rule when there is a relationship bound subgrid or an associated grid on the page. This rule will test whether the referencing attribute used in the relationship is required. This rule is used to hide the Add Existing <record type> button when it isn’t appropriate to display it.

In an entity relationship the lookup field in the related record (the referencing attribute) may be required or not. For example, the Regarding field of an activity is not required yet the Potential Customer field of an opportunity is required. The Add Existing Activity button will set the Regarding field value to the current record context and it can only work if the Regarding field doesn’t already have a value. All Opportunity records have a value in their Potential Customer field, so it never makes sense to display an Add Existing Opportunity button. This rule detects that the referencing attribute is required and therefore returns true.

元素信息

XPath

//RibbonDiffXml/RuleDefinitions/DisplayRules/DisplayRule/ReferencingAttributeRequiredRule
|
//RibbonDiffXml/RuleDefinitions/DisplayRules/DisplayRule/OrRule/Or/ReferencingAttributeRequiredRule

Schema Name

ReferencingAttributeRequiredRuleType

Validation File

RibbonTypes.xsd

Can be Empty

Yes

另请参阅

其他资源

Ribbon XML reference
自定义命令和功能区

Microsoft Dynamics CRM 2016 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.