Partilhar via


<ContextualGroup> (RibbonDiffXml)

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Contém uma coleção de guias a serem exibidas em um contexto específico.

Sintaxe

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

Atributos e Elementos

A tabela a seguir lista os atributos, os elementos filho e elementos principais.

Atributos

Atributo

Descrição

Tipo

Uso

Cor

Especifica um esquema de cores para o grupo.

Os valores válidos incluem:

  • Nenhum(a)

  • DarkBlue

  • LightBlue

  • Teal

  • Orange

  • Verde

  • Magenta

  • Yellow

  • Purple

Enumeração

Opcional

Comando

Especifica a ID do comando da faixa de opções deste controle.

Cadeia de caracteres

Opcional

ContextualGroupId

Uma cadeia de caracteres que identifica o grupo contextual, como Mscrm.VisualizationTools.

Cadeia de caracteres

Opcional

ID

Especifica um identificador exclusivo para a definição de um elemento da faixa de opções. A convenção de nomenclatura recomendável é usar um ponto para separar as partes do nome, como: [identificador da solução].[entidade].[faixa de opções].[função].[nome do elemento]. Por exemplo: MyISV.account.form.SendToOtherSystem.Button.

Use o token {!EntityLogicalName} no atributo Id quando você definir um elemento da faixa de opções que será usado para várias entidades. Isso insere o nome lógico da entidade no valor Id para garantir que o valor de ID é globalmente exclusivo.

Por exemplo, se você usar MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button com a entidade conta, a Id será MyISV.account.form.SendToOtherSystem.Button. Para a entidade de contato, a Id será MyISV.contact.form.SendToOtherSystem.Button.

Importante

Se você não definir um valor de Id exclusivo global, a faixa de opções não pode ser exibida.

Cadeia de caracteres

Obrigatório

Sequência

Especifica o local da modificação da faixa de opções definindo o valor da Sequência como um número mais alto ou mais baixo que os elementos existentes da faixa de opções.

Inteiro

Opcional

seu Cargo

Este elemento não é usado no Microsoft Dynamics 365.

Cadeia de caracteres

Opcional

Elementos Filho

Elemento

Descrição

<Tab> (RibbonDiffXml)

Especifica uma guia na faixa de opções.

Elementos Pai

Elemento

Descrição

<CommandUIDefinition> (RibbonDiffXml)

Especifica os elementos visíveis da Faixa de Opções a serem incluídos no elemento CustomAction.

Comentários

Quando você exporta um ContextualGroup que tiver definido anteriormente, você pode ver que ContextualGroup e os elementos <Tab> (RibbonDiffXml) que contém são refatorados em elementos <CustomAction> (RibbonDiffXml) separados. Isso ocorre devido ao modo como o Microsoft Dynamics 365 (online e local) armazena os dados no banco de dados. Não altera o comportamento da definição original.

Por exemplo, se você definir um <CustomAction> (RibbonDiffXml) para adicionar um ContextualGroup conforme mostrado no pseudo trecho de código:

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

Quando você exportar personalizações posteriormente incluindo essa definição, você deve esperar que a definição aparecerá conforme mostrado no pseudo trecho 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>

Informações do Elemento

XPath

//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/ContextualGroup

Nome do Esquema

ContextualGroupType

Arquivo de Validação

RibbonWSS.xsd

Pode estar vazio

Sim

Confira Também

Personalizar os comandos e a faixa de opções
Ribbon XML reference

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais