Utilizzare le variabili d'ambiente della sorgente dati nelle app canvas

In questo articolo vengono fornite informazioni sull'uso delle variabili di ambiente dell'origine dati nelle app canvas. Puio usare le variabili di ambiente dell'origine dati pre-esistente oppure creare le variabili di ambiente dell'origine dati automaticamente durante la connessione ai dati.

Utilizzare le variabili di ambiente origine dati preesistenti

È possibile riutilizzare le variabili di ambiente tra altre app e anche tra diversi tipi di risorse, ad esempio i flussi cloud. Potresti voler prima crearli all'interno della soluzione e usarli in un secondo momento durante la creazione di app canvas e flussi cloud. I passaggi seguenti usano SharePoint Online come esempio.

1. Segui i passaggi precedenti per creare manualmente una variabile d'ambiente in una soluzione.
2. Modifica o crea un'app canvas dalla tua soluzione.
3. Aggiungi una nuova origine dati per SharePoint Online.
4. Selezionare la scheda Avanzate . Viene visualizzato un elenco filtrato di variabili di ambiente disponibili a cui si ha accesso e che corrispondono al parametro impostato. Ad esempio, quando si seleziona il sito di SharePoint, l'elenco contiene variabili di ambiente dell'origine dati con Connector come SharePoint e Tipo di parametro come sito. Lo stesso vale quando si selezionano gli elenchi SharePoint per un determinato sito. Se non viene visualizzata una variabile esistente, vedere Limitazioni e risoluzione dei problemi.
5. Seleziona le variabili di ambiente desiderate, quindi seleziona Connetti.

Creare automaticamente variabili di ambiente origine dati durante la connessione ai dati

Questa opzione offre semplicità e garantisce che le variabili di ambiente vengano sempre usate per le origini dati, ad esempio SharePoint Online. Tuttavia, alcuni clienti preferiscono fornire i propri nomi di schema e pertanto dovrebbero crearli dalle soluzioni.

1. Modifica o crea un'app canvas dalla tua soluzione.

2. Seleziona Impostazioni>Generale e abilita l'impostazione su Crea automaticamente variabili di ambiente quando aggiungi origini dati.

3. Aggiungi una Nuova origine dati per SharePoint Online.

4. Seleziona un sito di SharePoint, uno o più elenchi, quindi Connetti.

   Note

   Per impedire la creazione di variabili di ambiente duplicate, viene richiesto di usare la variabile di ambiente esistente quando vengono identificati duplicati. Puoi deselezionare l'opzione per utilizzare la variabile di ambiente esistente se si desidera creare un duplicato.

5. Seleziona Salva.

Limitazioni e risoluzione dei problemi

Una variabile di ambiente può esistere nell'ambiente senza essere visualizzata nella selezione origine dati di Canvas Studio. Controllare le limitazioni seguenti quando non è possibile trovare una variabile.

Limitazioni del selettore di Canvas Studio

Questa limitazione si applica quando si selezionano le variabili di ambiente dell'origine dati per i connettori supportati, tra cui SharePoint e SQL Server. Per SQL Server, si applica ai tipi di connessione che supportano le variabili di ambiente dell'origine dati, ad esempio le connessioni Microsoft Entra.

La selezione origine dati di Canvas Studio recupera solo la prima pagina di definizioni e valori delle variabili di ambiente corrispondenti al connettore selezionato e al tipo di parametro. Non recupera le pagine successive. Ogni richiesta di Dataverse restituisce fino a 5.000 record corrispondenti, pertanto alcune variabili potrebbero non essere visualizzate nella scheda Avanzate o nei risultati della ricerca. La ricerca di una variabile mancante non la recupera da una pagina successiva.

Questa limitazione riguarda il selettore, non un limite di 5.000 variabili di ambiente in Dataverse. Il conteggio pertinente è il numero di definizioni o valori corrispondenti per ogni richiesta, non il numero totale di variabili in tutti i connettori nell'ambiente.

Per attenuare questa limitazione, riutilizzare le variabili esistenti e rimuovere le variabili obsolete dopo aver controllato le relative dipendenze. Non eliminare variabili che le app o i flussi usano ancora. Se non è possibile ridurre il numero di variabili, prendere in considerazione un ambiente più piccolo che contiene le variabili e le app necessarie. Lo spostamento di variabili in soluzioni diverse all'interno dello stesso ambiente non riduce il numero di variabili in tale ambiente.

controlli di configurazione specifici di SharePoint

Oltre alla limitazione del paging applicabile a tutti i connettori supportati, le variabili di SharePoint devono soddisfare questi requisiti di configurazione:

• Una variabile del sito richiede un valore corrente non vuoto o un valore predefinito che contiene l'URL del sito SharePoint. Il selettore non elenca le variabili del sito con entrambi i valori vuoti.
• Il valore di una variabile di elenco deve corrispondere all'identificatore univoco (GUID) di un elenco restituito per il sito e la connessione selezionati, non al nome visualizzato dell'elenco. Verificare che la connessione abbia accesso all'elenco e che la variabile contenga il relativo identificatore.

Vedere anche

Creare un'app canvas da zero utilizzando Dataverse.
Utilizzare le variabili di ambiente nei flussi cloud di Power Automate della soluzione
Panoramica delle variabili di ambiente