Esercizio - Uso delle estensioni OpenAPI

  • 8 minuti

In questo esercizio si configureranno le estensioni OpenAPI sul connettore personalizzato Contoso Invoicing. Verranno implementate le estensioni seguenti:

  • Test connessione: per convalidare la validità della chiave API inserita.

  • Valori dinamici: per convertire l'input di 'ID del tipo di fattura in un elenco a discesa di valori dall'API.

  • Schema dinamico: per visualizzare solo i parametri validi per il tipo di fattura selezionato.

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 della soluzione

In questa attività si importa una soluzione non gestita contenente un connettore personalizzato Contoso Invoicing e quindi si sottopone a test il connettore. Il connettore verrà usato per completare le attività di questo esercizio.

  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 ContosoInvoicingExtensions_1_0_0_0.zip e quindi selezionare 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 Contoso Invoicing - Extensions importata.

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

  9. Selezionare il connettore Contoso Invoicing - Estensioni, quindi selezionare Modifica.

    Screenshot con una freccia che punta al pulsante Modifica soluzione.

  10. Aprire una nuova finestra del browser e quindi passare a Contoso Invoicing.

  11. Selezionare il collegamento Chiave API.

  12. Copiare la chiave API. Salvare la chiave in un blocco note. È necessario conservarla per le attività future.

  13. Tornare al connettore, selezionare la scheda Test, quindi selezionare + Nuova connessione.

    Screenshot del pulsante Aggiungi nuova connessione.

  14. Incollare la chiave copiata nel campo Chiave API e quindi selezionare Crea connessione.

  15. Selezionare Aggiorna per aggiornare le connessioni.

  16. Scorrere verso il basso fino alla sezione Operazioni, selezionare ListInvoiceTypes e quindi selezionare Verifica operazione.

    Screenshot con una freccia che punta al pulsante Verifica operazione.

    Verrà ricevuta una risposta contenente i tipi di fattura. Questa operazione verrà successivamente usata per implementare l'estensione Valori dinamici per il parametro Tipo di fattura.

    Screenshot del contenuto del corpo della risposta visualizzato.

  17. Rimanere su questa pagina.

Attività 2 - Aggiunta dell'estensione per la verifica della connessione

In questa attività verrà aggiunta l'estensione per la verifica della connessione:

  1. Attivare l'interruttore Editor Swagger.

    Screenshot del pulsante di attivazione/disattivazione dell'editor Swagger.

  2. Aggiungere il seguente frammento dopo produce: [], quindi selezionare Aggiorna connettore. Assicurarsi che il rientro del testo corrisponda a quello illustrato nell'immagine seguente.

    x-ms-capabilities:
   testConnection:
     operationId: ListInvoices
     parameters: {}

    Assicurarsi che il rientro sia simile a quello nell'immagine seguente.

    Screenshot con una freccia che punta al pulsante Aggiorna connettore.

  3. Selezionare di nuovo + Nuova connessione.

    Screenshot con una freccia che punta al pulsante Nuova connessione.

  4. Immettere il nome o un altro valore casuale nel campo Chiave API e quindi selezionare Crea connessione.

    La creazione della connessione ha esito negativo.

    Screenshot del messaggio di errore relativo alla connessione.

  5. Nel campo Chiave API specificare la chiave copiata nell'attività 1 e quindi selezionare Crea connessione.

    La creazione della connessione ha esito positivo.

  6. Rimanere su questa pagina.

Attività 3 - Configurazione dei valori dinamici per l'ID del tipo di fattura

