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

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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> (RibbonDiffXml) para definir las reglas que controlan cuándo debe mostrarse el elemento de la cinta de opciones.

• Use el elemento /CommandDefinitions/CommandDefinition/DisplayRules/<DisplayRule> (RibbonDiffXml) 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 atributo opcional para especificar si el valor predeterminado de la regla es true o false, y un atributo 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> (RibbonDiffXml)
  Especifica una regla que detecta el tipo de presentación que se usa.

  Los valores Type corresponden a lo siguiente:

  Valor	Presentación
  Modern	La barra de comandos se muestra mediante Microsoft Dynamics 365 para tabletas.
  Refresh	La barra de comandos se muestra mediante la interfaz de usuario actualizada.
  Legacy	La cinta de opciones se muestra en los formularios de entidades que no se actualizaron o en una vista de lista en Microsoft Dynamics 365 para Outlook.

• <CrmClientTypeRule> (RibbonDiffXml)
  Permite la definición de reglas según el tipo de cliente usado. Las opciones de Type son las siguientes:

  • Web

  • Outlook

• <CrmOfflineAccessStateRule> (RibbonDiffXml)
  Use este criterio para mostrar un elemento de la cinta de opciones en función de si Microsoft Dynamics 365 para Microsoft Office Outlook con acceso sin conexión está actualmente sin conexión.

• <CrmOutlookClientTypeRule> (RibbonDiffXml)
  Use esta regla si desea mostrar un botón para el tipo específico de Microsoft Dynamics 365 para Outlook. Las opciones de Type son las siguientes:

  • CrmForOutlook

  • CrmForOutlookOfflineAccess

• <CrmOutlookClientVersionRule> (RibbonDiffXml)
  Detecta la versión de Microsoft Dynamics 365 para Microsoft Office Outlook.

  Los valores válidos son:

  • 2003

  • 2007

  • 2010

• <EntityPrivilegeRule> (RibbonDiffXml)
  Use este tipo de regla para mostrar elementos de la cinta de opciones cuando un usuario tiene privilegios específicos de una entidad. Debe especificar el nivel de privilegio y el privilegio específico que desea comprobar.

• <EntityPropertyRule> (RibbonDiffXml)
  Permite la definición de reglas según los valores booleanos de las propiedades de entidad específicas. Las opciones de PropertyName son las siguientes:

  • DuplicateDetectionEnabled

  • GridFiltersEnabled

  • HasStateCode

  • IsConnectionsEnabled

  • MailMergeEnabled

  • WorksWithQueue

  • HasActivities

  • IsActivity

  • HasNotes

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

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

• <FormEntityContextRule> (RibbonDiffXml)
  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> (RibbonDiffXml)
  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> (RibbonDiffXml)
  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 de entidad que se muestra en la aplicación.
  Preview	El formulario de vista previa de una entidad mostrada como elemento de expansión en la cuadrícula.
  AppointmentBook	Se usa con la cita, el equipamiento, serviceappointment y las entidades 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> (RibbonDiffXml)
  Especifica una regla que devuelve false cuando la aplicación web se ve en un explorador móvil en un dispositivo de tableta.

• <MiscellaneousPrivilegeRule> (RibbonDiffXml)
  Use este tipo de regla para comprobar los privilegios que no se aplican a una entidad específica, como ExportToExcel, MailMerge o GoOffline.

• <OrganizationSettingRule> (RibbonDiffXml)
  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> (RibbonDiffXml)
  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> (RibbonDiffXml)
  Use esta opción para mostrar un elemento de la cinta de opciones si la cinta se muestra en Microsoft Outlook de forma específica. Las opciones de Type son las siguientes:

  • Web

  • Outlook

• <OutlookVersionRule> (RibbonDiffXml)
  Use esto para mostrar un elemento de la cinta de opciones de una versión determinada de Microsoft Outlook. Las opciones de Version son las siguientes:

  • 2003

  • 2007

  • 2010

• <PageRule> (RibbonDiffXml)
  Este tipo de regla compruebe la dirección URL de la página que se muestra. Devuelve true si coincide la dirección.

• <RelationshipTypeRule> (RibbonDiffXml)
  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> (RibbonDiffXml)
  Use este tipo de regla para mostrar un elemento de la cinta de opciones para una versión de SKU determinada de Microsoft Dynamics 365, de la siguiente manera:

  • OnPremise

  • Online

  • Spla

• <ValueRule> (RibbonDiffXml)
  Use esta regla para comprobar el valor de un campo específico 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> (RibbonDiffXml) para ocultar un elemento.

Ver también

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

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright