<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.