Esercizio - Implementazione di un trigger webhook

  • 10 minuti

In questo esercizio si aggiungerà un trigger webhook al connettore personalizzato per un'API Contoso Invoicing esistente.

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 al piano della community.

Nota

Scaricare il file seguente sul computer locale per completare questo esercizio Contoso Invoicing - Triggers. Selezionare il pulsante Scarica nella parte destra della schermata.

Attività 1: importazione di una soluzione con il connettore personalizzato

In questa attività si importerà una soluzione non gestita contenente un connettore personalizzato predefinito per l'API Contoso Invoicing.

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

  2. Selezionare Soluzioni > Importa soluzione.

  3. Selezionare Sfoglia.

  4. Selezionare la soluzione ContosoInvoicingTriggers_1_0_0_0.zip e quindi Apri.

  5. Selezionare Avanti.

  6. Selezionare Importa e attendere il completamento dell'importazione. Al termine dell'importazione, dovrebbe apparire un messaggio di operazione riuscita.

  7. Selezionare Pubblica tutte le personalizzazioni e attendere il completamento della pubblicazione.

  8. Selezionare e aprire la soluzione Contoso Invoicing - Triggers importata. Il componente del connettore personalizzato Contoso Invoicing - Triggers dovrebbe essere visualizzato.

    Screenshot di Contoso Invoicing - Triggers evidenziato.

  9. In nuova scheda andare a Contoso Invoicing.

  10. Selezionare il collegamento Chiave API.

    Screenshot del collegamento Chiave API evidenziato.

  11. Copiare la chiave API e annotarla in un editor di testo. Verrà usata più di qualche volta in questo esercizio.

  12. Tornare a Power Apps Maker Portal e verificare di trovarsi nell'ambiente corretto.

  13. Selezionare Soluzioni, quindi selezionare e aprire la soluzione Contoso invoicing triggers.

  14. Selezionare e aprire il connettore personalizzato Contoso Invoicing - Triggers.

  15. Selezionare Modifica.

    Screenshot con una freccia che punta al pulsante per la modifica del connettore.

  16. Immettere contosoinvoicing.azurewebsites.net per Host.

  17. Selezionare Aggiorna connettore.

  18. Selezionare Test > + Nuova connessione.

    Screenshot con una freccia che punta al pulsante Nuova connessione.

  19. Incollare la chiave API e selezionare Crea connessione.

    Screenshot del pulsante Crea connessione.

  20. Selezionare Aggiorna. La connessione creata dovrebbe essere selezionata automaticamente.

  21. Scorrere verso il basso fino alla sezione Operazioni, selezionare ListInvoices, quindi selezionare Verifica operazione.

    Screenshot con una freccia che punta al pulsante Verifica operazione.

    Viene visualizzato un elenco di fatture nella sezione Corpo.

    Screenshot con un elenco di fatture nella sezione Corpo.

  22. Rimanere su questa pagina.

Attività 2: aggiunta di un trigger webhook

Seguire questi passaggi per aggiungere un trigger webhook:

  1. Selezionare Definizione.

    Screenshot con la scheda Definizione selezionata.

  2. Scorrere verso il basso fino alla sezione Trigger e selezionare + Nuovo trigger.

  3. Specificare i valori seguenti:

    • Riepilogo: Alla creazione della fattura

    • Descrizione: Alla creazione della fattura

    • ID operazione: InvoiceCreated

    • Tipo di trigger: webhook

    Screenshot dei nuovi valori di trigger per Riepilogo, Descrizione, ID operazione e Tipo di trigger.

  4. Passare alla sezione Richiesta e selezionare + Importa da esempio.

    Screenshot con una freccia che punta al pulsante Importa da esempio.

  5. Specificare i seguenti valori, quindi selezionare Importa. Con altre API, si otterrà l'esempio dalla documentazione dell'API.

    • Verbo: POST

    • URL - https://contosoinvoicing.azurewebsites.net/NewInvoiceNotification/

      Nota

      Includere la barra finale nell'URL.

    • Corpo

        {
  "targetUrl":"https://webhook.site"
  }

    Screenshot delle proprietà di esempio della richiesta.

  6. Scorrere fino a Configurazione trigger e selezionare targetUrl per Parametro URL di callback. Questa selezione consente il popolamento di targetUrl in runtime da parte del connettore personalizzato.

    Screenshot della finestra di conferma del trigger.

  7. Scorrere verso l'alto fino alla sezione Richiesta, selezionare Corpo, quindi Modifica.

    Screenshot con una freccia che punta al pulsante per la modifica del corpo.

  8. Selezionare targetUrl, quindi Edit.

    Screenshot con una freccia che punta al pulsante per la modifica dell'URL di destinazione.

  9. Selezionare Sì per Obbligatorio, quindi selezionare interno for Visibilità.

    Screenshot dei campi delle proprietà dell'URL di destinazione.

  10. Selezionare il pulsante Indietro.

    Screenshot con una freccia che punta al pulsante Indietro.

  11. Selezionare nuovamente il pulsante Indietro.

  12. Scorrere verso il basso alla sezione Risposta webhook, immettere Fattura per Descrizione, quindi selezionare + Importa da esempio. La risposta del webhook definisce cosa verrà inviato al flusso quando si verifica l'evento di attivazione.

    Screenshot con una freccia che punta al pulsante di importazione di una risposta di esempio.

  13. Incollare il seguente esempio JSON nel corpo, quindi selezionare Importa.

     {
 "invoiceId": "1933",
 "date": "2021-01-26T04:02:52.1490835+00:00",
 "amount": 5000,
 "accountId": "1001",
 "accountName": "Wing Tips",
 "status": "Invoiced",
 "typeId": 1,
 "purchaseOrderId": "3002",
 "tags": "New Account;Special Pricing"
 }

    Screenshot dei dettagli delle proprietà di importazione della risposta.

  14. Selezionare Aggiorna connettore.

    Nota

    Se si riceve un messaggio di errore simile a "tutti i percorsi devono iniziare con '/'," aprire Swagger, trovare la riga contenente '':{} ed eliminarla.

  15. Selezionare Chiudi.

