Esercitazione 5: richiamare un'interfaccia REST usando BizTalk Server
Questa sezione fornisce una procedura dettagliata su come richiamare un endpoint REST usando BizTalk Server. In questa esercitazione si richiama un endpoint REST disponibile da Microsoft Azure Marketplace che restituisce i ritardi nei voli dei vettori aerei statunitensi. L'esercitazione usa la nuova scheda WCF-WebHttp introdotta in BizTalk Server per richiamare l'endpoint REST.
Scenario usato in questa esercitazione
Microsoft Azure Marketplace fornisce l'URL della risorsa REST seguente per recuperare i ritardi dei voli dei vettori aerei statunitensi:
https://api.datamarket.azure.com/oakleaf/US_Air_Carrier_Flight_Delays_Incr/On_Time_Performance
Se si immette questo URL nel Web browser, vengono richieste le credenziali per accedere alla risorsa. Dopo aver eseguito l'accesso a Microsoft Azure Marketplace, è possibile ottenere le credenziali dalla scheda Account personale nella pagina Web. Le credenziali vengono elencate in base alle etichette ID cliente (nome utente) e Chiave account primaria (password).
In questa esercitazione si usano l'URL della risorsa e le credenziali per configurare una porta di trasmissione WCF-WebHttp bidirezionale. La pipeline di ricezione della porta di trasmissione bidirezionale riceve il messaggio di risposta con i dettagli della versione di anteprima e pubblica il messaggio nel database della finestra di messaggio BizTalk Server. Sarà inoltre possibile configurare una porta di trasmissione FILE per la sottoscrizione a tutti i messaggi pubblicati dalla porta di trasmissione WCF-WebHttp. La porta di trasmissione FILE utilizza il messaggio dal BizTalk Server e lo copia in un percorso di file.
In uno scenario di business reale è possibile attivare la porta di trasmissione WCF-WebHttp associandola a un processo aziendale più esteso, ad esempio un indirizzo di ricezione che ottiene un messaggio da un'applicazione aziendale. Poiché tuttavia lo scopo dell'esercitazione è quello di mostrare come richiamare un'interfaccia REST, in questo caso è possibile usare un percorso FILE semplice che riceva un messaggio fittizio per attivare la porta di trasmissione.
In breve, per configurare questa soluzione, è necessario effettuare le seguenti operazioni:
Configurare un indirizzo di ricezione FILE per il prelievo di un messaggio di richiesta fittizio.
Configurare una porta di trasmissione WCF-WebHttp bidirezionale per richiamare l'URL della risorsa REST e ricevere una risposta.
Configurare una porta di trasmissione FILE unidirezionale per usare il messaggio di risposta con i dettagli relativi ai voli e copiarlo in un percorso file.
Configurare l'account microsoft Azure Marketplace
Per accedere ai dati sui ritardi dei voli esposti tramite l'endpoint REST, è necessario innanzitutto effettuare la sottoscrizione al feed di dati di esempio relativo ai ritardi dei voli delle compagnie aeree statunitensi. Eseguire quindi la procedura seguente:
Per eseguire la sottoscrizione al feed di dati
Accedere al Azure Marketplace Microsoft usando l'account Microsoft.
Nella scheda Dati individuare e fare clic sul servizio Us Air Carrier Flight Delay .
Nella pagina del servizio dati fare clic su Iscrizione. Nella pagina Iscrizione accettare le condizioni del contratto e quindi fare di nuovo clic su Iscriviti .
Nella scheda Account personale recuperare le credenziali per accedere al servizio dati. Le credenziali vengono elencate in base alle etichette ID cliente (nome utente) e Chiave account primaria (password). Queste credenziali saranno necessarie durante la configurazione della porta di trasmissione WCF-WebHttp .
Configurare il computer
Per configurare lo scenario usato in questa esercitazione, è necessario aver installato e configurato BizTalk Server nel computer. Se si vuole effettuare il provisioning di un computer BizTalk Server in una macchina virtuale Windows Azure, seguire le istruzioni riportate in Configurazione di BizTalk Server in una macchina virtuale di Azure.