Freigeben über


<ReferencingAttributeRequiredRule> (RibbonDiffXml)

Betrifft: CRM 2016 on-prem, CRM Online

Eine Regel, die feststellt, ob das verweisende Attribut für eine Entität erforderlich ist.

Syntax

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

Attribute und Elemente

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

Attribute

Attribute Description Type Usage

Default

Legt den standardmäßigen Rückgabewert für die Regel fest, wenn der tatsächliche Wert nicht ermittelt werden kann.

Boolean

Optional

InvertResult

Negiert den Rückgabewert der Regel.

Boolean

Optional

Untergeordnete Elemente

Diese Element verfügt nicht über untergeordnete Elemente.

Übergeordnete Elemente

Element Description

<DisplayRule> (RibbonDiffXml)

Gibt entweder die Definition einer Regel zum Anzeigen eines Menübandelements oder einen Verweis auf eine DisplayRule aus einer Befehlsdefinition an.

<Or> (RibbonDiffXml)

Gibt einen Satz von Regeln an, die zusammen ausgewertet werden müssen.

Anmerkungen

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.

Elementinformationen

XPath

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

Schema Name

ReferencingAttributeRequiredRuleType

Validation File

RibbonTypes.xsd

Can be Empty

Yes

Siehe auch

Weitere Ressourcen

Ribbon XML reference
Anpassen von Befehlen und des Menübands

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