<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:
|
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 |
|---|---|
Especifica uma guia na faixa de opções. |
Elementos Pai
Elemento |
Descrição |
|---|---|
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 |
|
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