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

Nota

Este tema trata sobre comandos clásicos.

Hay una nueva forma de definir comandos. Consulte Información general de los comandos modernos (versión preliminar)

Al configurar los elementos de la cinta de opciones se pueden definir las reglas específicas para supervisar cuándo se mostrarán los elementos de la cinta de opciones.

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

Controlar cuándo se muestran los 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. Cuando más de una regla de visualización está definida 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 InvertResult opcional para habilitar la devolución de un resultado negativo cuando el elemento que se está probando 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:

Value	Presentación
Modern	La barra de comandos se muestra mediante Dynamics 365 for tablets.
Refresh	La barra de comandos se muestra mediante la interfaz de usuario actualizada.
Legacy	La cinta de opciones se muestra en los formularios de tablas que no se actualizaron o en una vista de lista en Dynamics 365 for Outlook.

<CrmClientTypeRule>

Permite la definición de reglas según el tipo de cliente usado. Las opciones de Type son las siguientes:

• 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 más reciente 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>

Permite la definición de reglas según los valores booleanos de las propiedades de tabla específicas. Las opciones de PropertyName son las siguientes:

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

<EntityRule>

Esta regla de la entidad permiten la evaluación de la tabla actual. Esto resulta útil al definir acciones personalizadas que se aplican a la plantilla de la tabla en lugar de a las tablas específicas. Por ejemplo, es posible que desee agregar un elemento de la cinta de opciones en todas las tablas excepto en algunas tablas específicas. Es más fácil definir la acción personalizada de la plantilla de la tabla que se aplica a todas las tablas y después usar una regla EntityRule para filtrar aquellas que se deben excluir.

Las reglas EntityRule también incluyen un parámetro de contexto opcional para especificar si se muestra la tabla en el formulario o en una lista (HomePageGrid). El parámetro opcional AppliesTo se puede establecer en PrimaryEntity o en SelectedEntity para distinguir si se muestra la tabla en una subcuadrícula.

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

• Crear
• Existente
• Solo lectura
• Deshabilitada
• BulkEdit

<FormTypeRule>

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

Los valores Type corresponden a lo siguiente:

valor	Presentación
Main	Un formulario que se muestra en la aplicación.
Preview	El formulario de vista previa de una tabla mostrada como elemento de expansión en la cuadrícula.
AppointmentBook	Se usa con la cita, el equipamiento, serviceappointment y las tablas de systemuser para la interfaz de usuario Programación de servicios.
Dashboard	El formulario define un panel.
Quick	Formulario de vista rápida.
QuickCreate	Formulario de creación rápida.

<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 este tipo de regla para comprobar los privilegios que no se aplican a una tabla específica, como ExportToExcel, MailMerge o GoOffline.

<OrganizationSettingRule>

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

• IsSharepointEnabled
• IsSOPIntegrationEnabled
• IsFiscalCalendarDefined

<OrRule>

Esta regla le permite reemplazar el valor de comparación predeterminado AND para varios tipos de reglas de visualización. Use el elemento OrRule para definir varias combinaciones posibles válidas para comprobar.

<OutlookRenderTypeRule>

Use esta opción para mostrar un elemento de la cinta de opciones si la cinta se muestra en Outlook de forma específica. Las opciones de Type son las siguientes:

• Web
• Outlook

<OutlookVersionRule>

Use esto para mostrar un elemento de la cinta de opciones de una versión determinada de Outlook. Las opciones de Version son las siguientes:

• 2003
• 2007
• 2010

<PageRule>

Este tipo de regla compruebe 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 es una regla muy específica para un caso muy concreto. Utilice esta regla cuando haya una subcuadrícula vinculada a una relación o una cuadrícula asociada en la página. Esta regla comprobará si el atributo de referencia utilizado en la relación es obligatorio. Esta regla se utiliza para ocultar el botón Agregar tipo de registro existente cuando no es apropiado mostrarlo.

En una relación entre entidades, el campo de búsqueda en el registro relacionado (el atributo de referencia) puede ser obligatorio o no. Por ejemplo, el campo Respecto a una actividad no es obligatorio, pero el campo Cliente potencial de una oportunidad sí lo es. El botón Agregar actividad existente establecerá el valor del campo En relación al contexto del registro actual y solo puede funcionar si el campo En relación no tiene un valor. Todos los registros de Oportunidad tienen un valor en su campo Cliente potencial, por lo que nunca tiene sentido mostrar un botón Agregar oportunidad existente. Esta regla detecta que el atributo de referencia es obligatorio y, por lo tanto, devuelve verdadero.

<RelationshipTypeRule>

Este tipo de regla se aplica 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 este tipo de regla para mostrar un elemento de la cinta de opciones para una versión de SKU determinada de Microsoft Dataverse, de la siguiente manera:

• OnPremise
• En línea
• Spla

<ValueRule>

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

Nota

Para los comandos definidos para la subcuadrícula en formularios con la experiencia de usuario actualizada, no se pueden usar las reglas de valor dentro de reglas de visualización. Use este elemento en un <EnableRule> para ocultar un elemento.

Consultar también

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

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).