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 di gestione del ciclo di vita dell'applicazione (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 SharePoint Online e dell'elenco possono essere archiviati come variabili di ambiente. Questo approccio ti consente di connetterti a siti ed elenchi diversi in ambienti diversi senza dover modificare le app e i 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 moderna della soluzione. Possono anche essere create automaticamente quando ci si connette a determinate origini dati nelle app canvas o con codice. Possono anche essere importate in un ambiente tramite soluzioni. Le variabili di ambiente possono essere utilizzate come input durante la creazione di app canvas, flussi Power Automate, plug-in e l'aggiunta di dashboard Power BI alle app basate su modello. Quando usi le 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 manualmente 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 selezionare il connettore, una connessione valida per il connettore selezionato e il tipo di parametro. La connessione non viene archiviata come parte della variabile di ambiente. La variabile di ambiente archivia le informazioni non presenti nella connessione necessarie per connettere Power Apps al server e alla tabella corretti. 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.

     • 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. Un valore definito 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.

Power Apps può creare automaticamente variabili di ambiente

Nella scheda Generale delle impostazioni di Power Apps:

• Abilitare l'opzione Crea automaticamente variabili di ambiente durante l'aggiunta di origini dati. Ora, quando aggiungi una nuova origine dati alla tua app, viene aggiunta automaticamente una variabile di ambiente.

  

Origini dati diverse

Origini dati diverse abilitano tipi diversi di variabili di ambiente.

Microsoft Dataverse

Power Apps si connette in modo nativo a Dataverse. Non hai bisogno di una variabile di ambiente per le tabelle nell'ambiente corrente. Quando ti connetti a Dataverse, l'applicazione cerca automaticamente esattamente lo stesso nome di tabella in qualsiasi ambiente in cui viene convertita. Finché la struttura del nome della tabella è la stessa nell'ambiente di destinazione e nell'ambiente originale, funziona.

Se si utilizza una tabella esterna da un ambiente diverso (tramite Modifica ambiente), Power Apps presume che si desidera fare sempre riferimento alla stessa identica tabella. È necessaria una variabile di ambiente se la tabella esterna deve essere una tabella esterna diversa quando passi da ambienti di sviluppo ad ambienti di test o produzione. È il modo più semplice per consentire a Power Apps di creare automaticamente la variabile di ambiente. Se in precedenza hai aggiunto la tabella all'app, attiva l'interruttore delle impostazioni, elimina la tabella esterna e quindi aggiungila di nuovo.

Quando aggiungi la tabella esterna alla tua app, scegli la scheda Avanzate per selezionare la variabile di ambiente.

SharePoint

SharePoint supporta solo connessioni Microsoft Entra. Pertanto, per SharePoint, oltre a una connessione valida, è necessaria una variabile di ambiente separata per Sito ed Elenco.

Per utilizzare correttamente le variabili di ambiente con gli elenchi SharePoint:

• Il nome visualizzato e il nome logico per ogni colonna corrispondente negli ambienti di origine e di destinazione devono corrispondere.
• Le variabili di ambiente per SharePoint devono avere metadati corrispondenti. SharePoint ha identificatori interni che potrebbero non corrispondere tra gli ambienti di destinazione. Ad esempio, se crei semplicemente un elenco con lo stesso nome e colonne in un ambiente di destinazione, è probabile che i nomi interni non corrispondano. I metadati corrispondono sempre se duplichi un sito SharePoint e lo copi nell'ambiente di destinazione.

SQL Server

SQL Server supporta diversi tipi di autenticazione e connessioni. Usa le variabili di ambiente per le connessioni Microsoft Entra. È necessaria una variabile di ambiente separata per il server e il database. L'applicazione è associata a nomi di tabella specifici, quindi si presuppone che siano gli stessi tra gli ambienti.

Non usare variabili di ambiente per connessioni condivise come autenticazione SQL di base con SQL Server. Utilizzare i riferimenti a una connessione per le informazioni che vengono tradizionalmente passate come parte della stringa di connessione. I parametri di autenticazione SQL di base fanno tutti parte della stringa di 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 dell'origine dati vengono usate per i connettori con funzionalità di autenticazione come Microsoft Entra. In questi tipi di connessioni, Power Apps ha solo un utente identificato. Power Apps non può derivare quale servizio o tabella intendi usare dalla connessione.

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.

I valori delle variabili di ambiente sono visibili durante l'importazione di soluzioni o quando si usano le pipeline per la distribuzione. Le variabili di ambiente senza un valore predefinito o un valore richiedono un valore, ma in caso contrario 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.

Nota

• In alcuni casi, per specifici valori delle variabili di ambiente dell'origine dati, potrebbe essere visualizzato un avviso di Accesso negato se l'autore dell'importazione non ha accesso alla connessione o all'origine usata per la variabile di ambiente. Si tratta di un avviso non bloccante, ma di qualcosa da prendere in considerazione a seconda di come prevedi di usare la variabile di ambiente nell'ambiente di destinazione.
• È possibile rimuovere il valore dalla soluzione prima di esportare la soluzione. Ciò garantisce che il valore esistente rimarrà nell'ambiente di sviluppo, ma non verrà esportato nella soluzione. Questo approccio consente di fornire un nuovo valore durante l'importazione della soluzione in altri ambienti. Altre informazioni: Come rimuovo un valore da una variabile di ambiente?

Notifiche

Viene visualizzata una notifica quando le variabili di ambiente non hanno un valore. 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.
• 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.

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 di ambiente sono destinate a essere utilizzate dalle applicazioni che necessitano di valori diversi nei diversi ambienti in cui viene distribuita la soluzione. Le definizioni delle variabili di ambiente devono essere incluse nella soluzione, ma i valori devono essere forniti per l'ambiente di destinazione durante la distribuzione. Questo comportamento fa sì che la definizione della variabile d'ambiente sia un oggetto di soluzione gestita nell'ambiente di destinazione, mentre la variabile d'ambiente è un record non gestito.

Perché non posso eliminare un valore nel mio ambiente?

Se il valore è stato incluso in una soluzione gestita, l'unico modo per eliminarlo è aggiornare la soluzione nell'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 di ambiente dell'origine dati?

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 d'ambiente di un'origine dati, assicurarsi di selezionare una connessione con accesso all'origine dati. 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 di ambiente (tipo origine dati), esiste un'implementazione predefinita per selezionare 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!