Attività 3 - Test del trigger

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

  2. Selezionare Soluzioni, quindi aprire la soluzione Contoso Invoicing - Triggers.

  3. Selezionare + Nuovo > Automazione > Flusso cloud > Istantaneo.

  4. Immettere Create invoice per il nome, selezionare Attiva un flusso manualmente in Trigger, quindi selezionare Crea.

    Screenshot con una freccia che punta ad Attiva un flusso manualmente in Trigger.

  5. Espandere il trigger e selezionare + Aggiungi un input.

  6. Selezionare Numero per il tipo di input.

    Screenshot con una freccia che punta al tipo di input Numero.

  7. Immettere Importo come nome dell'input e quindi selezionare + Nuovo passaggio.

    Screenshot con una freccia che punta al pulsante Nuovo passaggio.

  8. Selezionare la scheda Personalizzato, quindi selezionare il connettore personalizzato Contoso Invoicing.

    Screenshot con una freccia che punta al connettore personalizzato.

  9. Selezionare l'azione Aggiungi fattura.

  10. Immettere Connessione Contoso nel campo Nome connessione, incollare la Chiave API copiata nell'Attività 1: importazione di una soluzione con il connettore personalizzato, quindi selezionare Crea. È necessario usare la stessa chiave API in entrambi i flussi; in caso contrario, il flusso di attivazione non verrà eseguito.

    Screenshot del pulsante per la creazione della connessione.

  11. Selezionare il campo importo, quindi selezionare Importo nel riquadro Contenuto dinamico.

    Screenshot dell'output del campo Amount del passaggio precedente.

  12. Selezionare Salva.

  13. Selezionare il pulsante Indietro (<-).

  14. Verificare di trovarsi ancora nella soluzione Contoso Invoicing - Triggers.

  15. Selezionare + Nuovo > Automazione > Flusso cloud > Automatizzato.

  16. Immettere Invoice Notification per Nome flusso e selezionare Ignora.

  17. Selezionare la scheda Personalizzato, quindi selezionare il connettore personalizzato Contoso Invoicing.

    Screenshot con una freccia che punta al trigger del connettore personalizzato.

  18. Selezionare il trigger Alla creazione della fattura.

  19. Selezionare + Nuovo passaggio.

  20. Cercare Componi, quindi selezionare l'azione Componi.

  21. Selezionare il campo Input, quindi selezionare corpo nel riquadro Contenuto dinamico.

    Screenshot del campo Inputs e di body nel riquadro Contenuto dinamico.

  22. Selezionare Salva.

  23. Selezionare Test.

  24. Selezionare Manualmente > Test. Il flusso avrà inizio ed è possibile che vengano visualizzate delle notifiche.

  25. Aprire una nuova finestra del browser e accedere a https://make.powerapps.com/.

  26. Assicurarsi che sia selezionato l'ambiente corretto.

  27. Selezionare Soluzioni, quindi aprire la soluzione Contoso Invoicing - Triggers.

  28. Aprire il flusso cloud Create invoice.

  29. Selezionare Modifica.

  30. Selezionare Test.

  31. Selezionare Manualmente > Test.

  32. Selezionare Continua.

  33. Immettere 5500 per Amount, quindi selezionare Esegui flusso.

  34. Selezionare Fine.

  35. Passare al flusso Notifica fattura. Il flusso dovrebbe essere eseguito correttamente.

  36. Selezionare per espandere l'azione Componi.

    Screenshot di una freccia che punta all'azione Componi.

    In Input e Output dovrebbe essere visualizzato l'importo specificato nel flusso Crea fattura.

    Screenshot degli input e degli output dell'azione Componi.