Share via

<ContextualGroup> (RibbonDiffXml)

  • Artículo

 

Publicado: enero de 2017

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

Contiene una colección de pestañas que se mostrarán en un contexto específico.

Sintaxis

<ContextualGroup
 Color=[ "None" | "DarkBlue" | "LightBlue" | "Teal" | "Orange" | "Green" | "Magenta" | "Yellow" | "Purple"]
 Command="String"
 ContextualGroupId="String"
 Id="String"
 Sequence="Integer"
 Title="String" >
  <Tab />
</ContextualGroup>

Atributos y elementos

La tabla siguiente muestra los atributos, los elementos secundarios, y los elementos principales.

Atributos

Atributo

Descripción

Tipo

Uso

Color

Especifica una combinación de colores para el grupo.

Los valores válidos son:

  • Ninguna

  • DarkBlue

  • LightBlue

  • Teal

  • Orange

  • Verde

  • Magenta

  • Yellow

  • Purple

Enumeración

Opcional

Comando

Especifica el identificador del comando de la cinta de opciones de este control.

Cadena

Opcional

ContextualGroupId

Una cadena que identifica el grupo contextual, como Mscrm.VisualizationTools.

Cadena

Opcional

Id.

Especifica un identificador único para la definición de un elemento de la cinta de opciones. La convención de nomenclatura más recomendada es la de usar un punto para separar las partes del nombre como: [identificador de solución].[entidad].[cinta de opciones].[función].[nombre de elemento]. Por ejemplo: MyISV.account.form.SendToOtherSystem.Button.

Use el token de {!EntityLogicalName} en el atributo de identificador al definir un elemento de la cinta de opciones que se usará para varias entidades. Esto inserta el nombre lógico de la entidad en el valor de identificador para asegurarse de que el valor de identificador es único globalmente.

Por ejemplo, si usa MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button con la entidad de cuenta, el identificador será MyISV.account.form.SendToOtherSystem.Button. Para la entidad de contacto, el identificador será MyISV.contact.form.SendToOtherSystem.Button.

Importante

Si no establece un valor de identificador único globalmente, la cinta de opciones no puede mostrarse.

Cadena

Obligatorios

Secuencia

Especifique la ubicación de la modificación de la cinta de opciones. Para ello, defina un valor de Secuencia mayor o menor que el de los elementos de la cinta de opciones existentes.

Entero

Opcional

Puesto

Este elemento no se usa en Microsoft Dynamics 365.

Cadena

Opcional

Elementos secundarios

Elemento

Descripción

<Tab> (RibbonDiffXml)

Especifica una pestaña en la cinta de opciones.

Elementos primarios

Elemento

Descripción

<CommandUIDefinition> (RibbonDiffXml)

Especifica los elementos visibles de la cinta de opciones que se incluirán en un elemento CustomAction.

Comentarios

Cuando exporta un ContextualGroup que definió anteriormente puede ver que el ContextualGroup y los elementos de <Tab> (RibbonDiffXml) que contiene se refactorizan en elementos separados de <CustomAction> (RibbonDiffXml). Esto se debe a la forma en que Microsoft Dynamics 365 (en línea y local) almacena los datos en la base de datos. No modifica el comportamiento de la definición original.

Por ejemplo, si define <CustomAction> (RibbonDiffXml) para agregar un ContextualGroup como se muestra en el siguiente pseudofragmento de código:

<CustomAction Location='Mscrm.ContextualGroups._children' >   <CommandUIDefinition>      <ContextualGroup Id='CG1'>         <Tab Id='T1'>...</Tab>         <Tab Id='T2'>...</Tab>      </ContextualGroup>   </CommandUIDefinition></CustomAction>

Cuando posteriormente exporte personalizaciones que incluyan esta definición, deberá esperar que la definición aparezca como se muestra en el siguiente pseudofragmento de código:

<CustomAction Location='Mscrm.ContextualGroups._children' >   <CommandUIDefinition>      <ContextualGroup Id='CG1' />   </CommandUIDefinition></CustomAction><CustomAction Location='CG1._children'>   <CommandUIDefinition>      <Tab Id='T1'>...</Tab>   </CommandUIDefinition></CustomAction><CustomAction Location='CG1._children'>   <CommandUIDefinition>      <Tab Id='T2'>...</Tab>   </CommandUIDefinition></CustomAction>

Información de elemento

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/ContextualGroup

Nombre de esquema

ContextualGroupType

Archivo de validación

RibbonWSS.xsd

Puede estar vacío

Sí

Ver también

Personalizar los comandos y la cinta de opciones
Ribbon XML reference

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright