Variabili di ambiente per la panoramica Power Platform

Le variabili di ambiente abilitano lo scenario ALM (Application Lifecycle Management) di base per lo spostamento di un'applicazione tra ambienti Power Platform. In questo scenario, l'applicazione rimane esattamente la stessa, ad eccezione di alcuni riferimenti chiave all'applicazione esterna (come tabelle, connessioni e chiavi) che sono diversi tra l'ambiente di origine e l'ambiente di destinazione. L'applicazione richiede che la struttura delle tabelle o delle connessioni sia esattamente la stessa tra l'ambiente di origine e quello di destinazione, con alcune differenze. Le variabili di ambiente consentono di specificare quale di questi diversi riferimenti esterni deve essere aggiornato mentre l'applicazione viene spostata tra gli ambienti.

Le variabili di ambiente archiviano le chiavi e i valori dei parametri, che servono quindi come input per vari altri oggetti dell'applicazione. La separazione dei parametri dagli oggetti di consumo consente di modificare i valori all'interno dello stesso ambiente o quando si migrano soluzioni ad altri ambienti. L'alternativa è lasciare i valori dei parametri hardcoded all'interno dei componenti che li utilizzano. Questo approccio è spesso problematico; soprattutto quando i valori devono essere modificati durante le operazioni ALM. Poiché le variabili di ambiente sono componenti della soluzione, puoi trasportare i riferimenti (chiavi) e modificare i valori quando le soluzioni vengono migrate in altri ambienti.

Vantaggi dell'uso delle variabili di ambiente:

• Specifica nuovi valori di parametro durante l'importazione di soluzioni in altri ambienti.
• Archivia la configurazione per le origine dati utilizzate nelle app e nei flussi canvas. Ad esempio, i parametri del sito e dell'elenco di SharePoint Online possono essere archiviati come variabili di ambiente; permettendoti quindi di connetterti a diversi siti ed elenchi in differenti ambienti senza la necessità di modificare app e flussi.
• Crea un pacchetto e trasporta la tua personalizzazione e configurazione insieme e gestiscile in un'unica posizione.
• Crea un pacchetto e trasporta segreti, ad esempio le credenziali utilizzate da diversi componenti, separatamente dai componenti che li utilizzano.
• Una variabile di ambiente può essere utilizzata in molti componenti della soluzione diversi, che siano dello stesso tipo di componente o diversi. Ad esempio, un'app canvas e un flusso possono utilizzare la stessa variabile di ambiente. Quando il valore della variabile di ambiente deve cambiare, è necessario modificare solo un valore.
• Inoltre, se è necessario ritirare un origine dati negli ambienti di produzione, è possibile aggiornare i valori della variabile di ambiente con le informazioni per la nuova origine dati. Le app e i flussi non richiedono modifiche e inizieranno a utilizzare la nuova origine dati.
• Supportato dagli strumenti SolutionPackager e DevOps che consentono l'integrazione continua e l'offerta continua CI/CD ().
• Le variabili di ambiente possono essere decompresse e archiviate nel controllo del codice sorgente. È inoltre possibile archiviare file di valori delle variabili di ambiente diversi per la configurazione separata necessaria in ambienti diversi. Solution Packager può quindi accettare il file corrispondente all'ambiente in cui verrà importata la soluzione.

Come funzionano le variabili di ambiente?

Le variabili di ambiente possono essere create e modificate all'interno dell'interfaccia della soluzione moderna, create automaticamente quando ci si connette a determinate origini dati nelle app canvas o utilizzando il codice. Possono anche essere importate in un ambiente tramite soluzioni. Una volta che le variabili di ambiente sono presenti in un ambiente, possono essere utilizzate come input durante la creazione di app canvas, flussi di Power Automate, durante lo sviluppo di plug-in, così come in molti altri posti come l'aggiunta di una dashboard Power BI a un'app basata su modello. Quando questi tipi di oggetti utilizzano variabili di ambiente, i valori vengono quindi derivati dalle variabili di ambiente e possono essere modificati quando le soluzioni vengono importate in altri ambienti.

Creare una variabile di ambiente in una soluzione

