Condividi tramite

Esercitazione 5: Richiamare un'interfaccia REST con BizTalk Server

Questa sezione fornisce una procedura dettagliata su come richiamare un endpoint REST tramite 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 il nuovo adattatore WCF-WebHttp introdotto 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 dell'account primario (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 del volo e pubblica il messaggio nel database del message box di BizTalk Server. Si configura una porta di trasmissione FILE che sottoscrive tutti i messaggi pubblicati dalla porta di trasmissione WCF-WebHttp. La porta di trasmissione FILE riceve il messaggio dal BizTalk Server e lo copia in una cartella.

In uno scenario aziendale reale, la porta di trasmissione WCF-WebHttp può essere attivata associandola a un processo aziendale più ampio, ad esempio una posizione di ricezione che riceve un messaggio da un'applicazione aziendale. Tuttavia, in questa esercitazione, poiché l'obiettivo è dimostrare come richiamare un'interfaccia REST, si può utilizzare un semplice percorso FILE che riceve un messaggio fittizio per attivare la porta di invio.

Per riepilogare, è quindi necessario seguire questa procedura per configurare questa soluzione:

  1. Configurare un percorso di ricezione FILE per selezionare un messaggio di richiesta fittizio.

  2. Configurare una porta di trasmissione bidirezionale WCF-WebHttp per richiamare l'URL della risorsa REST e ricevere una risposta.

  3. Configurare una porta di trasmissione FILE unidirezionale per utilizzare il messaggio di risposta con i dettagli del volo e copiarlo in un percorso di file.

Configurare l'account di Microsoft Azure Marketplace

Per accedere ai dati sui ritardi dei voli esposti tramite l'endpoint REST, è prima necessario sottoscrivere il feed di dati di esempio US Air Carrier Flight Delay. Per eseguire questa operazione, seguire questa procedura:

Per sottoscrivere il feed di dati

  1. Accedere a Microsoft Azure Marketplace usando l'account Microsoft.

  2. Nella scheda Dati, individuare e fare clic sul servizio US Air Carrier Flight Delays.

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

  4. 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 dell'account primario (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 che BizTalk Server sia installato e configurato nel computer. Se si vuole effettuare il provisioning di un computer BizTalk Server in una macchina virtuale di Windows Azure, seguire le istruzioni riportate in Configurazione di BizTalk Server in una macchina virtuale di Azure.

In questa sezione