Esercizio - Implementazione di un trigger di polling

  • 10 minuti

In questo esercizio si aggiungerà un trigger di polling 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.

Attività 1 - Importazione della soluzione con il connettore personalizzato

Nota

È possibile continuare a usare il connettore creato e modificato in Unità 4 - Implementazione di un trigger webhook. Se si è completato quell'esercizio, è possibile passare direttamente all'attività 2.

Nota

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

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.

  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. Aprire la soluzione Trigger Contoso Importing importata.

    Il componente del connettore personalizzato Contoso Invoicing - Triggers dovrebbe essere visualizzato.

    Screenshot del componente Contoso Invoicing - Triggers evidenziato.

  9. Accedere a Contoso Invoicing.

  10. Selezionare il collegamento Chiave API.

    Screenshot del collegamento Chiave API evidenziato.

  11. Copiare la chiave API e incollarla in un editor di testo per uso futuro.

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

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

  14. 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 in Host.

  17. Selezionare Aggiorna connettore.

  18. Selezionare Test > + Nuovo connettore.

    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 ListInvoice e 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 di polling

Se si è saltata l'attività precedente, accedere al connettore personalizzato Contoso Invoicing - Triggers e selezionare Modifica.

  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 (Poll)

    • Descrizione: alla creazione della fattura (Poll)

    • ID operazione: InvoiceCreatedPoll

    • Tipo di trigger: polling

    Screenshot con le proprietà del trigger del connettore.

  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.

    • Verbo: GET

    • URL - https://contosoinvoicing.azurewebsites.net/ListInvoices?fromDate=

  6. Selezionare i puntini di sospensione (...) accanto a fromDate, quindi selezionare Modifica.

    Screenshot con una freccia che punta al pulsante Modifica.

  7. Selezionare Interna per l'opzione Visibilità e quindi selezionare il pulsante Indietro.

    Screenshot con l'opzione Visibilità impostata su interna.

  8. Scorrere verso il basso fino alla sezione Risposta e selezionare + Aggiungi risposta predefinita.

  9. Incollare il seguente codice JSON nel campo Corpo, quindi selezionare Importa.

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

    Screenshot della finestra per l'importazione della risposta predefinita.

  10. Passare alla sezione Configurazione trigger e specificare i seguenti valori:

    • Selezionare il parametro di query per monitorare il cambiamento dello stato: fromDate

    • Specificare il valore da passare al parametro di query selezionato. È possibile scegliere le espressioni - @{triggerBody().invoices[0].createDate}

    • Selezionare la raccolta che contiene i dati del trigger - @triggerBody().invoices

    Screenshot della sezione Configurazione trigger con valori.

  11. Selezionare il pulsante Aggiorna connettore nella parte superiore dello schermo, quindi attendere l'aggiornamento del connettore.

Attività 3 - Test del trigger

Se si è già completata l'Unità 4 - Implementazione di un trigger webhook e si è creato il flusso cloud Crea fattura, andare al passaggio 14.

  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 > Flusso cloud.

  4. Immettere Crea fattura per il nome, quindi selezionare Attiva un flusso manualmente per il trigger.

    Screenshot con una freccia che punta al trigger Attiva un flusso manualmente.

  5. 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, quindi selezionare Crea.

    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. Mantenere aperta la scheda o la finestra del browser.

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

  15. Assicurarsi che sia selezionato l'ambiente corretto.

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

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

  18. Immettere Invoice notification poll per il nome e selezionare Ignora.

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

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

  20. Selezionare il trigger Alla creazione della fattura (Poll).

    Screenshot con una freccia che punta a un trigger del connettore personalizzato.

  21. Selezionare il pulsante ... del trigger e quindi assicurarsi che Riferimenti connessione sia selezionato.

    Screenshot della sezione Riferimenti connessione.

  22. Selezionare + Nuovo passaggio.

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

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

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

  25. Selezionare Salva e attendere il salvataggio del flusso.

  26. Selezionare Test.

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

  28. Passare alla scheda o alla finestra del browser del flusso Create invoice.

  29. Selezionare Test.

  30. Selezionare Manualmente > Test.

  31. Immettere 6500 per Amount, quindi selezionare Esegui flusso.

  32. Selezionare Fine.

  33. Il flusso dovrebbe essere eseguito correttamente. Selezionare Modifica.

    Screenshot dell'esecuzione riuscita del flusso con l'icona Modifica.

  34. Selezionare di nuovo Test.

  35. Selezionare Manualmente > Test.

  36. Immettere 8800 per Amount, quindi selezionare Esegui flusso.

  37. Selezionare Fine. Il flusso dovrebbe essere eseguito di nuovo correttamente.

  38. Passare al flusso Poll notifica fattura. Questo flusso dovrebbe essere eseguito correttamente.

    Nota

    A differenza di un trigger webhook, è possibile che sia necessario circa un minuto per determinare se il flusso è stato eseguito correttamente o meno.

  39. Selezionare per espandere l'azione Componi.

    Screenshot con una freccia che punta all'azione Componi.

  40. Esaminare gli Output e quindi selezionare il pulsante.

    Screenshot degli output dell'azione Componi.

    Dovrebbero essere visualizzati i risultati di due esecuzioni per le due fatture create.

    Screenshot dei dettagli della cronologia di esecuzione del flusso.