Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
L'esempio HTTPRequestResponse illustra come usare il filtro ISAPI (Internet Server Application Programming Interface) di Microsoft BizTalk Server per consentire a un'applicazione ASP.NET di comunicare con un'orchestrazione di BizTalk Server.
Che cosa fa questo esempio
In questo esempio, l'applicazione ASP.NET invia una richiesta al filtro ISAPI di BizTalk Server. L'orchestrazione usa quindi questo messaggio e lo restituisce all'applicazione ASP.NET usando una risposta sincrona. È possibile ottenere l'integrazione tra l'orchestrazione di BizTalk Server e l'applicazione ASP.NET usando il filtro ISAPI di BizTalk Server.
In questo esempio, BizTalk Server e un'applicazione ASP.NET scambiano messaggi di ordine di acquisto (PO) e di avviso di ricezione utilizzando i seguenti passaggi.
Un'applicazione ASP.NET, usando una richiesta HTTP, invia un messaggio di ordine di acquisto XML a BizTalk Server.
BizTalk Server riceve il messaggio di ordine di acquisto XML e crea un messaggio di conferma dell'ordine di acquisto XML, quindi invia tale messaggio all'applicazione ASP.NET nella risposta HTTP.
L'applicazione ASP.NET riceve la risposta di riconoscimento dell'ordine di acquisto XML e aggiorna il modulo Web con informazioni sullo stato estratte dalla risposta.
Dove trovare questo esempio
<Samples Path>\AdaptersUsage\HTTPRequestResponse\
La tabella seguente illustra i file in questo esempio e ne descrive lo scopo.
| File | Descrizione |
|---|---|
| Cleanup.bat | Annulla la distribuzione degli assembly e li rimuove dalla Global Assembly Cache (GAC); rimuove le porte di invio e ricezione; rimuove le directory virtuali di Microsoft Internet Information Services (IIS) in base alle esigenze. |
| HTTPRequestResponse.btproj, HTTPRequestResponse.sln | Fornisce file di progetto e di origine per il progetto BizTalk che riceve la richiesta HTTP, elabora il messaggio dell'ordine di acquisto ed emette la risposta. |
| HTTPRequestResponseBinding.xml | Fornisce la configurazione automatizzata, ad esempio l'associazione di porte. |
| POAck.xsd, POSchema.xsd | Fornisce rispettivamente gli schemi per il riconoscimento PO e i file .xml. |
| POReceiveOrchestration.odx | Fornisce un'orchestrazione di BizTalk Server che riceve l'ordine di acquisto, lo elabora ed emette la conferma dell'ordine di acquisto. |
| Setup.bat | Compila e inizializza questo esempio. |
| Nella cartella \RequestResponse: AssemblyInfo.cs, default.aspx, default.aspx.cs, Global.asax, Global.asax.cs, RequestResponse.csproj, RequestResponse.csproj.webinfo, RequestResponse.sln, Web.config |
Contiene file che costituiscono l'applicazione ASP.NET che funge da driver per questo esempio, inclusi i file di progetto e di soluzione, i file ASPX, i file di origine .NET di Microsoft Visual C# e così via. |
Compilazione e inizializzazione di questo esempio
Usare la procedura seguente per compilare e inizializzare l'esempio HTTPRequestResponse.
Per compilare e inizializzare questo esempio
In una finestra di comando passare alla cartella seguente:
< Percorso> degli esempi\AdaptersUsage\HTTPRequestResponse
Eseguire il file Setup.bat, che esegue le azioni seguenti:
Compila e configura l'applicazione ASP.NET usata per guidare questo esempio.
Annotazioni
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 di BizTalk Server usata in questo esempio.
Compila e distribuisce i progetti di Microsoft Visual Studio per questo esempio.
Crea e associa le porte di BizTalk Server necessarie.
Avvia l'orchestrazione di BizTalk Server.
Importante
È necessario modificare il codice di esempio che implementa l'applicazione Web (Default.aspx.cs) in modo da riflettere l'ambiente:
< http:// server name>/<virtual dir>/BTSHTTPReceive.dll dove
<servername>è il nome del server Web in cui si sta pubblicando e<virtual dir>è la directory virtuale in cui si trova questo file.Annotazioni
È necessario verificare che BizTalk non abbia riportato errori durante il processo di compilazione e inizializzazione prima di tentare di eseguire questo esempio.
Annotazioni
Se si sceglie di aprire e compilare i progetti in questo esempio senza eseguire il file Setup.bat, è prima necessario creare una coppia di chiavi con nome sicuro usando l'utilità nome sicuro di .NET Framework (sn.exe). Usa questa coppia di chiavi per firmare gli assembly risultanti. È anche necessario rimuovere manualmente i riferimenti a default.aspx.resx e Global.asax.resx dal file RequestResponse.csproj prima di tentare di compilare il progetto.
Annotazioni
Per annullare le modifiche apportate da Setup.bat, eseguire Cleanup.bat. È necessario eseguire Cleanup.bat prima di eseguire Setup.bat una seconda volta.
Annotazioni
È necessario configurare e abilitare IIS per l'uso dell'adapter di ricezione HTTP. Per altre informazioni, vedere Come configurare IIS per un percorso di ricezione HTTP.
Il file setup.bat configura la directory virtuale per l'esecuzione di questo esempio nel pool di applicazioni IIS associato al sito Web predefinito. Per configurare la directory virtuale affinché questo esempio venga eseguito nel contesto di un utente dei gruppi di utenti BizTalk Isolated Host Users e IIS_IURS, è necessario configurare la directory virtuale per essere eseguita in un nuovo pool di applicazioni IIS. Configurare la directory virtuale per l'esecuzione in un nuovo pool di applicazioni IIS completando i passaggi seguenti:
Annotazioni
Se è già stato creato un nuovo pool di applicazioni per un altro esempio di SDK, è possibile procedere con l'ultimo passaggio seguente.
Fare clic su Start, scegliere Tutti i programmi, Strumenti di amministrazione e quindi Gestione Internet Information Services (IIS).
In Gestione servizi Internet (IIS), navigare fino alla cartella Pool di applicazioni.
Fare clic con il pulsante destro del mouse sulla cartella Pool di applicazioni e scegliere Nuovo, Pool di applicazioni...
Immettere un nome per l'ID pool di applicazioni, ad esempio BizTalkSDKSamples, verificare che l'opzione Usa le impostazioni predefinite per il nuovo pool di applicazioni sia selezionata e fare clic su OK per creare il nuovo pool di applicazioni.
Fare clic con il pulsante destro del mouse sul nuovo pool di applicazioni e quindi scegliere Proprietà.
Fare clic sulla scheda Identità della finestra di dialogo delle proprietà e cambiare l'identità con cui viene eseguito questo pool di applicazioni a un utente che è membro del gruppo di utenti BizTalk Isolated Host Users. Questo utente deve anche essere membro del gruppo di utenti locale IIS_IURS .
Configurare la directory virtuale per questo esempio sdk da eseguire nel nuovo pool di applicazioni. L'impostazione Pool di applicazioni è disponibile nella scheda Virtual Directory della finestra di dialogo Proprietà del Virtual Directory. La directory virtuale creata per questo esempio è HttpRequestResponseSample.
Esecuzione di questo esempio
Usare la procedura seguente per eseguire l'esempio HTTPRequestResponse.
Per eseguire questo esempio
In Internet Explorer passare a http://localhost/RequestResponse/.
Completare i campi necessari nel modulo Web e quindi fare clic su Effettua ordine per inviare l'ordine.
Osservare lo stato dell'ordine quando il modulo Web viene aggiornato dopo aver ricevuto una risposta.
Comments
L'estensione BTSHTTPReceiveISAPI usata in questo esempio è configurata per funzionare in un'installazione predefinita di un singolo computer. Per estendere questo esempio per altre configurazioni, vedere Adapter HTTP.
È possibile estendere questo esempio alle applicazioni necessarie per inviare dati a BizTalk Server tramite un modulo Web o tramite HTTP in generale. Estendendo la parte dell'applicazione ASP.NET di questo esempio, è possibile eseguire una query per altre informazioni ed eseguire altre operazioni di pre-elaborazione prima di inviare i dati a BizTalk Server.