Application Lifecycle Management della barra dei comandi

Completato

Quando si personalizza una barra dei comandi in un'app basata su modello di Microsoft Power Apps, le soluzioni Microsoft Dataverse tengono traccia di tali modifiche. Le soluzioni Dataverse consentono di spostare le personalizzazioni della barra dei comandi, l'app e i componenti correlati tra gli ambienti Microsoft Power Platform, ad esempio tra gli ambienti di sviluppo, test e produzione.

Al momento della creazione del primo comando usando la finestra di progettazione della barra dei comandi, si sceglie un tipo di comando. Questa scelta determina se è necessaria una libreria dei componenti. Una libreria dei componenti è necessaria se si usa Power Fx per le proprietà Visibility o OnSelect del comando. La finestra di dialogo seguente consente di scegliere tra Power Fx e JavaScript per la logica del comando:

Una libreria dei componenti non è necessaria se il comando usa solo JavaScript. Tuttavia, è possibile creare una libreria dei componenti in qualsiasi momento per usare Power Fx selezionando Esegui formula o Mostra in base a condizione dalla formula nel pannello delle proprietà del comando. Quando si esegue questa operazione, viene richiesto di creare la libreria dei componenti.

È consigliabile creare una soluzione Dataverse personalizzata per l'app e le risorse correlate. Se l'app è inserita in una soluzione personalizzata, lo è anche la libreria dei componenti. In caso contrario, viene inserita nella soluzione predefinita Common Data Services. Il nome della libreria dei componenti combina il nome dell'app con DefaultCommandLibrary. L'immagine seguente mostra una soluzione che include app, flussi e librerie dei componenti:

Se si personalizzano le barre dei comandi in più app usando Power Fx, ogni app ha la propria libreria dei componenti corrispondente.

Ogni libreria dei componenti contiene un componente per ogni formula Power Fx usata nei comandi della barra dei comandi. Le altre proprietà, quali etichette di visualizzazione, icone e descrizioni comando, fanno parte della configurazione dell'app basata su modello. È importante comprendere come vengono gestiti questi componenti nelle soluzioni Dataverse perché le personalizzazioni potrebbero non essere sincronizzate tra gli ambienti. Ad esempio, le modifiche apportate direttamente in un ambiente di test dopo l'importazione di una soluzione gestita possono determinare una mancata corrispondenza.

Se un comando in una barra dei comandi non presenta le modifiche più recenti, controllare i livelli della soluzione per verificare se una modifica non gestita ne sta bloccando la visibilità. In Esplora soluzioni selezionare la libreria dei componenti, quindi selezionare Avanzate > Visualizza livelli soluzione. L'immagine seguente mostra un esempio di livello non gestito sopra una soluzione gestita:

In questo esempio qualcuno ha apportato una modifica non gestita nell'ambiente. Di conseguenza, l'importazione degli aggiornamenti non verrà applicata fino a quando il livello non gestito non viene rimosso.

Apportare sempre le modifiche nell'ambiente di sviluppo per evitare livelli non gestiti non intenzionali. È anche possibile impedire le personalizzazioni impostando le proprietà gestite della libreria dei componenti in modo che non consenta personalizzazioni:

La disabilitazione delle personalizzazioni impedisce la modifica delle formule Power Fx per Visibility e OnSelect ma non limita gli aggiornamenti di altre proprietà dei comandi come Display Label. Questa limitazione ha effetto solo dopo che si esporta la soluzione come gestita e la si importa altrove. Se si tenta di modificare la libreria dei componenti dopo averla importata come gestita, verrà visualizzato il seguente errore:

Supporto per la localizzazione

Dopo che si personalizza una barra dei comandi, può essere opportuno tradurne le etichette per gli utenti in altre lingue. A tale scopo:

1. In Esplora soluzioni, selezionare Traduzioni > Esporta traduzioni.
2. Al termine dell'esportazione, viene scaricato un file ZIP.
3. Estrarre e aprire il file CrmTranslations.xml in Excel.
4. Nel foglio Localized Labels scorrere alle righe in cui Entity Name contiene "appaction".
5. Ogni comando può includere più voci per le proprietà quali testo, descrizione comando e descrizione. Immettere le traduzioni nella colonna della lingua appropriata, ad esempio 1034 per lo spagnolo.

Al termine, salvare il file e comprimere i file di traduzione. Usare Traduzione > Importa traduzioni per aggiornare la soluzione. Ripetere questo processo quando si aggiornano le etichette o si aggiungono comandi.

Le soluzioni Dataverse consentono di monitorare e spostare le personalizzazioni della barra dei comandi tra gli ambienti. Gestiscono inoltre le dipendenze, garantendo che componenti come la libreria dei componenti non vengano rimossi se sono ancora necessari per l'app. Verificare sempre che l'app e la libreria dei componenti si trovino nella stessa soluzione personalizzata prima dell'esportazione per evitare dipendenze mancanti.