Esercizio - Creare e chiamare un connettore personalizzato da un flusso di lavoro di App per la logica di Azure

  • 10 minuti

È presente un'API Web denominata Print Framer che calcola il costo di una cornice in base alle dimensioni specificate. Gli sviluppatori dell'azienda vogliono usare l'API nei flussi di lavoro di App per la logica di Azure, ma attualmente non è possibile effettuare questa connessione in alcun modo.

In questo esercizio si creerà un connettore personalizzato per l'API Print Framer da usare per inviare e ricevere dati da un flusso di lavoro delle app per la logica a un'API Web. È prima di tutto necessario avere a disposizione un flusso di lavoro delle app per la logica.

Creare il flusso di lavoro di un'app per la logica

  1. Nel menu del portale di Azure o nella home page, in Servizi di Azure selezionare Crea una risorsa. Viene visualizzato il riquadro Crea una risorsa.

  2. Nel riquadro del menu a sinistra selezionare Integrazione, quindi cercare e selezionare App per la logica.

  3. Nel riquadro Crea app per la logica, in Informazioni di base immettere i valori seguenti per ogni impostazione.

    Impostazione Valore
    Dettagli del progetto
    Subscription Concierge Subscription
    Gruppo di risorse Selezionare il gruppo di risorse sandbox
    Dettagli dell'istanza
    Nome app per la logica Specificare un nome univoco. Ricordare il nome per usarlo in seguito.
    Pubblica Flusso di lavoro
    Area Selezionare un'area nelle vicinanze.
    Abilitare l'analisi dei log No
    Piano
    Tipo di piano Consumo
    Ridondanza della zona
    Ridondanza della zona Lasciare l'impostazione predefinita (disabilitata)

    La sandbox gratuita consente di creare risorse in un subset delle aree globali di Azure. Selezionare un'area nell'elenco seguente durante la creazione delle risorse:

    • Stati Uniti occidentali 2
    • Stati Uniti centro-meridionali
    • Stati Uniti centrali
    • Stati Uniti orientali
    • Europa occidentale
    • Asia sud-orientale
    • Giappone orientale
    • Brasile meridionale
    • Australia sud-orientale
    • India centrale

  4. Selezionare Rivedi e crea e dopo il superamento della convalida, selezionare Crea.

  5. Dopo aver creato la risorsa dell'app per la logica nel portale, selezionare Vai alla risorsa.

    Il portale di Azure mostra una raccolta con trigger e modelli di flusso di lavoro usati di frequente.

  6. Selezionare Progettazione app per la logica nel menu a sinistra, e quindi selezionare Aggiungi un trigger.

  7. Cercare e selezionare Quando viene ricevuta una richiesta HTTP.

    La finestra di progettazione del flusso di lavoro visualizza ora il trigger selezionato.

  8. Selezionare Mostra tutto nella sezione Parametri avanzati.

  9. Selezionare GET nell'elenco a discesa Metodo.

  10. Immettere {height}/{width} come stringa letterale nel campo Percorso relativo.

    Screenshot che mostra le informazioni sul trigger Richiesta.

  11. Sulla barra degli strumenti della finestra di progettazione seleziona Salva.

È ora disponibile un flusso di lavoro delle app per la logica di base. Aggiungeremo ora un connettore personalizzato per poter chiamare l'API personalizzata Print Framer dal flusso di lavoro.

Creare un nuovo connettore personalizzato di App per la logica di Azure nel portale di Azure

  1. Nel menu del portale di Azure o nella home page, in Servizi di Azure selezionare Crea una risorsa. Viene visualizzato il riquadro Crea una risorsa.

  2. Nella casella di ricerca cercare e selezionare Connettore personalizzato per app per la logica.

  3. Nel riquadro Connettore personalizzato per app per la logica selezionare Crea.

  4. Nel riquadro Crea connettore personalizzato per app per la logica, in Informazioni di base immettere i valori seguenti per ogni impostazione.

    Impostazione Valore
    Dettagli di progetto
    Subscription Concierge Subscription
    Gruppo di risorse Selezionare il gruppo di risorse sandbox
    Dettagli istanza
    Nome del connettore personalizzato PrintFramerConnector
    Area Selezionare un'area vicina e supportata anche dalla sandbox.
    Associare all'ambiente del servizio di integrazione Non selezionare alcun elemento

  5. Selezionare Rivedi e crea. Al completamento della convalida selezionare Crea.

  6. Al completamento della distribuzione, selezionare Vai alla risorsa.

Importare la definizione OpenAPI

Usare ora il file OpenAPI salvato in precedenza per definire il connettore personalizzato.

  1. Nel portale di Azure o nella home page selezionare Tutte le risorse e quindi selezionare PrintFramerConnector.

  2. Nella pagina Panoramica selezionare Modifica.

    Screenshot che mostra l'editor per il connettore personalizzato.

  3. Nella sezione Connettori personalizzati selezionare File OpenAPI e quindi Importa. Aprire il file JSON salvato nell'esercizio precedente.

Configurare il connettore personalizzato

Il file OpenAPI indica al connettore personalizzato le operazioni disponibili nell'API Web. È necessario impostare altre proprietà per il connettore personalizzato.

  1. Nella sezione Informazioni generali nella casella Descrizione digitare Ottieni un preventivo per una cornice. Potrebbe essere necessario scorrere verso il basso per visualizzare questa parte del riquadro di configurazione.

  2. Nella casella di testo Host immettere l'URL di esempio annotato in precedenza.

  3. Nel riquadro Sicurezza verificare che sia selezionata l'opzione Nessuna autenticazione.

    Importante

    Per questa dimostrazione, è possibile consentire l'accesso all'API senza alcuna autenticazione. Per le API del mondo reale che contengono dati riservati o richiedono una sottoscrizione a pagamento, l'autenticazione è essenziale.

  4. Nel riquadro Definizione nella casella di testo Riepilogo immettere Stima il costo di una cornice.

  5. In Visibilità selezionare Importante.

  6. Nella parte superiore del riquadro selezionare Aggiorna connettore.

Aggiungere il connettore personalizzato al flusso di lavoro delle app per la logica

È ora possibile usare il connettore personalizzato nel flusso di lavoro delle app per la logica.

  1. Nel portale di Azure o nella home page in Risorse di Azure selezionare Tutte le risorse e quindi selezionare la risorsa app per la logica creata nell'unità 3.

  2. Nel menu della risorsa app per la logica selezionare Panoramica. Sulla barra degli strumenti del riquadro Panoramica selezionare Modifica.

  3. Nella finestra di progettazione selezionare Nuovo passaggio>Aggiungi un'azione.

  4. Nella casella di ricerca Scegliere un'operazione selezionare Personalizzato e quindi selezionare PrintFramerConnector.

  5. In Azioni selezionare Stima il costo di una cornice.

  6. Nella casella Estimate the cost of a picture frame (Stimare il costo di una cornice) posizionare il cursore nel campo Height (Altezza). Nell'elenco di contenuto dinamico visualizzato selezionare height.

    Lo screenshot seguente illustra questa selezione:

    Screenshot che mostra il connettore personalizzato e il parametro

  7. Tornare al connettore personalizzato e posizionare il cursore nel campo Width (Larghezza). Nell'elenco di contenuto dinamico selezionare width.

    I parametri di larghezza e altezza ricevuti da ogni richiesta HTTP che attiva il flusso di lavoro sono ora associati ai parametri di larghezza e altezza passati a PrintFramerConnector.

Completare il flusso di lavoro

Infine, il flusso di lavoro deve prevedere un modo per visualizzare i risultati. È possibile usare l'azione Risposta per visualizzare la stima:

  1. Nella finestra di progettazione del flusso di lavoro selezionare Nuovo passaggio.

  2. Nella casella di ricerca Scegliere un'operazione immettere Risposta e quindi selezionare l'azione denominata Risposta.

  3. Nella casella di testo Corpo immettere Il costo approssimativo della cornice è:$.

  4. Nell'elenco di contenuto dinamico visualizzato selezionare Corpo dalla sezione Estimate the cost of a picture frame (Stima il costo di una cornice).

    Lo screenshot seguente mostra questa selezione:

    Screenshot che mostra la configurazione per l'azione

  5. Al termine, selezionare Salva per salvare il flusso di lavoro.

Testare il flusso di lavoro

Il flusso di lavoro è ora completo e chiamerà l'API Web tramite il connettore personalizzato. A questo punto è sufficiente inviare una richiesta che attiva il flusso di lavoro, operazione possibile usando il browser.

  1. Nella finestra di progettazione del flusso di lavoro espandere l'azione Alla ricezione di una richiesta HTTP.

  2. Accanto al campo URL HTTP GET selezionare Copia URL.

  3. Aprire una nuova scheda del browser e incollare l'URL nella barra degli indirizzi.

  4. Nell'URL incollato sostituire il parametro {height} con 10. Sostituire il parametro {width} con 4. Premere INVIO.

    Nel riquadro del browser viene visualizzato un costo approssimativo.

  5. Provare a immettere altre larghezze e altezze.

Congratulazioni. È stato creato un flusso di lavoro delle app per la logica in grado di chiamare l'API Print Framer interna usando un connettore personalizzato.