Utilizzare un riferimento a una connessione in una soluzione con Microsoft Dataverse

Un connettore è un proxy o un wrapper intorno a un'API che consente al servizio sottostante di comunicare con Microsoft Power Automate, Microsoft Power Apps e App per la logica di Azure. Consente agli utenti di connettere i loro account e utilizzare un set di trigger e azioni predefiniti per compilare le app e i flussi di lavoro.

Una connessione è una credenziale di autenticazione memorizzata per un connettore, ad esempio le credenziali OAuth per il connettore SharePoint.

Un riferimento a una connessione è un componente della soluzione che contiene un riferimento a una connessione relativo a un connettore specifico. Sia le app canvas che riconoscono la soluzione che le operazioni all'interno di un flusso di riconoscimento della soluzione si associano a un riferimento di connessione invece che direttamente a una connessione. Durante l'importazione della soluzione in un ambiente di destinazione, viene fornita una connessione per tutti i riferimenti a una connessione in modo che tutti i flussi di riferimento possano essere attivati automaticamente al termine dell'importazione. Per modificare una connessione specifica associata a un'app canvas o un flusso, modifica il componente di riferimento alla connessione all'interno della soluzione.

Aggiungere riferimenti a una connessione a una soluzione

I riferimenti a una connessione possono essere aggiunti a una soluzione in diversi modi:

  • Quando usi Esplora soluzioni per creare un nuovo riferimento a una connessione in una soluzione.

  • Quando importi a una soluzione. Per saperne di più, vai a Importa soluzioni.

  • Implicitamente quando creai la tua app canvas e i flussi definiti in una soluzione Microsoft Dataverse.

Nota

  • Le app canvas e i flussi gestiscono le connessioni in modo diverso. I flussi usano riferimenti di connessione per tutti i connettori, mentre le app canvas li usano solo per connessioni implicitamente condivise (non OAuth), come Autenticazione di SQL Server. Altre informazioni: Sicurezza e tipi di autenticazione
  • Un riferimento alla connessione viene creato automaticamente quando crei nuove connessioni dalla finestra di progettazione di app canvas e flussi.
  • Le app canvas e i flussi aggiunti da soluzioni esterne non verranno aggiornati automaticamente per utilizzare i riferimenti di connessione.
  • I riferimenti di connessione vengono associati alle app canvas solo nel momento in cui un'origine dati viene aggiunta all'app. Per aggiornare le app è necessario rimuovere la connessione dall'app e quindi aggiungere una connessione contenente un riferimento di connessione associato.

Aggiungi manualmente un riferimento a una connessione utilizzando Esplora soluzioni

  1. Accedi a Power Apps o Power Automate.

  2. Nel riquadro sinistro, seleziona Soluzioni. Se l'elemento non si trova nel riquadro del pannello laterale, seleziona …Altro, quindi l'elemento desiderato.

  3. Crea una soluzione nuova o aprine una esistente.

  4. Sulla barra dei comandi, seleziona Nuovo > Altro > Riferimento a una connessione.

  5. Nel riquadro Nuovo riferimento di connessione, immetti le informazioni seguenti. Le colonne obbligatorie sono contrassegnate con un asterisco (*).

    • Nome visualizzato: immetti un nome univoco e utile per differenziare questo riferimento di connessione dagli altri.
    • Aggiungi una descrizione: immetti il testo che descrive la connessione.
    • Connettore: seleziona un connettore esistente dall'elenco come illustrato nello screenshot. Puoi anche selezionare Nuovo per creare una nuova connessione per questo riferimento di connessione. Una volta terminata la creazione di una nuova connessione, seleziona Aggiorna per selezionare la connessione dall'elenco.
    • Connessione: in base al Connettore selezionato, seleziona una connessione esistente o seleziona Nuova connessione per crearne una.
  6. Seleziona Crea.

    Screenshot del riquadro Nuovo riferimento di connessione.

Denominazione del riferimento di connessione

