Share via

<ContextualGroup> (RibbonDiffXml)

  • Articolo

 

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Contiene una raccolta di schede da visualizzare in un contesto specifico.

Sintassi

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

Attributi ed elementi

Nella seguente tabella vengono elencati gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo

Descrizione

Tipo

Uso

Colore

Specifica una combinazione di colori per il gruppo.

I valori validi includono:

  • Nessuno

  • Blu scuro

  • Blu chiaro

  • Verde acqua

  • Arancione

  • Verde

  • Magenta

  • Giallo

  • Viola

Enumerazione

Facoltativi

Command

Specifica l'ID del comando della barra multifunzione per il controllo.

Stringa

Facoltativi

ContextualGroupId

Una stringa che identifica il gruppo contestuale, ad esempio Mscrm.VisualizationTools.

Stringa

Facoltativi

ID

Specifica un identificatore univoco per la definizione di un elemento della barra multifunzione. La convenzione di denominazione consigliata è l'utilizzo di un punto per separare le parti del nome, come segue: [identificatore soluzione].[entità].[barra multifunzione].[funzione].[nome elemento]. Ad esempio: MyISV.account.form.SendToOtherSystem.Button.

Utilizzare il token {!EntityLogicalName} nell'attributo id quando viene definito un elemento della barra multifunzione che verrà utilizzato per più entità. Verrà inserito il nome logico dell'entità nel valore ID per assicurare che il valore ID sia univoco a livello globale.

Ad esempio, se si utilizza MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button con l'entità account, l'ID sarà MyISV.account.form.SendToOtherSystem.Button. Per l'entità del contatto, l'ID sarà MyISV.contact.form.SendToOtherSystem.Button.

Importante

Se non si imposta un valore dell'identificativo univoco, la barra multifunzione potrebbe non essere visualizzata.

Stringa

Necessari

Sequenza

Specifica la posizione della modifica della barra multifunzione impostando il parametro Sequence su un valore più alto o più basso degli elementi esistenti della barra multifunzione.

Intero

Facoltativi

il titolo

Questo elemento non è utilizzato in Microsoft Dynamics 365.

Stringa

Facoltativi

Elementi figlio

Elemento

Descrizione

<Tab> (RibbonDiffXml)

Specifica una scheda nella barra multifunzione.

Elementi padre

Elemento

Descrizione

<CommandUIDefinition> (RibbonDiffXml)

Specifica gli elementi della barra multifunzione visibili da includere in un elemento CustomAction.

Osservazioni

Quando si esporta un ContextualGroup precedentemente definito è possibile che venga visualizzato ContextualGroup e viene eseguito il refactoring di tutti gli elementi <Tab> (RibbonDiffXml) contenuti in elementi <CustomAction> (RibbonDiffXml) separati. Questo errore è causato dal modo in cui vengono archiviati i dati da Microsoft Dynamics 365 (online e locale) nel database. Questo non modifica il comportamento originale della definizione.

Ad esempio, se si definisce un oggetto <CustomAction> (RibbonDiffXml) per aggiungere un ContextualGroup come illustrato nella seguente pseudo frammento di codice:

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

Quando vengono successivamente esportate le personalizzazioni dell'esportazione inclusi la definizione, bisogna aspettarsi che la definizione venga visualizzata nel seguente pseudo frammento di codice:

<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>

Informazioni sull'elemento

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/ContextualGroup

Nome schema

ContextualGroupType

File di convalida

RibbonWSS.xsd

Può essere vuoto

Sì

Vedere anche

Personalizzare i comandi e la barra multifunzione
Ribbon XML reference

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright