Creazione di un connettore personalizzato per un'API esistente

  • 20 minuti

In questo esercizio si creerà il primo connettore personalizzato per un'API esistente chiamata Contoso Invoicing.

Importante

Usare un ambiente di test in cui sia stato effettuato il provisioning di Microsoft Dataverse. Se non si dispone di un ambiente di test, è possibile iscriversi a Power Apps Piano per sviluppatori.

Attività: Esame dell'API

Per esaminare l'API, effettuare i seguenti passaggi:

  1. Accedere a Contoso Invoicing.

  2. Selezionare il collegamento alla documentazione.

    Screenshot di una freccia che punta al collegamento alla documentazione dell'API.

  3. Esaminare le operazioni disponibili.

  4. Selezionare per espandere ed esaminare ciascuna operazione.

  5. Chiudere la scheda o la finestra del browser della documentazione.

  6. Selezionare il collegamento alla definizione OpenAPI.

  7. L'immagine seguente mostra un esempio della versione OpenAPI di quanto mostrato nella pagina della documentazione. Fare clic con il pulsante destro del mouse e selezionare Salva con nome.

    Screenshot di una freccia che punta al pulsante Salva con nome.

  8. Salvare il file in locale. Si userà questo file più avanti nell'esercizio.

  9. Chiudere la scheda o la finestra del browser della definizione.

  10. Selezionare il collegamento Chiave API.

  11. Copiare e salvare la chiave API perché sarà necessaria in seguito.

    Screenshot della chiave API per Contoso invoicing.

  12. Selezionare Torna alla Home page.

  13. Selezionare Scarica il logo.

  14. Salvare l'immagine del logo in locale; servirà più avanti.

Attività: Creazione di una nuova soluzione

Per creare una nuova soluzione, effettuare i seguenti passaggi:

  1. Accedere a Power Apps Maker Portal e assicurarsi di essere nell'ambiente corretto.

  2. Selezionare Soluzioni > + Nuova soluzione.

  3. Immettere Contoso invoicing per Nome visualizzato, quindi selezionare + Nuovo editore.

    Screenshot che mostra il pulsante Aggiungi nuovo editore.

  4. Immettere Contoso per Nome visualizzato, Contoso per Nome, contoso per Prefisso, quindi selezionare Salva.

  5. Selezionare Contoso per Editore, quindi Crea. Quando si lavora con un progetto reale, è preferibile creare il proprio editore.

    Screenshot dei dettagli della creazione di una nuova soluzione Contoso Invoicing.

  6. Non chiudere questa pagina dopo aver selezionato Crea.

Attività: Creazione di un nuovo connettore

Per creare un nuovo connettore, effettuare i seguenti passaggi:

  1. Aprire la soluzione Contoso Invoicing creata.

  2. Selezionare + Nuovo > Automazione > Connettore personalizzato.

    Screenshot di una freccia che punta all'opzione per creare una nuova connessione personalizzata.

  3. Immettere Contoso Invoicing come Nome connettore e quindi selezionare Carica per caricare l'immagine.

    Screenshot di una freccia che punta al pulsante di caricamento con icona.

  4. Selezionare l'immagine del logo del connettore scaricato nell'Attività 1: Esame dell'API.

  5. Immettere #175497 come Colore di sfondo dell'icona.

  6. Immettere Connettore personalizzato per API Contoso Invoicing come Descrizione.

  7. Immettere contosoinvoicingtest.azurewebsites.net come Host.

  8. Selezionare Crea connettore.

    Screenshot del pulsante Crea connettore personalizzato.

  9. Non uscire da questa pagina.

Attività: Importazione della definizione OpenAPI

Per importare la definizione OpenAPI, effettuare i seguenti passaggi:

  1. Selezionare la freccia accanto a Nome connettore.

    Screenshot di una freccia che punta al pulsante Indietro.

  2. Selezionare i punti di sospensione (...) del connettore e quindi Aggiorna da file OpenAPI.

    Screenshot di una freccia che punta al pulsante Aggiorna da file API.

  3. Selezionare Importa.

  4. Selezionare il file swagger.json scaricato nell'Attività 1: Esame dell'API, quindi Apri.

  5. Selezionare Continua.

  6. Immettere contosoinvoicingtest.azurewebsites.net come URL dell'host, quindi selezionare Sicurezza.

    Screenshot di una freccia che punta alla scheda Sicurezza.

  7. Osservare che i campi vengano compilati dal file importato.

  8. Non uscire da questa pagina.