Il nome visualizzato di un riferimento di connessione deve essere univoco in modo che i diversi riferimenti di connessione possano essere differenziati in base al nome. Per impostazione predefinita, il nome di un riferimento di connessione include il connettore di destinazione, il nome della soluzione corrente per il contesto e un suffisso casuale per garantire l'univocità. Prendi in considerazione la possibilità di adattare il nome di riferimento della connessione a qualcosa di univoco e qualcosa che spieghi per cosa verrà utilizzato.

Riutilizzo delle connessioni in un flusso di soluzione

I flussi creati all'esterno di una soluzione utilizzano direttamente le connessioni. I flussi creati in una soluzione utilizzano i riferimenti di connessione e i punti di riferimenti di connessione nella connessione. Per riutilizzare una connessione in un flusso di soluzione, devi prima creare un riferimento di connessione che punti a tale connessione.

Aggiorna un flusso per usare riferimenti a una connessione anziché a più connessioni

Quando un flusso non è in una soluzione usa le connessioni. Se quel flusso viene quindi aggiunto alla soluzione, continuerà a usare le connessioni inizialmente. I flussi possono essere aggiornati per usare i riferimenti di connessione invece delle connessioni in uno dei due modi seguenti:

  1. Se il flusso viene esportato in una soluzione non gestita e importato, le connessioni vengono rimosse e sostituite con riferimenti di connessione.

  2. Quando viene aperto un flusso di soluzione, la funzione di verifica del flusso nella pagina dei dettagli del flusso mostra un avviso Utilizza riferimenti di connessione. Il messaggio di avviso contiene un'azione Rimuovi le connessioni in modo da poter aggiungere riferimenti di connessione. Selezionando tale azione verranno rimosse le connessioni dal trigger e dalle azioni nel flusso e sarà possibile selezionare e creare i riferimenti di connessione.

Uso automatico di riferimenti di connessione in un flusso di soluzione

Quando un'azione viene aggiunta a un flusso di soluzione, Power Automate proverà a riutilizzare riferimenti di connessione esistenti dalla soluzione corrente o da altre soluzioni prima di creare un nuovo riferimento a una connessione. Per garantire che il riferimento di connessione sia nella stessa soluzione come flusso, crea o aggiungi un riferimento di connessione nella stessa soluzione e fai riferimento a tale riferimento di connessione dal flusso.

Condividi le connessioni con un altro utente in modo che i flussi possano essere abilitati

Quando un flusso è abilitato, l'utente che ha abilitato il flusso deve essere proprietario o ha le autorizzazioni per usare tutte le connessioni nel flusso. Ciò si ottiene in genere facendo in modo che il proprietario del flusso crei le connessioni all'interno di tutti i riferimenti di connessione utilizzati dal flusso. Se un utente diverso dal proprietario del flusso fornisce le connessioni su un flusso, il flusso deve essere attivato dal proprietario di tali connessioni o le connessioni devono essere condivise con l'utente che sta attivando il flusso.

Nota

Le connessioni OAuth possono essere condivise esplicitamente solo con un utente che rappresenta un'entità servizio.

Condivisione manuale delle connessioni per l'abilitazione del flusso

La condivisione delle connessioni può essere eseguita con i seguenti passaggi.

  1. Vai a Power Apps, e seleziona l'ambiente con la connessione.

  2. Seleziona Connessioni nel riquadro di spostamento a sinistra, quindi la connessione che desideri condividere. Se l'elemento non si trova nel riquadro del pannello laterale, seleziona …Altro, quindi l'elemento desiderato.

  3. Dal menu, seleziona Condividi.

  4. Dalla schermata di condivisione immetti il nome dell'utente (entità servizio) che abiliterà il flusso.

  5. Per le autorizzazioni, seleziona Uso.

  6. Per completare la condivisione, seleziona Salva.

Condivisione automatizzata delle connessioni per l'abilitazione del flusso

Per automatizzare la condivisione delle connessioni, utilizza l'azione Modifica assegnazione ruoli connessione sul connettore Power Apps per gli autori.

Screenshot di un esempio di condivisione della connessione.

