HTTPSolicitResponse
L'esempio HTTPSolicitResponse illustra come creare un'orchestrazione di Microsoft BizTalk Server che sfrutta un'applicazione ASP.NET per elaborare i dati di orchestrazione. L'orchestrazione in questo esempio utilizza una porta richiesta-risposta per inviare un messaggio all'applicazione ASP.NET e recuperare la risposta. Utilizzando l'adapter HTTP si ottiene l'integrazione tra l'orchestrazione di BizTalk Server e l'applicazione ASP.NET. Per altre informazioni, vedere Adapter HTTP.
Questo esempio è costituito da un'orchestrazione di BizTalk Server che riceve una richiesta contenente due numeri da moltiplicare e soddisfa tale richiesta utilizzando la sequenza di passaggi seguente:
L'orchestrazione di BizTalk Server recupera un file di input con estensione xml da una cartella specifica.
L'orchestrazione utilizza una richiesta HTTP per inoltrare il codice XML dal file a un'applicazione ASP.NET moltiplicatrice.
L'applicazione ASP.NET moltiplicatrice risponde alla richiesta HTTP eseguendo la moltiplicazione e restituendo il risultato come codice XML nella risposta HTTP.
L'orchestrazione riceve il risultato come XML in una risposta HTTP e scrive tale risultato in un file con estensione xml in una cartella specifica.
<Percorso> esempi\AdaptersUsage\HTTPSolicitResponse
Nella seguente tabella sono riportati i file inclusi nell'esempio e ne viene descritto lo scopo.
File | Descrizione |
---|---|
Cleanup.bat | Annulla la distribuzione degli assembly e li rimuove dalla Global Assembly Cache (GAC); rimuove le porte di trasmissione e ricezione; rimuove le directory virtuali di Microsoft Internet Information Services (IIS) in base alle necessità. |
HttpSolicitResponse.btproj, HttpSolicitResponse.sln | Forniscono i file di progetto e di origine per il progetto BizTalk che include l'orchestrazione che utilizza l'applicazione ASP.NET moltiplicatrice, gli schemi associati e così via. |
HttpSolicitResponseBinding.xml | Consente la configurazione automatica, ad esempio il binding delle porte. |
MultiplyRequest.xsd, MultiplyResponse.xsd | Forniscono rispettivamente gli schemi per la richiesta di moltiplicazione e i messaggi XML di risposta. |
MultiplyTwoIntegers.odx | Fornisce un'orchestrazione di BizTalk Server che riceve un file con estensione xml che richiede un'operazione di moltiplicazione, inoltra la richiesta all'applicazione ASP.NET moltiplicatrice e quindi scrive la relativa risposta in un file. |
request_in.xml | File di input di esempio. |
Setup.bat | Compila e inizializza l'esempio. |
Nella cartella \Multiplier: Multiplier.aspx, Multiplier.aspx.cs, Multiplier.sln |
Contiene file dell'applicazione ASP.NET fondamentali per l'implementazione del servizio moltiplicatore, tra cui file di progetto e di soluzione, file ASPX, file di origine di Microsoft Visual C# .NET e così via. |
Utilizzare la procedura riportata di seguito per compilare e inizializzare l'esempio HTTPSolicitResponse.
Nota
Questo esempio non funziona se il nome dell'indirizzo di ricezione include caratteri maiuscoli.
In una finestra di comando passare alla seguente cartella:
<Percorso> esempi\AdaptersUsage\HTTPSolicitResponse
Eseguire il file Setup.bat. Verranno eseguite le operazioni seguenti:
Crea le cartelle di input e output per questo esempio:
<Percorso> esempi\AdaptersUsage\HttpSolicitResponse\HttpSolicitResponseInput
<Percorso> esempi\AdaptersUsage\HttpSolicitResponse\HttpSolicitResponseOutput
Compila e configura l'applicazione ASP.NET moltiplicatrice utilizzata da questo esempio.
Nota
Durante la creazione del pool di applicazioni in Gestione IIS, impostare la versione di DefaultAppPool.NET Framework su .Net Framework v4.0.
Compila e distribuisce l'orchestrazione BizTalk Server usata in questo esempio.
Crea e associa il percorso e le porte di ricezione necessari BizTalk Server.
Nota
Nell'esempio, durante la creazione e il binding delle porte vengono visualizzati i seguenti avvisi:
Nota
Warning: Receive handler not specified for receive location "HttpSolicitResponseReceiveLocation"; updating with first receive handler with matching transport type.
Nota
Warning: Host not specified for orchestration "Microsoft.Samples.BizTalk.HttpSolicitResponse.MultiplyTwoIntegers"; updating with first available host.
Abilita l'indirizzo di ricezione e avvia la porta di trasmissione.
Nota
L'orchestrazione in questo esempio utilizza una porta bidirezionale per l'interazione HTTP con l'applicazione ASP.NET.
Nota
Prima di provare a eseguire l'esempio, è necessario verificare che BizTalk non abbia segnalato errori durante il processo di compilazione e inizializzazione.
Nota
Se si sceglie di aprire e compilare i progetti dell'esempio senza eseguire il file Setup.bat, è necessario creare innanzitutto una coppia di chiavi con nome sicuro tramite l'Utilità Nome sicuro di .NET Framework (sn.exe) e utilizzarla per firmare gli assembly risultanti.
Nota
Per annullare le modifiche apportate da Setup.bat, eseguire Cleanup.bat. È necessario eseguire Cleanup.bat prima di eseguire Setup.bat una seconda volta.
Utilizzare la procedura seguente per eseguire l'esempio HTTPSolicitResponse.
Incollare una copia del file request_in.xml nella cartella HttpSolicitResponseInput.
Osservare il file con estensione xml creato nella cartella HttpSolicitResponseOutput. Il nome di questo file con estensione xml è basato sul GUID dell'ID del messaggio. Questo file contiene il risultato dell'operazione di moltiplicazione in formato XML.
Nota
È possibile modificare i valori dell'operando nel file di input per eseguire un'operazione di moltiplicazione diversa.
È possibile adattare questo esempio per comunicare con un sistema esterno diverso che espone un'interfaccia HTTP.
I file MultiplyRequest.xsd e MultiplyResponse.xsd sono gli schemi XML che definiscono il formato dei dati di input e di output per l'applicazione ASP.NET moltiplicatrice. L'orchestrazione utilizza questi file per definire i tipi di messaggio di richiesta e di risposta.