Esercizio - Creazione di un nuovo connettore in una soluzione

  • 6 minuti

In questo esercizio si crea 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à 1: esame dell'API

Per esaminare l'API, effettuare i seguenti passaggi:

  1. Accedere a Contoso Invoicing.

  2. Selezionare il collegamento alla documentazione.

    Screenshot con 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 con freccia che punta al pulsante Salva con nome.

  8. Salvare il file in locale. Si usa 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à 2 - 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 come Nome visualizzato, selezionare CDS Default Publisher come Autore e quindi selezionare Crea. Quando si lavora con un progetto reale, è preferibile creare il proprio editore.

    Screenshot della creazione di una nuova soluzione Contoso Invoicing.

  4. Non chiudere questa pagina dopo aver selezionato Crea.

Attività 3 - 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 con 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.

    Una freccia che punta al pulsante di caricamento con icona - screenshot.

  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 contosoinvoicingtest.azurewebsites.net come Host.

  7. Selezionare Crea connettore.

    Screenshot con freccia che punta al pulsante Crea connettore.

  8. Rimanere su questa pagina.

Attività 4: importazione della definizione OpenAPI

Per importare la definizione OpenAPI, effettuare i seguenti passaggi:

  1. Selezionare la freccia accanto a Nome connettore.

    Una freccia che punta al pulsante Indietro - screenshot.

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

    Una freccia che punta al pulsante Aggiorna da file OpenAPI - screenshot.

  3. Selezionare Importa.

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

  5. Selezionare Continua.

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

    Una freccia che punta alla scheda Sicurezza - screenshot.

  7. Osservare che il campo viene compilato dal file importato.

  8. Rimanere su questa pagina.

Attività 5: 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 l'icona informativa blu accanto a GetInvoice, a indicare un elemento che richiede attenzione.

    Una freccia che punta all'azione GetInvoice - screenshot.

  4. Selezionare l'operazione GetInvoice.

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

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

    Riepilogo dell'azione Ottieni fattura - screenshot.

  7. Il cerchietto azzurro delle informazioni visualizzato in corrispondenza dell'operazione PayInvoice indica la mancanza di una Descrizione.

  8. Immettere Paga una fattura come Descrizione.

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

    Una freccia che punta al pulsante Elimina - screenshot.

  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 con freccia che punta al pulsante Aggiorna connettore.

  13. Rimanere su questa pagina.

Attività 6: verifica del connettore

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

  1. Selezionare la scheda Test.

  2. Selezionare + Nuova connessione.

    Una freccia che punta al pulsante Nuova connessione - screenshot.

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

  4. Selezionare il pulsante Aggiorna.

    Screenshot con freccia che punta al pulsante Aggiorna.

  5. Selezionare ListInvoiceTypes > Verifica operazione.

    Screenshot con freccia che punta al pulsante Verifica operazione

La sezione del corpo dovrebbe contenere alcuni dati della fattura.