Compartir a través de

<ContextualGroup> (RibbonDiffXml)

  • Artículo

 

Publicado: noviembre de 2016

Se aplica a: Dynamics CRM 2015

Contiene una recopilación de pestañas para mostrarse 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

Identificador

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

Requerido.

Secuencia

Especifique la ubicación de la modificación de la cinta de opciones. Para ello, defina el valor de secuencia más alto o más bajo que los elementos de la cinta de opciones existentes.

Entero

Opcional

Título

Este elemento no es obligatorio en Microsoft Dynamics CRM.

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 para incluirse 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 CRM 2015 y actualización de Microsoft Dynamics CRM Online 2015 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

© 2017 Microsoft. Todos los derechos reservados. Copyright