Attività: Esame e modifica delle definizioni

Per esaminare e modificare le definizioni, effettuare i seguenti passaggi:

  1. Selezionare la scheda Definizione.

  2. Dedicare qualche minuto a esaminare le operazioni che sono state importate.

  3. Notare il cerchio blu delle informazioni accanto a GetInvoice.

  4. Selezionare l'operazione GetInvoice.

    Screenshot che mostra l'azione GetInvoice.

  5. Osservare che l'operazione indica un Riepilogo mancante.

  6. Immettere Ottieni fattura nel campo Riepilogo per migliorare l'usabilità.

    Screenshot del riepilogo dell'azione GetInvoice.

  7. Notare il cerchio blu delle informazioni accanto all'operazione PayInvoice che indica la mancanza di una Descrizione.

  8. Immettere Paga una fattura come Descrizione.

  9. Eliminare entrambe le operazioni NewInvoice perché non serviranno.

    Screenshot che mostra il pulsante Elimina azione.

  10. Selezionare l'operazione GetInvoiceSchema.

  11. Impostare l'opzione Visibilità su interna in modo che le persone non la visualizzino nel loro elenco di azioni.

  12. Selezionare Aggiorna connettore.

    Screenshot di una freccia che punta al pulsante Aggiorna connettore.

  13. Non uscire da questa pagina.

Attività: Test del connettore

Per verificare il funzionamento del connettore, effettuare i seguenti passaggi:

  1. Selezionare la scheda Test.

  2. Selezionare + Nuova connessione.

    Screenshot di una freccia che punta al pulsante Nuova connessione.

  3. Incollare nella Chiave API salvata nell'Attività 1: Esame dell'API, quindi selezionare Crea connessione.

  4. Selezionare il pulsante Aggiorna.

    Screenshot di una freccia che punta al pulsante Aggiorna.

  5. Selezionare ListInvoiceTypes > Verifica operazione.

    Screenshot di una freccia che punta al pulsante Verifica operazione.

  6. La sezione del corpo dovrebbe contenere i tipi di dati della fattura.

    Screenshot dei tipi di fatture.

Attività: Uso del connettore personalizzato nell'app canvas

In questa attività si crea un'applicazione canvas e si usa il connettore personalizzato creato per visualizzare un elenco di fatture.

  1. Accedere a Power Apps Maker Portal e verificare di trovarsi nell'ambiente corretto.

  2. Selezionare Soluzioni, quindi aprire la soluzione Contoso Invoicing creata.

  3. Selezionare + Nuova, quindi selezionare App > App canvas.

    Screenshot che mostra il pulsante per la creazione di una nuova applicazione canvas.

  4. Immettere App Contoso Invoicing per Nome app, selezionare Telefono per Formato, quindi scegliere Crea.

  5. Selezionare la scheda Dati, scegliere + Aggiungi dati, espandere Connettori, quindi selezionare il connettore personalizzato Contoso Invoicing creato.

    Screenshot che mostra il connettore personalizzato Contoso Invoicing.

  6. Selezionare + Aggiungi un connettore.

  7. Incollare nella Chiave API salvata nell'Attività 1: Esame dell'API, quindi selezionare Connetti.

  8. Selezionare Chiudi nel popup di avviso premium.

  9. Selezionare la scheda Visualizzazione struttura ad albero.

  10. Selezionare + Inserisci, quindi Raccolta verticale.

    Screenshot che mostra il pulsante Inserisci raccolta verticale.

  11. Selezionare ContosoInvoicing per Dati.

    Screenshot che mostra la finestra di dialogo Seleziona dati.

  12. Impostare il valore di Items sul valore di seguito.

    ContosoInvoicing.ListInvoices().invoices

    Screenshot che mostra il valore Items per la raccolta.

  13. Espandere la raccolta e selezionare Subtitle.

  14. Impostare il valore Text di Subtitle su ThisItem.amount.

  15. Espandere la raccolta e selezionare il Title all'interno della raccolta stessa.

  16. Impostare il valore Text di Title su ThisItem.accountName.

    Screenshot che mostra il valore della proprietà text di title.

  17. La raccolta dovrebbe avere un aspetto simile a quello mostrato nell'immagine seguente.

    Screenshot che mostra la raccolta.