Utilizzare un connettore personalizzato da un'app per la logica

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 comprendere il processo.

In questo argomento, crei un'app per la logica di base che utilizza il connettore personalizzato creato in un precedente argomento. L'app per la logica viene attivata quando un elemento viene aggiunto all'elenco SharePoint, quindi l'app per la logica 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 l'app per la logica riscrive il punteggio nell'elenco. L'immagine seguente mostra l'app per la logica finita:

App per la logica dell'analisi del sentiment finita

Prerequisiti

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 l'app per la logica analizza per il sentiment. Per ulteriori informazioni sugli elenchi SharePoint, vedi Introduzione agli elenchi nella documentazione di SharePoint.

  1. Nel tuo sito SharePoint Online, scegli Nuovo, quindi Elenco.

    Crea un nuovo elenco SharePoint

  2. Immetti il nome "Recensioni cinematografiche" quindi scegli Crea.

    Specificare il nome del nuovo elenco

    Viene creato l'elenco con il campo Titolo predefinito.

    Elenco Richieste di progetto

  3. Scegli l'icona Nuovo elemento, quindi Riga di testo singola.

    Aggiungere campo Riga di testo singola

  4. Immetti il nome "Recensione" e quindi scegli Salva.

  5. 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'app per la logica

Ora che hai un elenco con cui lavorare, crea un'app per la logica nel portale di Azure.

  1. Accedi al portale di Azure utilizzando le credenziali del tuo account di Azure.

  2. Dal menu principale di Azure, seleziona Nuovo > Integrazione aziendale > App per la logica.

    Crea un'app per la logica

  3. In Crea un'app per la logica, fornisci i dettagli sulla tua app per la logica come mostrato qui. Al termine, scegli Aggiungi al dashboard > Crea.

    Fornisci i dettagli dell'app per la logica

    Impostazione valore Descrizione
    Nome SentimentAnalysis Il nome per l'app per la logica
    Iscrizione <your-Azure-subscription-name> Il nome della sottoscrizione di Azure
    Gruppo di risorse My-First-LA-RG Il nome per il gruppo di risorse di Azure utilizzato per organizzare le risorse correlate
    Posizione Stati Uniti orientali 2 L'area in cui archiviare le informazioni dell'app per la logica

    Nota: l'app per la logica e il connettore personalizzato devono esistere nella stessa area.

    Log Analytics No Mantieni l'impostazione Disattivato per la registrazione diagnostica.
  4. Dopo che Azure ha distribuito l'app, viene visualizzata la Progettazione app per la logica con una pagina con un video introduttivo e i trigger comunemente usati. In Modelli seleziona App per la logica vuota.

    Scegli il modello dell'app per la logica vuota

Aggiungi il trigger e il connettore personalizzato

Con l'app per la logia creata, aggiungi un trigger che si attiva quando viene aggiunto un elemento all'elenco SharePoint. Quindi aggiungi un'azione da eseguire in base all'elemento aggiunto.

  1. In Progettazione app per la logia, cerca o seleziona SharePoint, quindi il trigger SharePoint - quando viene creato un elemento.

    SharePoint crea il trigger di elemento

  2. Se richiesto, accedi con le tue credenziali per SharePoint.

  3. Immetti i valori per il trigger SharePoint.

    SharePoint crea i parametri del trigger di elemento

    Parametro valore
    Indirizzo del sito <your-SharePoint-site-address>
    Nome elenco Recensioni cinematografiche
    Intervallo 10
    Frequenza Secondo
  4. Seleziona Nuovo passaggio, quindi scegli Aggiungi un'azione.

  5. Cerca il connettore personalizzato SentimentDemo che hai creato, quindi scegli l'azione associata a quel connettore.

    Scegli l'azione SentimentDemo

    Il nome e la descrizione dell'azione provengono dalle informazioni fornite al momento della creazione del connettore.

  6. Immetti un nome per la connessione e la chiave API.

    Nome connessione e chiave API

    Parametro valore
    Nome connessione Un nome come SentimentDemoConnection.
    Chiave API La chiave API per l'API Analisi del testo. Per ulteriori informazioni, vai a Ottenere una chiave API.
  7. Specifica i valori per tutti i campi.

    Parametri del connettore

    Parametro valore
    Linguaggio en
    ID 1
    Text Il campo Revisione di SharePoint (dalla finestra di dialogo Contenuto dinamico)

    ID è necessario perché il connettore può gestire più documenti. In questi esempi inviamo un documento alla volta. In un'app per la logica di produzione, i valori lingua e ID possono provenire da un elenco o da un'altra origine dati.

  8. Seleziona Nuovo passaggio, quindi Aggiungi un'azione.

  9. Aggiungi l'azione SharePoint - Aggiorna elemento e inserisci i valori per tutti i campi.

    Azione Aggiorna voce di elenco

    Parametro valore
    Indirizzo del sito <your-SharePoint-site-address>
    Nome elenco Recensioni cinematografiche
    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, App per la logia aggiunge un contenitore Per ogni each perché riconosce che il connettore personalizzato accetta più documenti. Il tuo connettore ne invia solo uno alla volta, ma è utile che l'app per la logica corrisponda alle capacità del connettore.

    Applica a ogni

    L'app per la logica finita deve ora apparire come nell'immagine seguente:

    App per la logica dell'analisi del sentiment finita

  10. Nella parte superiore di Progettazione app per la logica, scegli Esegui.

Testare l'app per la logica

Ora che l'app per la logia è stata completata, testala aggiungendo recensioni all'elenco SharePoint per vedere come risponde.

  1. Nell'elenco SharePoint Online, scegli Modifica rapida.

    Modifica rapida dell'elenco SharePoint

  2. Aggiungi due recensioni all'elenco (una negativa e una positiva), quindi scegli Fatto.

    Modifica rapida fatta

    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
  3. Di nuovo nel portale di Azure, seleziona Panoramica per esaminare la cronologia di esecuzione di questa app per la logica. Saranno visibili due esecuzioni, una per ogni recensione aggiunta all'elenco. Per salvare le risorse di Azure dopo aver finito con questa app per la logica, scegli Disattiva.

    Cronologia di esecuzione

  4. Di nuovo nella pagina di elenco SharePoint, aggiorna il browser per vedere i punteggi aggiunti dall'app per la logica.

    Punteggi aggiunti dall'app per la logica

L'operazione è terminata. Si tratta di un'app per la logica 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.