Definire azioni personalizzate per modificare la barra multifunzione
Data di pubblicazione: novembre 2016
Si applica a: Dynamics CRM 2015
Per impostazione predefinita, una barra dei comandi o una barra multifunzione dell'applicazione è definita dai metadati di Microsoft Dynamics 365. I dati predefiniti non possono essere modificati, tuttavia è possibile includere le definizioni di azioni specifiche che consentiranno di sostituire la barra multifunzione predefinita.
Tipi di azioni personalizzate
Esistono due tipi di azioni personalizzate per le barre multifunzione:
<CustomAction> (RibbonDiffXml): Definisce un'azione per aggiungere o sostituire gli elementi nella barra multifunzione.
<HideCustomAction> (RibbonDiffXml) : Rimuove un elemento esistente della barra multifunzione dall'elaborazione per la barra multifunzione.
Azioni personalizzate
Un'azione personalizzata è una dichiarazione di come si desidera modificare la definizione predefinita della barra multifunzione. Viene valutata e applicata alla barra multifunzione in fase di esecuzione. Per impostare il contesto per un'azione personalizzata, è necessario includere le informazioni sulla posizione degli elementi che si desidera modificare. Utilizzare l'attributo Location per specificare la posizione della modifica.
Quando si aggiunge un nuovo elemento della barra multifunzione, si fa riferimento all'elemento che lo contiene, ad esempio, una scheda o un gruppo esistente. Quindi, si include il suffisso ._children per indicare che questa azione personalizzata aggiungerà qualcosa a un elemento esistente.
Quando si modifica la definizione di un elemento esistente, il valore di Location corrisponderà all'ID di tale elemento.
È inoltre necessario specificare un identificatore univoco per l'azione personalizzata. Utilizzare l'attributo ID per impostare questo valore. È consigliabile utilizzare una convenzione di denominazione che garantisca un valore univoco. Per assicurare coerenza e leggibilità, è consigliabile utilizzare un punto per separare i componenti coerenti. Il primo elemento nella convenzione di denominazione deve essere correlato all'autore della propria soluzione o alla soluzione, ad esempio Contoso.contact.form.CustomButton.CustomAction.
Suggerimento
L'applicazione coerente delle convenzioni di denominazione dell'attributo Id migliora notevolmente la produttività durante la modifica di RibbonDiffXml.
In base alle informazioni sulla posizione fornite, il valore dell'attributo Sequence determina l'ordine in cui eseguire il rendering degli elementi. Se si desidera inserire un controllo personalizzato tra due controlli esistenti, è necessario selezionare un valore di sequenza tra i valori di sequenza degli elementi esistenti.
Nascondere le azioni personalizzate
Un'azione <HideCustomAction> (RibbonDiffXml) è un'istruzione che viene utilizzata quando si desidera rimuovere un elemento esistente della barra multifunzione affinché non ne venga eseguito il rendering. In questo modo l'elemento della barra multifunzione non viene nascosto, ma viene invece eliminato in fase di esecuzione affinché non esista più nella barra.
Nota
Poiché l'elemento HideCustomAction rimuove un nodo specificato dalla barra multifunzione, questa modalità di rimozione degli elementi della barra multifunzione non può essere la scelta ideale per ogni situazione.
-
Se si desidera rimuovere un pulsante associato un privilegio specifico, è consigliabile modificare i privilegi dell'entità per i ruoli di sicurezza dell'implementazione. Questo consente di utilizzare la visualizzazione predefinita della barra multifunzione e di abilitare le regole per nascondere o disabilitare gli elementi della barra multifunzione per gli utenti che non dispongono dei privilegi necessari per eseguire tali azioni.
-
Se si desidera sostituire un elemento esistente della barra multifunzione con un elemento personalizzato, è possibile sovrascrivere tale elemento specificando un valore di CustomAction.Location identico all'elemento esistente.
L'elemento HideActionId offre un ID univoco per l'azione. Per assicurare coerenza e leggibilità, è consigliabile seguire la stessa convenzione di denominazione descritta per gli elementi <CustomAction>. L'attributo Location deve corrispondere all'ID dell'elemento della barra multifunzione che si desidera rimuovere.
Vedere anche
Personalizzare i comandi e la barra multifunzione
Passare i dati di Microsoft Dynamics CRM da una pagina come parametro alle azioni della barra multifunzione
Definire la scalabilità per gli elementi della barra multifunzione
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright