Esercizio - Creazione di un connettore personalizzato certificato

6 minuti

In questo esercizio si usa l'interfaccia della riga di comando paconn per eseguire il download di un connettore, convalidare la definizione e risolvere problemi. Questo esercizio simula cosa fare per prepararsi alla creazione e alla certificazione di un connettore personalizzato open source.

Questo esercizio richiede l'installazione di Python e l'accesso al prompt dei comandi nella macchina usata per l'esercizio.

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.

Importazione della soluzione

In questa attività si importerà una soluzione non gestita contenente un connettore personalizzato Contoso Invoicing. Il connettore verrà usato per completare le attività di questo esercizio.

Accedere a Power Apps Maker Portal e assicurarsi di essere nell'ambiente corretto.
Selezionare Soluzioni > Importa soluzione.
Selezionare Sfoglia.
Selezionare la soluzione ContosoInvoicingOpenSource_1_0_0_0.zip, quindi Apri.
Selezionare Avanti.
Selezionare Importa e attendere il completamento dell'importazione. Al termine dell'importazione, dovrebbe apparire un messaggio di operazione riuscita.
Aprire la soluzione Contoso Invoicing - Open Source importata.

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

Installazione dell'interfaccia della riga di comando dei connettori Microsoft Power Platform

L'interfaccia della riga di comando dei connettori Microsoft Power Platform include lo strumento da riga di comando paconn progettato per semplificare lo sviluppo dei connettori personalizzati Microsoft Power Platform. Lo strumento paconn usa il runtime di Python, che deve essere installato.

Accedere alla pagina di download di Python e selezionare il pulsante di download. È possibile usare qualsiasi versione successiva alla versione 3.5.
Selezionare il file .exe scaricato per avviare l'installazione.
Selezionare la casella d controllo Aggiungi Python xx a percorso, selezionare Installa ora, quindi attendere il completamento dell'installazione.
Chiudere l'installazione guidata al termine dell'installazione.
Avviare il prompt dei comandi, quindi eseguire il comando seguente per installare paconn.

pip install paconn
Attendere il completamento dell'installazione.

Download in locale del connettore

In questa attività viene eseguito il download in locale dei file di definizione del connettore, in modo da aggiungere la proprietà Host URL.

Eseguire il comando paconn login.
Copiare il Codice fornito.
In un browser, accedere con le stesse credenziali dell'ambiente in uso. Passare alla pagina di accesso al dispositivo di Microsoft, incollare il Codice copiato, quindi selezionare Avanti.
Specificare le credenziali.
Selezionare Continua.

Viene visualizzato un messaggio di accesso riuscito.
Tornare al prompt dei comandi, dove viene visualizzato un messaggio indicante che l'accesso è stato eseguito correttamente.
Eseguire il comando di download.

paconn download
Quando viene richiesto di selezionare un ambiente, immettere un numero per l'ambiente in cui è stata installata la soluzione. Premere il pulsante Invio sulla tastiera.
Specificare il numero del connettore Contoso Invoicing - Open Source, quindi premere il tasto INVIO.
Il download dovrebbe essere completato correttamente. Prendere nota del percorso in cui è stato scaricato il connettore.

Convalida del connettore, correzione degli errori e aggiunta di metadati

In questa attività viene convalidato il connettore, vengono corretti alcuni errori comuni e vengono aggiunti i metadati del connettore richiesti.

Copiare il percorso in cui è stato scaricato il connettore.
Eseguire il comando di convalida usando il percorso copiato più il nome del file Swagger di definizione API \apiDefinition.swagger.json.

paconn validate --api-def [Path to apiDefinition.swagger.json]

Viene ricevuto un errore relativo a un riepilogo mancante per il quarto parametro dell'azione ListInvoices e a una proprietà contact mancante.
Correggere il riepilogo mancante. Accedere a Power Apps Maker Portal e assicurarsi di essere nell'ambiente corretto.
Selezionare Soluzioni, quindi aprire la soluzione Contoso Invoicing - Open Source.
Selezionare il connettore Contoso Invoicing - Open Source e quindi Modifica.
Selezionare la scheda Definizione, quindi scegliere l'azione ListInvoices.
Scorrere verso il basso fino alla sezione Richiesta, selezionare i puntini di sospensione (...) associati al parametro toAmount, quindi selezionare Modifica.
Immettere A importo nel campo Riepilogo e quindi selezionare Aggiorna connettore.
Attendere il completamento dell'aggiornamento del connettore.
Eliminare il connettore scaricato in precedenza, che dovrà essere di nuovo aggiunto a breve. Eliminare il connettore scaricato dal computer.
Eseguire di nuovo il download del connettore. Tornare al prompt dei comandi ed eseguire di nuovo il comando di download.

paconn download
Quando viene richiesto di selezionare un ambiente, immettere un numero per l'ambiente in cui è stata installata la soluzione. Premere il pulsante Invio sulla tastiera.
Specificare il numero del connettore Contoso Invoicing - Open Source, quindi premere il tasto INVIO.
Il download dovrebbe essere completato correttamente. Prendere nota del percorso in cui è stato scaricato il connettore.
Eseguire il comando di convalida usando il percorso copiato più il nome del file Swagger di definizione API \apiDefinition.swagger.json.

paconn validate --api-def [Path to apiDefinition.swagger.json]

A questo punto dovrebbe essere ricevuto un solo errore per il parametro di contatto mancante.
Andare alla cartella del connettore si cui è stato eseguito il download e aprire il file apiDefinition.swagger.json usando l'editor di testo scelto, ad esempio Blocco note.

Aggiungere una proprietà contact alle informazioni dopo la proprietà description.

"contact": {
  "name": "Contoso Support",
  "url": "https://contosoinvoicingtest.azurewebsites.net",
  "email": "info@Contoso.com"
}

Aggiungere i metadati del connettore dopo le informazioni.

"x-ms-connector-metadata": [
  {
   "propertyName": "Website",
   "propertyValue": "https://contosoinvoicingtest.azurewebsites.net"
  },
  {
   "propertyName": "Privacy policy",
   "propertyValue": "https://contosoinvoicingtest.azurewebsites.net"
  },
  {
   "propertyName": "Categories",
   "propertyValue": "Productivity"
  }
],

Selezionare File e Salva tutto per salvare tutte le modifiche.
Esegui di nuovo il comando di convalida.

paconn validate --api-def [Path to apiDefinition.swagger.json]

Ora il connettore dovrebbe essere convalidato correttamente.

Il connettore è stato preparato per essere creato come open source e quindi certificato. Se il connettore fosse reale, si procederebbe con la relativa pubblicazione su GitHub.

Esercizio - Creazione di un connettore personalizzato certificato

Importazione della soluzione

Installazione dell'interfaccia della riga di comando dei connettori Microsoft Power Platform

Download in locale del connettore

Convalida del connettore, correzione degli errori e aggiunta di metadati

Commenti e suggerimenti