Condividi tramite

Definire azioni personalizzate per modificare la barra multifunzione

  • Articolo

 

Data di pubblicazione: gennaio 2017

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

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:

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 365 da una pagina come parametro alle azioni della barra multifunzione
Definire la scalabilità per gli elementi della barra multifunzione

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright