Panoramica delle variabili di ambiente

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.

Nota

Nuove funzionalità per le origini dati sono in fase di implementazione e potrebbero non essere ancora disponibili nella tua area geografica.

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 funziona?

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.

Nota

• In alcuni casi, per valori specifici della variabile di ambiente dell'origine dati, potrebbe essere visualizzato un avviso Accesso negato se il produttore importatore non ha accesso alla connessione o all'origine utilizzata per la variabile di ambiente. Questo è un avviso non bloccante, ma qualcosa di cui prendere nota a seconda di come prevedi di utilizzare la variabile di ambiente nell'ambiente di destinazione.
• È possibile rimuovere il valore dalla soluzione prima di esportare la soluzione. In questo modo si garantisce che il valore esistente rimanga 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. 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.

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?

No. Sebbene siano correlati. Una connessione rappresenta 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.

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 Dynamics 365 for Customer Engagement), 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 è 120 MB. Vedi 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é un valore di connessione diverso da quello che desidero viene assegnato automaticamente durante l'importazione?

In alcuni casi in cui 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 disponibili per la variabile di ambiente. 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 tabella/entità EnvironmentVariableDefinition
Esempi di API Web
Utilizzare le variabili di ambiente dell'origine dati nelle app canvas
Utilizzare le variabili di ambiente nei flussi cloud della soluzione Power Automate
Utilizzare i segreti di Azure Key Vault
Supporto variabile di ambiente in connettori personalizzati
Blog Power Apps: Variabili d'ambiente disponibili in anteprima!

Nota

Puoi indicarci le tue preferenze di lingua per la documentazione? Partecipa a un breve sondaggio. (il sondaggio è in inglese)

Il sondaggio richiederà circa sette minuti. Non viene raccolto alcun dato personale (Informativa sulla privacy).