Defina las reglas de la visualización de la cinta de opciones

Use reglas de presentación de la cinta de opciones para controlar cuándo aparecen los elementos de la cinta, por lo que los comandos solo se muestran en el cliente, formulario, tabla o contexto de usuario adecuados.

• Use el /RuleDefinitions/DisplayRules/DisplayRule elemento para definir reglas que controlan cuándo mostrar el elemento de la cinta de opciones.
• Use el /CommandDefinitions/CommandDefinition/DisplayRules/DisplayRule elemento para asociar reglas de visualización específicas con una definición de comando.

Controlar cuándo mostrar elementos de la cinta de opciones

Al definir las reglas de visualización en las definiciones de reglas, se puede usar la misma regla de visualización para muchas definiciones de comando. Al definir más de una regla de visualización para una definición de comando, todas las reglas de visualización deben evaluarse como true para que se muestre el elemento de la cinta de opciones.

Todas las reglas de visualización proporcionan un parámetro opcional para especificar si el valor predeterminado de la regla es true o false, y un parámetro opcional InvertResult para habilitar la devolución de un resultado negativo cuando el elemento que se prueba devuelve true.

El elemento /RuleDefinitions/DisplayRules/DisplayRule admite los siguientes tipos de reglas:

<CommandClientTypeRule>

Especifica una regla que detecta el tipo de presentación que se usa.

Los valores Type corresponden a lo siguiente:

<CrmClientTypeRule>

Defina reglas basadas en el tipo de cliente usado. Type las opciones son:

• Web
• Outlook

<CrmOfflineAccessStateRule>

Use este criterio para mostrar un elemento de la cinta de opciones en función de si Dynamics 365 for Microsoft Office Outlook con acceso sin conexión está actualmente sin conexión.

<CrmOutlookClientTypeRule>

Use esta regla si desea mostrar un botón para el tipo específico de Dynamics 365 for Outlook. Las opciones de Type son las siguientes:

• CrmForOutlook
• CrmForOutlookOfflineAccess

<CrmOutlookClientVersionRule>

Detecta la versión de Microsoft Dynamics 365 for Microsoft Office Outlook.

Los valores válidos son:

• 2003
• 2007
• 2010

<EntityPrivilegeRule>

Use este tipo de regla para mostrar elementos de la cinta de opciones cuando un usuario tiene privilegios específicos de una tabla. Debe especificar el nivel de privilegio y el privilegio específico que desea comprobar.

<EntityPropertyRule>

Use esta regla para definir reglas basadas en los valores booleanos de propiedades de tabla específicas. Las PropertyName opciones son:

• DuplicateDetectionEnabled
• GridFiltersEnabled
• HasStateCode
• IsConnectionsEnabled
• MailMergeEnabled
• WorksWithQueue
• HasActivities
• IsActivity
• HasNotes

<EntityRule>

Use esta regla para evaluar la tabla actual. Esta regla es útil cuando se definen acciones personalizadas que se aplican a la plantilla de tabla en lugar de tablas específicas. Por ejemplo, es posible que quiera agregar un elemento de cinta de opciones a todas las tablas, excepto para algunas tablas específicas. Es más fácil definir la acción personalizada para la plantilla de tabla que se aplica a todas las tablas y, a continuación, usar un EntityRule para filtrar los que desea excluir.

EntityRule incluye un parámetro de contexto opcional para especificar si la tabla se muestra en el formulario o en una lista (HomePageGrid). Establezca el parámetro PrimaryEntity opcional AppliesTo en o SelectedEntity para distinguir si la tabla se muestra en una subgrid.

<FormEntityContextRule>

Especifica una regla que puede detectar si una cinta de opciones de un formulario se muestra en el contexto de una entidad específica.

<FormStateRule

Use la regla de estado de formulario para determinar el tipo actual de formulario que se muestra en un registro. Las opciones de State son las siguientes:

• Create
• Existing
• ReadOnly
• Disabled
• BulkEdit

<FormTypeRule>

Especifica una regla que detecta el tipo de formulario de Microsoft Dynamics 365.

Los valores Type corresponden a lo siguiente:

<HideForTabletExperienceRule>

Especifica una regla que devuelve false cuando la aplicación web se ve en un explorador móvil en un dispositivo de tableta.

<MiscellaneousPrivilegeRule>

Use esta regla para comprobar los privilegios que no se aplican a una tabla específica, como ExportToExcel, MailMerge o GoOffline.

<OrganizationSettingRule>

Use esta regla para mostrar un elemento de la cinta de opciones si está habilitada la configuración específica de la organización. Las opciones de configuración son:

• IsSharepointEnabled
• IsSOPIntegrationEnabled
• IsFiscalCalendarDefined

<OrRule>

Use esta regla para invalidar la comparación AND predeterminada para varios tipos de reglas de visualización. Use el elemento OrRule para definir varias combinaciones posibles válidas para comprobar.

<OutlookRenderTypeRule>

Use esta regla para mostrar un elemento de la cinta de opciones si la cinta de opciones se muestra de Outlook de una manera específica. Las Type opciones son:

• Web
• Outlook

<OutlookVersionRule>

Use esta regla para mostrar un elemento de la cinta de opciones para una versión específica de Outlook. Las Version opciones son:

• 2003
• 2007
• 2010

<PageRule>

Esta regla comprueba la dirección URL de la página que se muestra. Devuelve true si coincide la dirección.

<ReferencingAttributeRequiredRule>

Una regla que detecta si el atributo de referencia para una entidad es obligatorio.

Esta regla es para un caso muy específico. Use esta regla cuando haya una subgrid enlazada a una relación o una cuadrícula asociada en la página. Esta regla comprueba si se requiere el atributo de referencia utilizado en la relación. Use esta regla para ocultar el botón Agregar tipo de registro existente cuando no sea adecuado para mostrarla.

En una relación de entidad, el campo de búsqueda del registro relacionado (el atributo de referencia) podría ser necesario o no. Por ejemplo, el campo Con respecto a una actividad no es necesario, pero se requiere el campo Cliente potencial de una oportunidad. El botón Agregar actividad existente establece el valor del campo Con respecto al contexto de registro actual y solo puede funcionar si el campo Con respecto no tiene aún un valor. Todos los registros de oportunidades tienen un valor en su campo Posible cliente , por lo que nunca tiene sentido mostrar un botón Agregar oportunidad existente . Esta regla detecta que se requiere el atributo de referencia y devuelve true.

<RelationshipTypeRule>

Aplique esta regla a los registros seleccionados en una cuadrícula. Le permite determinar el tipo de relación, de la siguiente manera:

• OneToMany
• ManyToMany
• NoRelationship

<SkuRule>

Use esta regla para mostrar un elemento de la cinta de opciones para una versión específica de SKU de Microsoft Dataverse, como se indica a continuación:

• OnPremise
• Online
• Spla

<ValueRule>

Use esta regla para comprobar el valor de una columna específica en el registro mostrado en el formulario.

Consultar también

Personalización de comandos y la cinta de opciones
Definir las reglas de habilitación de la cinta de opciones
Definir acciones de la cinta de opciones