Partilhar via


<ReferencingAttributeRequiredRule> (RibbonDiffXml)

Aplica-se a: CRM 2016 on-prem, CRM Online

Uma regra que detecta se o atributo de referência de uma entidade é necessário.

Sintaxe

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

Atributos e elementos

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

Atributos

Attribute Description Type Usage

Default

Define o valor de retorno padrão da regra, caso o valor real não possa ser determinado.

Boolean

Optional

InvertResult

Nega o valor de retorno da regra.

Boolean

Optional

Elementos filho

Este elemento não tem elementos filho.

Elemento pai

Element Description

<DisplayRule> (RibbonDiffXml)

Especifica a definição de uma regra usada para exibir um elemento de Faixa de Opções ou uma referência a uma DisplayRule em uma definição de comando.

<Or> (RibbonDiffXml)

Especifica um conjunto de regras que deve ser avaliado em conjunto.

Comentários

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.

Informações do elemento

XPath

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

Schema Name

ReferencingAttributeRequiredRuleType

Validation File

RibbonTypes.xsd

Can be Empty

Yes

Consulte também

Outros recursos

Ribbon XML reference
Personalizar os comandos e a faixa de opções

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