Limiti

  • I riferimenti a una connessione vengono ora salvati in modo asincrono. A differenza del periodo di anteprima, non c'è più un limite al numero di flussi che possono fare riferimento allo stesso riferimento a una connessione. Quando i riferimenti di connessione vengono aggiornati, viene mostrato un banner informativo che si collega a un pannello contenente i dettagli dell'aggiornamento asincrono.
  • Inoltre, non c'è limite al numero di azioni in ogni flusso che possono essere associate al riferimento a una connessione.
  • Le app canvas non riconoscono i riferimenti di connessione sui connettori personalizzati. Per aggirare questa limitazione, dopo che una soluzione è stata importata in un ambiente, l'app deve essere modificata per rimuovere e quindi aggiungere nuovamente la connessione del connettore personalizzato. Nota, se questa app si trova in una soluzione gestita, procedere alla modifica dell'app creerà un livello non gestito. Ulteriori informazioni: Livelli di soluzioni

Problemi noti

Questa sezione descrive i problemi noti relativi ai riferimenti a una connessione.

L'ambiente di copia interrompe i riferimenti a una connessione per i connettori personalizzati

I connettori personalizzati utilizzano un identificatore specifico dell'ambiente per fare riferimento a un connettore personalizzato. Dopo un'operazione di copia dell'ambiente, è necessario creare un nuovo riferimento a una connessione al nuovo connettore personalizzato. Quindi, eventuali app o flussi che utilizzano i vecchi riferimenti a una connessione dovranno essere corretti.

I connettori personalizzati devono essere importati in una diversa soluzione dai riferimenti a una connessione

I connettori personalizzati devono essere importati in una diversa soluzione, prima dei flussi o dei riferimenti a una connessione. Esporta una soluzione che contiene solo il connettore personalizzato prima.

Domande frequenti

Come risolvo un errore "Connessione non valida"?

Se il riferimento a una connessione viene visualizzato come "non valido" dove viene visualizzato un punto esclamativo rosso nella pagina dei dettagli del flusso, significa che la connessione sottostante è in uno stato non valido. Quando ciò si verifica, controlla e correggi la connessione sottostante aggiornando la connessione o sostituisci la connessione.

Cos'è l'errore ConnectionAuthorizationFailed? Perché non riesco ad abilitare (attivare) un flusso?

L'errore "ConnectionAuthorizationFailed" indica che l'utente che tenta di attivare il flusso non dispone delle autorizzazioni per almeno una delle connessioni utilizzate dal flusso. Per risolvere la situazione, seleziona una delle risoluzioni seguenti:

  • Gli utenti proprietari delle connessioni devono condividere tutte le connessioni con l'utente che abilita (attiva) il flusso.
  • Se un utente possiede tutte le connessioni nel flusso, quell'utente può abilitare (attivare) il flusso.

Una volta che il flusso è stato attivato dal proprietario delle connessioni, il flusso dispone delle autorizzazioni per utilizzare tali connessioni. Da quel momento in poi, qualsiasi comproprietario del flusso può attivarlo.

Un flusso può essere abilitato dal proprietario delle sue connessioni e quindi la proprietà trasferita a un altro utente?

Sì. Quando un flusso viene attivato (abilitato) dal proprietario delle connessioni utilizzate dal flusso, il flusso ottiene l'autorizzazione esplicita per utilizzare tali connessioni. I comproprietari del flusso possono quindi attivare e disattivare il flusso secondo necessità.

Le autorizzazioni concesse alle app e ai flussi che utilizzano una connessione possono essere visualizzate nella pagina dei dettagli per tale connessione nelle schede App che utilizzano questa connessione e Flussi che utilizzano questa connessione.

Se il flusso viene modificato per aggiungere nuove azioni che utilizzano riferimenti di connessione aggiuntivi con nuove connessioni, il proprietario di tali nuove connessioni deve attivare inizialmente il flusso o condividere le connessioni con il proprietario che attiva il flusso. Ulteriori informazioni: Condividere le risorse dell'app

La proprietà di un riferimento di connessione può essere trasferita ad un altro utente?

La proprietà di un riferimento di connessione non può essere trasferita a un altro utente dall'area Soluzioni in Power Apps (make.powerapps.com).

Tuttavia, Esplora soluzioni classico può essere utilizzato per modificare i privilegi di un riferimento di connessione inclusa la condivisione.

Vedi anche

Connettori

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).