1. Accedi a Power Apps (make.powerapps.com) e nel riquadro a sinistra seleziona Soluzioni. Se l'elemento non si trova nel riquadro del pannello laterale, seleziona …Altro, quindi l'elemento desiderato.
2. Apri la soluzione che desideri o creane una nuova.
3. Nella barra dei comandi seleziona Nuovo>Altro, quindi Variabile di ambiente.
4. Nel riquadro di destra completa le seguenti colonne e quindi seleziona Salva:

   • Nome visualizzato. Immetti un nome per la variabile di ambiente.

   • Nome. Il nome univoco viene generato automaticamente da Nome visualizzato, ma puoi cambiarlo.

   • Tipo di dati. Scegli tra Numero decimale, Testo, JSON, Due opzioni, Origine dati o Segreto.

     Nota

     • Se Origine dati è il tipo selezionato, dovrai anche selezionare il connettore, una connessione valida per il connettore selezionato e il tipo di parametro. Tuttavia, la connessione non viene archiviata come parte della variabile di ambiente. La connessione viene utilizzata solo per recuperare i valori dei parametri disponibili come i siti SharePoint a cui hai accesso o gli elenchi associati a un sito. Per alcuni parametri come gli elenchi di SharePoint, dovrai anche selezionare una variabile di ambiente principale origine dati padre come il sito di SharePoint. Una volta salvati, questi saranno correlati nel database.
     • Se il tipo selezionato è Segreto, informazioni aggiuntive per impostare e configurare Azure Key Vault sono necessarie per consentire a Power Platform di accedere al segreto.

   • Current Value. Conosciuto anche come valore. Questa proprietà è facoltativa e fa parte della tabella dei valori delle variabili di ambiente. Quando è presente un valore verrà utilizzato, anche se è presente anche un valore predefinito. Rimuovi il valore dalla soluzione se non desideri utilizzarlo nel prossimo ambiente. I valori sono inoltre separati in file JSON diversi all'interno del file solution.zip esportato e possono essere modificati offline. Altre informazioni: Come rimuovo un valore da una variabile di ambiente?

   • Valore predefinito. Questa colonna fa parte della tabella di definizione delle variabili di ambiente e non è obbligatoria. Il valore predefinito viene utilizzato se non è presente alcun valore corrente.

     La separazione del valore predefinito e del valore corrente consente di servire la definizione e il valore predefinito separatamente dal valore. Ad esempio, un editore di un'applicazione può elencare la propria offerta su AppSource con un valore predefinito. Quindi, facoltativamente, il cliente può fornire un nuovo valore. Quando l'editore dell'applicazione pubblica gli aggiornamenti all'applicazione, il valore impostato dal cliente non verrà sovrascritto.

     

     Nota

     Un valore non può esistere senza una definizione. L'interfaccia consente solo la creazione di un valore per definizione.

Immettere nuovi valori durante l'importazione delle soluzioni

La moderna interfaccia di importazione della soluzione include la possibilità di immettere valori per le variabili di ambiente. Imposta la proprietà value nella tabella environmentvariablevalue.

