Esercizio - Uso di un modello di criteri per impostare dinamicamente l'URL host

  • 10 minuti

In questo esercizio si creerà un modello di criteri per impostare l'URL host alla creazione della connessione. Questo processo consentirà a una connessione di funzionare in un ambiente di test o produzione.

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.

Attività 1 - Importazione di una 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.

  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 ContosoInvoicingPolicyTemplates_1_0_0_2.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 - Modelli di criteri importata.

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

    Screenshot dei componenti della soluzione.

Attività 2 - Installazione di Microsoft Power Platform CLI

Microsoft Power Platform CLI include lo strumento da riga di comando paconn progettato per semplificare lo sviluppo di connettori personalizzati di Microsoft Power Platform. Lo strumento paconn usa il runtime di Python, che dovrà essere installato.

  1. Accedere alla pagina di download di Python e selezionare il pulsante di download. È possibile usare qualsiasi versione successiva alla versione 3.5.

  2. Selezionare il file .exe scaricato per avviare l'installazione.

  3. Selezionare la casella di controllo Aggiungi Python xx a percorso, selezionare Installa, quindi attendere il completamento dell'installazione.

    Screenshot del processo di installazione di Python.

  4. Chiudere l'installazione guidata al termine dell'installazione.

  5. Avviare il prompt dei comandi, quindi eseguire il comando seguente per installare paconn.

    pip install paconn

    Screenshot dell'installazione del comando paconn.

  6. Attendere il completamento dell'installazione.

Attività 3 - Download in locale del connettore

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

  1. Eseguire il comando login.

    paconn login

  2. Copiare il Codice fornito.

  3. 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.

  4. Specificare le credenziali.

  5. Selezionare Continua.

  6. Viene visualizzato un messaggio di accesso riuscito.

    Screenshot del messaggio di accesso riuscito.

  7. Tornare al prompt dei comandi ed eseguire il comando di download.

    paconn download

  8. Quando viene richiesto di selezionare un ambiente, immettere un numero per l'ambiente in cui è stata installata la soluzione, quindi premere il tasto INVIO.

  9. Dovrebbe essere elencato un solo connettore, ovvero Contoso Invoicing - Criteri. Premere di nuovo il tasto INVIO per selezionare quel connettore.

  10. Il download dovrebbe essere completato correttamente. Prendere nota del percorso in cui è stato scaricato il connettore.

Attività 4 - Modifica di apiProperties.json per aggiungere la proprietà Host URL

In questa attività, si modificherà il file apiProperties.json per configurare la proprietà hostUrl. Dopo la configurazione della proprietà, agli utenti che creano una connessione viene richiesto questo valore insieme alla chiave API.

  1. Accedere alla cartella scaricata nell'attività precedente, quindi aprire il file apiProperties.json.

  2. Incollare il file JSON in ConnectionParameters, prima della proprietà api_key.

    "hostUrl": {
        "type": "string",
        "uiDefinition": {
          "constraints": {
            "required": "true"
          },
          "description": "Specify your API Url e.g. https://test.contoso.com",
          "displayName": "API URL",
          "tooltip": "Specify your API Url e.g. https://test.contoso.com"
        }
      },

    Screenshot della proprietà hostUrl.

  3. Salvataggio delle modifiche.

  4. Andare al prompt dei comandi e cambiare directory passando alla cartella scaricata.

  5. Eseguire il comando update.

    paconn update --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png

  6. Selezionare l'ambiente corretto in cui è stata installata la soluzione.

  7. Selezionare il connettore Contoso Invoicing - Criteri.

L'aggiornamento dovrebbe essere completato correttamente.

Attività 5 - Aggiunta dei criteri Imposta nome host

In questa attività si configurerà il modello di criteri Imposta nome host per usare la proprietà di connessione configurata nell'attività precedente.

  1. Accedere a Power Apps Maker Portal e verificare che sia selezionato l'ambiente corretto.

  2. Selezionare Soluzioni, quindi aprire la soluzione Contoso Invoicing - Modelli di criteri importata.

  3. Selezionare il connettore personalizzato Contoso Invoicing - Criteri e quindi Modifica.

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

  4. Selezionare la scheda Definizione.

  5. Scorrere verso il basso fino alla sezione Criteri e selezionare + Nuovi criteri.

    Screenshot con una freccia che punta al pulsante per l'aggiunta di nuovi criteri.

  6. Immettere Criteri URL host in Nome e selezionare Imposta URL host in Modello.

    Screenshot con una freccia che punta alla selezione del modello host.

  7. Immettere @connectionParameters('hostUrl') in Modello URL e selezionare Aggiorna connettore.

    Screenshot con una freccia che punta al pulsante Aggiorna connettore.

    L'aggiornamento del connettore dovrebbe essere completato correttamente.

  8. Rimanere su questa pagina.

Attività 6 - Test

In questa attività si creerà una connessione usando la nuova configurazione e successivamente la si verificherà.

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

  2. Selezionare il collegamento Chiave API.

  3. Copiare la chiave API.

  4. Tornare a connettore.

  5. Selezionare la scheda Test.

  6. Selezionare + Nuova connessione.

    Screenshot con una freccia che punta al pulsante Nuova connessione.

  7. Immettere https://contosoinvoicingtest.azurewebsites.net/ in URL API, incollare la Chiave API copiata e quindi selezionare Crea connessione.

  8. Selezionare Aggiorna connessioni.

    Screenshot con una freccia che punta al pulsante Aggiorna connessioni.

  9. Selezionare ListInvoice > Verifica operazione.

    Screenshot della finestra Verifica operazione.

    La verifica dovrebbe restituire fatture.

    Screenshot del campo Corpo della risposta.