In questa attività verranno configurati i valori dinamici per l'ID del tipo di fattura:

  1. Selezionare la scheda Definizione.

  2. Selezionare AddInvoice nella sezione Actions.

  3. Scorrere verso il basso, selezionare i puntini di sospensione (...) associati al parametro typeId, quindi selezionare Modifica.

    Screenshot di una freccia che punta al pulsante per la modifica dei parametri della query.

  4. Immettere Tipo di fattura nel campo Riepilogo, immettere 1 nel campo Valore predefinito, quindi selezionare Sì per l'opzione È obbligatorio?.

    Screenshot delle proprietà dei parametri della query.

  5. Scorrere verso il basso e selezionare Dinamico per l'opzione Tipo di elenco a discesa.

  6. Selezionare ListInvoiceTypes nel campo ID operazione, selezionare typeId nel campo Valore e quindi selezionare name nel campo Nome visualizzato del valore.

    Screenshot delle proprietà del parametro della query.

  7. Selezionare Aggiorna connettore.

  8. Attivare l'interruttore Editor Swagger.

  9. Se vengono restituiti errori di chiave hash, chiudere la scheda del browser del connettore e quindi riaprirla in modalità di modifica.

  10. Individuare AddInvoice e verificare che sia stata aggiunta la voce x-ms-dynamic-values.

    Screenshot dei valori dinamici aggiunti.

  11. Rimanere su questa pagina.

Attività 4 - Configurazione dell'estensione dello schema dinamico

In questa attività verrà configurata l'estensione dello schema dinamico:

  1. Selezionare la scheda Test.

  2. Selezionare l'operazione GetInvoiceSchema e quindi selezionare Verifica operazione.

    Screenshot di una freccia che punta al pulsante per la verifica del funzionamento dello schema di recupero delle fatture.

  3. Rivedere la risposta. Questa risposta è ciò che un'API deve restituire per consentire la configurazione dello schema dinamico.

    Screenshot della risposta dello schema di recupero delle fatture.

  4. Attivare l'interruttore Editor Swagger.

  5. Individuare la riga CreateInvoiceRequest e sostituire la riga invoice con il testo Swagger seguente.

    Invoice:

    x-ms-dynamic-properties:

    operationId: GetInvoiceSchema

    parameters:

    typeId: {parameterReference: typeId}

    Prima:

    Screenshot del testo Swagger prima della modifica.

    Dopo:

    Assicurarsi che i rientri corrispondano a quelli illustrati nell'immagine seguente.

    Screenshot del testo Swagger dopo la modifica.

  6. Disattivare l'interruttore Editor Swagger.

  7. Selezionare la scheda Definizione.

  8. Selezionare l'azione GetInvoiceSchema e quindi selezionare Interna per l'opzione Visibilità.

    Screenshot della visibilità dell'azione dello schema di recupero delle fatture.

  9. Selezionare Aggiorna connettore.

Attività 5 - Verifica del connettore

In questa attività verrà verificato il connettore:

  1. Passare a Power Automate e verificare di trovarsi nell'ambiente corretto.

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

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

    Screenshot di una freccia che punta al pulsante per la creazione del nuovo flusso cloud.

  4. Immettere Dynamic metadata per Nome flusso, selezionare Attiva manualmente un flusso per il trigger, quindi selezionare Crea.

  5. Selezionare+ Nuovo passaggio.

  6. Selezionare la scheda Personalizzato, quindi Contoso Invoicing - Extensions.

  7. Selezionare AddInvoice come azione.

  8. Immettere My connection come nome, immettere il proprio nome in Chiave API, quindi selezionare Crea. Il test della connessione dovrebbe avere esito negativo.

Screenshot con una freccia che punta al connettore personalizzato.

  1. Nel campo Chiave API specificare la chiave copiata nell'Attività 1, quindi selezionare di nuovo Crea.

    La creazione della connessione viene completata.

  2. Nel menu a discesa Tipo di fattura selezionare Ordine fornitore.

    Screenshot di una freccia che punta al tipo di fattura Ordine fornitore.

    Il campo Ordine fornitore ora dovrebbe essere visibile.

    Screenshot dell'azione personalizzata del connettore con il campo Ordine fornitore visibile.

  3. Impostare l'opzione Tipo di fattura su Non ordine fornitore.

    Il campo Ordine fornitore ora non è più visibile.

    Screenshot dell'azione per il connettore personalizzato con il campo Purchase Order nascosto.

  4. Salvare il flusso.