A partire dall'aggiornamento del 7 dicembre 2023, tutti i valori delle variabili di ambiente saranno visibili durante l'importazione di soluzioni (o quando si utilizzano Pipelines per eseguire l'implementazione). Alle variabili di ambiente senza un valore o un valore predefinito verrà richiesto un valore, ma quelle altrimenti vengono precompilate con un'etichetta sotto l'area di testo che indica l'origine del valore: valore della soluzione, valore dell'ambiente di destinazione o valore predefinito.

Notifiche

Viene visualizzata una notifica quando le variabili di ambiente non hanno un valore. Questo è un promemoria per impostare i valori in modo che i componenti dipendenti dalle variabili di ambiente non generino errori.

Sicurezza

La tabella environmentvariabledefinition è di proprietà dell'utente o del team. Quando crei un'applicazione che utilizza le variabili di ambiente, assicurati di assegnare agli utenti il livello di privilegio appropriato a questa tabella. L'autorizzazione per la tabella environmentvariablevalue viene ereditata dalla tabella environmentvariabledefinition padre e quindi non richiede privilegi separati. I privilegi per le tabelle environmentvariabledefinition sono inclusi nei ruoli di sicurezza Autore dell'ambiente e Utente semplice per impostazione predefinita. Altre informazioni: Sicurezza in Dataverse.

Denominazione

Assicurati che i nomi delle variabili di ambiente siano univoci in modo che possano essere referenziati con precisione. I nomi visualizzati delle variabili di ambiente duplicati rendono le variabili di ambiente difficili da differenziare e utilizzare. Assicurati che i nomi delle variabili di ambiente siano univoci in modo che possano essere referenziati con precisione. I nomi $authentication e $connection sono parametri appositamente riservati per i flussi e devono essere evitati. Il salvataggio del flusso è bloccato se vengono utilizzate variabili di ambiente con quei nomi. Se una variabile d'ambiente viene utilizzata in un flusso e il nome visualizzato della variabile d'ambiente viene modificato, la finestra di progettazione mostrerà sia il vecchio che il nuovo token del nome visualizzato per semplificare l'identificazione. Quando si aggiorna il flusso, consigliamo di rimuovere il riferimento alla variabile di ambiente e aggiungerlo di nuovo.

Limitazioni correnti

• La convalida dei valori delle variabili di ambiente avviene all'interno delle interfacce utente e nei componenti che le utilizzano, ma non all'interno di Dataverse. Pertanto, assicurati che i valori corretti siano impostati se vengono modificati tramite codice.
• Le attività degli strumenti di creazione di Power Platform non sono ancora disponibili per la gestione delle variabili d'ambiente origine dati. Tuttavia, non ne viene bloccato l'utilizzo all'interno degli strumenti forniti da Microsoft e nei sistemi di controllo del codice sorgente.
• L'interazione con le variabili di ambiente tramite codice personalizzato richiede una chiamata API per recuperare i valori; non esiste una cache esposta per il codice non Microsoft da sfruttare.
• Per utilizzare con successo le variabili di ambiente con elenchi SharePoint, il nome visualizzato e il nome logico per ciascuna colonna corrispondente negli ambienti di origine e di destinazione devono corrispondere.
• Le variabili di ambiente sono limitate a un massimo di 2.000 caratteri.

Domande frequenti

Perché non riesco a vedere il valore della mia variabile di ambiente?

Se la variabile di ambiente è in soluzione gestita, non sarai in grado di vedere il valore a meno che non guardi all'interno della Soluzione predefinita. Questo comportamento è legato alla progettazione, poiché il valore della variabile di ambiente è una personalizzazione non gestita.

Come posso vedere dove vengono utilizzate le variabili di ambiente?

Tramite la selezione di Mostra dipendenze nell'interfaccia della soluzione, durante la creazione di componenti o nel controllo del codice sorgente e nel file della soluzione visualizzando l'app o i metadati del flusso.

Le variabili d'ambiente origine dati sono le stesse delle connessioni?

Nr. Sebbene siano correlate a una connessione rappresentano una credenziale o un'autenticazione richiesta per interagire con il connettore. Le variabili di ambiente origine dati memorizzano i parametri richiesti da una o più azioni nel connettore e questi parametri spesso variano a seconda dell'azione. Ad esempio, una connessione di SharePoint Online non archivia alcuna informazione su siti, elenchi o raccolte di documenti. Pertanto la chiamata al connettore richiede sia una connessione valida sia alcuni parametri aggiuntivi.

Le variabili di ambiente origine dati possono essere utilizzate con connessioni condivise come SQL Server con autenticazione SQL?

Generalmente no. Le connessioni condivise con SQL Server archiviano i parametri necessari per connettersi ai dati all'interno della connessione. Ad esempio, il nome del server e del database vengono forniti durante la creazione della connessione e quindi sono sempre derivati dalla connessione.

Le variabili di ambiente origine dati vengono utilizzate per i connettori che si basano sull'autenticazione basata sull'utente come Microsoft Entra ID perché i parametri non possono essere derivati dalla connessione. Per questi motivi l'autenticazione con SQL Server, che è una connessione condivisa, non utilizzerà le variabili di ambiente origine dati.

La mia pipeline ALM automatizzata può utilizzare file di valori diversi per ambienti diversi?

Sì. Solution Packager accetta il nome del file come parametri di input in modo che la pipeline possa comprimere un file di valori diversi nella soluzione a seconda del tipo di ambiente in cui viene eseguito.

Dovrei includere il valore nella mia soluzione?

Nr. Le variabili ambiente sono destinate ad essere utilizzate da applicazioni che necessitano di avere valori diversi nei diversi ambienti in cui viene distribuita la soluzione. Le definizioni della variabile ambiente devono essere incluse nella soluzione, ma i valori devono essere forniti per la destinazione ambiente durante la distribuzione. Questo comportamento fa sì che la definizione della variabile ambiente sia un oggetto origine dati nella destinazione ambiente, mentre la variabile ambiente è un record non gestito.

Perché non posso eliminare un valore nel mio ambiente?

Se il valore è stato incluso in un soluzione gestita, l'unico modo per eliminarlo è aggiornare la soluzione nel file ambiente di origine per escludere il valore, quindi esportare una nuova versione della soluzione. Questa nuova versione può quindi essere importata nell'ambiente usando un'operazione di aggiornamento versione (non un aggiornamento), con conseguente eliminazione del record del valore.

Cosa succede se qualcuno elimina inavvertitamente un valore?

Se non è già stato impedito dal sistema di dipendenze, il runtime usa l'ultimo valore noto come fallback.

Se un valore viene modificato, quando viene utilizzato il nuovo valore nelle app canvas e nei flussi cloud?

Potrebbe essere necessaria fino a un'ora per pubblicare completamente le variabili di ambiente aggiornate perché il valore viene inserito nelle app e scorre in modo asincrono.

Sono necessarie licenze premium?

Nr. Mentre ALM richiede Dataverse (o app Dynamics 365), non è richiesto l'uso di connettori premium. L'unico requisito è se stai usando il connettore Dataverse per interagire con le variabili di ambiente come faresti con altri record di dati come account o contatti. In precedenza questo era l'unico modo per utilizzare le variabili di ambiente nelle app e nei flussi di canvas.

Esiste un limite al numero di variabili di ambiente di cui posso disporre?

Nr. Tuttavia, la dimensione massima di una soluzione è 95 MB. Ulteriori informazioni: Creare una soluzione

È possibile localizzare i nomi e le descrizioni di visualizzazione delle variabili di ambiente?

Sì.

Devo utilizzare le variabili di ambiente invece di memorizzare i dati di configurazione in tabelle personalizzate?

Sì se i dati di configurazione non sono relazionali. Le variabili di ambiente dovrebbero essere utilizzate per le coppie chiave: valore e quando il valore probabilmente deve essere diverso in altri ambienti. Altri strumenti come l'utilità di migrazione della configurazione sono più adatti per la migrazione dei dati di configurazione relazionali archiviati nelle tabelle personalizzate. A differenza di altri dati di configurazione, le variabili di ambiente vengono migrate all'interno delle soluzioni e quindi molto più semplici da gestire e più performanti da importare.

Perché la mia connessione non viene salvata per le variabili origine dati ambiente?

Le connessioni vengono utilizzate solo per generare l'interfaccia utente. Ad esempio, per recuperare nomi descrittivi per elenchi SharePoint associati a un sito. Quando si modifica una variabile origine dati ambiente, assicurarsi di creare una connessione con accesso a Seleziona. Se non hai più accesso alla connessione, puoi inserire manualmente un valore. Ad esempio, immetti l'URL del sito SharePoint o l'identificatore univoco (GUID) di un elenco.

Quando sono disponibili più connessioni per una singola variabile (tipo origine dati) ambiente, esiste un'implementazione predefinita per Seleziona la prima connessione nell'elenco delle connessioni. Poiché di solito c'è solo una connessione associata a una variabile di ambiente, di solito deve essere convalidata. Inoltre, con le recenti modifiche alla visibilità del valore della variabile di ambiente, è più facile da convalidare al momento dell'importazione.

Come rimuovo un valore da una variabile di ambiente?

È possibile che tu intenda rimuovere il valore di una variabile di ambiente dalla soluzione prima di esportare la soluzione. Quindi, il valore esistente rimane nell'ambiente di sviluppo, ma non viene esportato nella soluzione. Questo approccio consente di fornire un nuovo valore durante l'importazione della soluzione in un altro ambiente.

Per rimuovere il valore, segui la procedura riportata di seguito:

1. Nella soluzione in cui si trova la variabile di ambiente seleziona la variabile di ambiente per visualizzare le proprietà.

2. In Valore corrente, seleziona ...>Rimuovi dalla soluzione.

   

Posso usare le variabili di ambiente in connettori personalizzati?

Sì. Supporto variabile di ambiente in connettori personalizzati

Vedi anche

Utilizzare le variabili di ambiente origine dati nelle app canvas
Utilizzare le variabili di ambiente nei flussi cloud della soluzione Power Automate
Riferimento alla tabella/entità EnvironmentVariableDefinition
Esempi di API Web
Usare variabili di ambiente dell'origine dati in app Canvas
Usare variabili di ambiente nei flussi cloud della soluzione Power Automate
Usare i segreti di Azure Key Vault
Supporto delle variabili di ambiente nei connettori personalizzati
Blog di Power Apps: variabili di ambiente disponibili in anteprima!