Esercizio - Creazione di un connettore personalizzato da Visual Studio

  • 5 minuti

In questo esercizio si procederà a creare un connettore personalizzato nell'ambiente Power Platform dall'API Web in Visual Studio.

Power Platform consente agli sviluppatori di API Web di creare rapidamente applicazioni Web o per dispositivi mobili usando un'app canvas Power Apps come front-end. Con il servizio connesso Power Platform in Visual Studio 2022, gli sviluppatori di API Web ASP.NET possono creare facilmente un connettore personalizzato da usare con Power Apps.

Nota

Per usare Visual Studio e Power Apps in questo esercizio è necessario fare quanto segue:

  • Installare Visual Studio 2022 con il carico di lavoro di sviluppo ASP.NET e Web installato. Occorre aver effettuato l'accesso a Visual Studio per creare e usare i tunnel di sviluppo. La funzionalità non è disponibile in Visual Studio per Mac.
  • Creare un ambiente per sviluppatori Power Platform gratuito.
  • Scaricare gli esempi.

Aggiunta di Power Platform come servizio connesso

  1. Aprire questa API di esempio da GitHub con Visual Studio. Questo è un progetto API Web ASP.NET Core.

  2. Nel progetto, in Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo Servizi connessi e selezionare Aggiungi > Microsoft Power Platform.

    Screenshot dei servizi connessi da aggiungere. L'opzione Microsoft Power Platform è evidenziata.

  3. Selezionare o immettere i seguenti valori:

    • Ambienti Power Platform: select your developer environment
    • Soluzioni Power Platform: Common Data Service Default Solution
    • Connettore personalizzato: selezionare l'icona + e immettere InventoryLocations_Connector

    Screenshot della configurazione dei servizi connessi.

  4. Per il campo Seleziona un tunnel di sviluppo pubblico selezionare l'icona + e i seguenti valori:

    • Nome: devtunnel
    • Tipo di tunnel: Persistent
    • Accesso: Public

    Screenshot della configurazione del tunnel di sviluppo.

  5. Selezionare OK e Fine. Una volta configurato il servizio connesso, è possibile selezionare Chiudi.

    Screenshot del processo di configurazione dei servizi connessi in completamento.

Si è così creato un connettore personalizzato per le ubicazioni di magazzino, che sfrutta i tunnel di sviluppo per connettere l'API a Power Platform. Di seguito è mostrato il ciclo interno in cui si sta eseguendo l'API nell'ambiente locale.

Esecuzione dell'API

Quando Visual Studio esegue un'app Web e un tunnel è attivo, il Web browser si apre su un URL del tunnel anziché su un URL localhost.

  1. Eseguire la soluzione Visual Studio e avviare il debug.

    Screenshot dell'icona di esecuzione del debug.

  2. All'apertura del browser, si apre una pagina di avviso con la prima richiesta inviata all'URL del tunnel. Selezionare Continua.

    Screenshot della pagina di avviso iniziale.

Importante

Mantenere l'API in esecuzione (in una scheda del browser) durante la creazione della Power App.

Creazione di un'app dall'API

Nota

Per usare l'app di esempio fornita in questo passaggio, è necessario installare Power Platform Tools per Visual Studio Code.

  1. Aprire Visual Studio Code e creare una nuova autenticazione per l'utente usando il comando di Power Platform CLI. Sostituire l'URL con l'URL del proprio ambiente di sviluppo, reperibile nell'interfaccia di amministrazione.

    pac auth create --url https://yourenvironment.crm.dynamics.com

  2. Recuperare il connettore personalizzato creato. Copiare l'ID connettore.

    pac connector list

  3. Generare un'app canvas (file *.msapp) in base alle operazioni dell'API.

    pac canvas create --connector-id your connector id --msapp your file name.msapp

Anteprima dell'app

  1. Aprire Power Apps.

  2. Selezionare App vuota. Da App canvas da modello vuoto selezionare Crea.

    Screenshot della creazione guidata app.

  3. Immettere il nome Inventory app e selezionare il formato Tablet. Selezionare Crea.

    Screenshot della creazione guidata app con l'inserimento di un nome per l'app.

  4. Dalla barra dei comandi selezionare ..., quindi Apri.

    Screenshot che mostra come aprire un'app esistente.

  5. Selezionare e aprire il file *.msapp creato nel passaggio 3. Questa operazione carica l'app di esempio nello studio.

    Screenshot dell'opzione Sfoglia file.

  6. Nella barra a sinistra selezionare l'icona dei dati e Aggiungi dati. Cercare InventoryLocations_Connector per selezionare Connetti. Questo è il connettore personalizzato creato dall'API Web.

    Screenshot che mostra come aggiungere il connettore personalizzato.

  7. Per visualizzare in anteprima l'app, selezionare l'icona di riproduzione.

    Screenshot dell'icona di visualizzazione dell'anteprima dell'app.

  8. Selezionare il pulsante OTTIENI dell'app per visualizzare un elenco delle ubicazioni di magazzino.

    Screenshot dell'anteprima dell'app.

  9. Selezionare l'icona di chiusura in alto a destra nell'app per tornare allo studio. Selezionare l'icona di pubblicazione per salvare il lavoro.

    Screenshot dell'icona di pubblicazione.

Suggerimento

  • Se l'API di esempio non restituisce nessun paese/area geografica, assicurarsi che l'API sia in esecuzione mentre si crea l'app.
  • Poiché si stanno usando i tunnel di sviluppo, è possibile applicare processi iterativi sull'API in tempo reale, inclusi il debug e il ricaricamento a caldo.

La creazione di un'app e di un connettore personalizzato dall'API Web è così completata.