Usare un connettore personalizzato da un flusso
Nota
Questo argomento fa parte di una serie di esercitazioni sulla creazione e sull'uso di connettori personalizzati in App per la logica di Azure, Power Automate e Power Apps. Assicurati di leggere la panoramica dei connettori personalizzati per capire il processo.
In questo argomento, crei un flusso di base che utilizza il connettore personalizzato creato in un precedente argomento. Il flusso viene attivato quando un elemento viene aggiunto all'elenco SharePoint, quindi il flusso utilizza il connettore personalizzato per chiamare l'API di analisi del testo Servizi cognitivi. Il connettore restituisce il punteggio del sentiment (da 0 a 1) per il testo nella voce dell'elenco e il flusso riscrive il punteggio nell'elenco. L'immagine seguente mostra il flusso finito:
Prerequisiti
- Una sottoscrizione Office 365 Business Premium o registrati per una versione di valutazione gratuita
- Esperienza di base con la creazione di flussi. Per altre informazioni, vedere Creare un flusso da zero.
- Il connettore personalizzato creato in uno di questi argomenti:
Crea l'elenco SharePoint
Innanzitutto crea un semplice elenco a tre colonne in SharePoint Online; questo elenco memorizza i dati di revisione dei film che il flusso analizza per il sentiment. Per ulteriori informazioni sugli elenchi SharePoint, vedi Introduzione agli elenchi nella documentazione di SharePoint.
Nel tuo sito SharePoint Online, scegli Nuovo, quindi Elenco.
Immetti il nome Recensioni cinematografiche quindi scegli Crea.
Viene creato l'elenco con il campo Titolo predefinito.
Scegli l'
, quindi Riga di testo singola.
Immetti il nome Recensione e quindi scegli Salva.
Ripeti i passaggi 3. e 4. per aggiungere un'altra colonna all'elenco. Usa un tipo di dati Numero e il nome Punteggio.
Creare un flusso dall'elenco
SharePoint Online offre la possibilità di creare flussi direttamente da un elenco, quindi utilizzeremo questo approccio. Puoi creare lo stesso flusso da flow.microsoft.com.
Nell'elenco SharePoint, scegli Flusso quindi Crea un flusso.
Nel riquadro destro, seleziona Mostra altro.
Scegli il modello Quando viene aggiunto un nuovo elemento in SharePoint, completa un'azione personalizzata.
L'azione personalizzata in questo caso sta chiamando l'API tramite il connettore personalizzato.
Assicurati di aver effettuato l'accesso a SharePoint con l'account corretto, quindi scegli Continua.
In flow.microsoft.com, scegli Modifica. Viene visualizzato il sito SharePoint e l'elenco da cui è stato avviato il processo Crea un flusso.
Aggiungere il connettore personalizzato
Power Automate ha creato un flusso di base con un trigger che si attiva quando viene aggiunto un elemento all'elenco SharePoint. Ora aggiungi le azioni da eseguire in base all'elemento che viene aggiunto.
Seleziona Nuovo passaggio, quindi scegli Aggiungi un'azione.
Cerca il connettore che hai creato, quindi scegli l'azione associata a quel connettore.
Il nome e la descrizione dell'azione provengono dalle informazioni fornite al momento della creazione del connettore.
Specifica i valori per tutti i campi.
Parametro valore Linguaggio "en" ID "1" Testo Il campo Revisione di SharePoint (dalla finestra di dialogo Contenuto dinamico) ID è necessario perché il connettore può gestire più documenti. In questi esempi si invia un documento alla volta. In un flusso di produzione, i valori lingua e ID possono provenire da un elenco o da un'altra origine dati.
Seleziona Nuovo passaggio, quindi Aggiungi un'azione.
Aggiungi l'azione SharePoint - Aggiorna elemento e inserisci i valori per tutti i campi.
Parametro valore Indirizzo del sito L'indirizzo del sito SharePoint Online da cui è stato avviato il processo Crea un flusso Nome elenco L'elenco da cui hai avviato il processo Crea un flusso ID Il campo ID di SharePoint Posizione Il campo Titolo di SharePoint Rivedi Il campo Revisione di SharePoint Punteggio Il campo Punteggio del connettore personalizzato Quando aggiungi il contenuto dinamico per il campo Punteggio, Power Automate aggiunge un contenitore Applica a ogni perché riconosce che il connettore personalizzato accetta più documenti. Il tuo flusso ne invia solo uno alla volta, ma è utile che il flusso corrisponda alle capacità del connettore.
Il flusso finito deve ora apparire come nell'immagine seguente:
Immettere un nome per il flusso, ad esempio Analisi del sentiment, quindi scegliere Crea flusso e Fine.
Testare il flusso
Ora che è stato completato il flusso, testalo aggiungendo recensioni all'elenco SharePoint per vedere come risponde.
Nell'elenco SharePoint Online, scegli Modifica rapida.
Aggiungi due recensioni all'elenco (una negativa e una positiva), quindi scegli Fatto.
Parametro Valore suggerito Titolo (positivo) Il mio film preferito Recensione (positiva) "Mi è piaciuto il nuovo film dopo una lunga giornata" Titolo (negativo) Qualche altro film Recensione (negativa) "Il peggior film che abbia visto da decenni" In flow.microsoft.com, scegli I miei flussi, quindi scegli il flusso che hai creato.
In Cronologia esecuzioni dovrebbero essere visibili due esecuzioni, una per ogni recensione aggiunta all'elenco.
Di nuovo nella pagina di elenco SharePoint, aggiorna il browser per vedere i punteggi aggiunti dal flusso.
L'operazione è terminata. Si tratta di un flusso semplice, ma con potenti funzionalità che permettono di chiamare Servizi cognitivi attraverso un connettore personalizzato.
Passaggi successivi
Condividi un connettore nell'organizzazione e/o ottieni la certificazione in modo che possa essere usato da persone esterne all'organizzazione:
Inviare commenti
L'invio da parte degli utenti di feedback sui problemi riscontrati con la piattaforma di connettori o di idee su nuove funzionalità è molto apprezzato. Per fornire un feedback, vai a Inviare problemi o ottenere assistenza per i connettori e seleziona il tipo di commenti.