Come configurare un indirizzo di ricezione HTTP

Le variabili dell'adapter dell'indirizzo di ricezione HTTP possono essere impostate sia a livello di codice, sia utilizzando la Console di amministrazione BizTalk Server. Se non vengono impostate proprietà nell'indirizzo di ricezione, verranno utilizzati i valori del gestore di ricezione predefinito impostati nella Console di amministrazione BizTalk Server.

Nota

Prima di completare la seguente procedura, è necessario avere già aggiunto una porta di ricezione. Per altre informazioni, vedere Come creare una porta di ricezione.

Come configurare un indirizzo di ricezione HTTP a livello di codice

L'adapter HTTP archivia le rispettive informazioni di configurazione nel database di gestione BizTalk (detto anche database di configurazione). La configurazione è memorizzata in un elenco delle proprietà XML personalizzato.

Il modello a oggetti di BizTalk Explorer espone l'interfaccia di configurazione IReceiveLocation , che dispone di una proprietà di lettura/scrittura TransportTypeData . Tale proprietà accetta l'elenco delle proprietà di configurazione della porta di ricezione HTTP in una stringa XML costituita dalla coppia nome/valore.

L'impostazione della proprietà TransportTypeData di IReceiveLocation non è obbligatoria. Se non è impostata, vengono utilizzati i valori predefiniti per la configurazione dell'indirizzo di ricezione HTTP. Nella tabella seguente sono elencati i valori predefiniti e le proprietà di configurazione che è possibile impostare nel modello a oggetti di BizTalk Explorer per l'indirizzo di ricezione HTTP.

Nome proprietà	Type	Descrizione	Restrizioni	Commenti
ResponseContentType	string	Tipo di contenuto dei messaggi di risposta HTTP restituiti dall'adapter HTTP ai client dall'indirizzo di ricezione. Questa proprietà è valida solo per le porte di ricezione di tipo richiesta-risposta e viene ignorata per le porte di ricezione unidirezionali.	string Lunghezza minima: 0 Lunghezza massima: 256	Valore predefinito: Testo/XML
Loopback	Boolean	Specifica che il messaggio di richiesta ricevuto a questo indirizzo verrà indirizzato a una porta di trasmissione o tornerà a questo indirizzo di ricezione per l'invio come risposta. La proprietà è valida solo per le porte di ricezione di tipo richiesta-risposta. Viene ignorata per le porte di ricezione unidirezionali.	Nessuno	Valore predefinito: False
ReturnCorrelationHandle	Boolean	Specifica che, in caso di esito positivo, l'adapter HTTP invia il token di correlazione del messaggio inviato nella risposta HTTP al client. Questa proprietà è valida solo per le porte di ricezione unidirezionali e viene ignorata per le porte di ricezione di tipo richiesta-risposta.	Nessuno	Valore predefinito: Vero
SuspendFailedRequests	Boolean	Specifica se sospendere le richieste HTTP non riuscite. Il valore True indica di sospendere la richiesta non riuscita e inviare al client il codice di stato "Accettato" (202) per le porte di ricezione unidirezionali o il codice di stato "Errore" (500) per le porte di ricezione bidirezionali.	Nessuno	Valore predefinito: False
UseSSO	Boolean	Specifica se l'adapter HTTP rilascia il ticket SSO ai messaggi che giungono all'indirizzo di ricezione.	Nessuno	Valore predefinito: False

Il formato della stringa XML per impostare queste proprietà è il seguente:

<CustomProps>  
   <UseSSO vt="11">-1</UseSSO>  
   <SuspendFailedRequests vt="11">-1</SuspendFailedRequests>  
   <ReturnCorrelationHandle vt="11">-1</ReturnCorrelationHandle>  
   <ResponseContentType vt="8">text/xml</ResponseContentType>  
   <LoopBack vt="11">-1</LoopBack>  
</CustomProps>  

Come configurare un indirizzo di ricezione HTTP con la Console di amministrazione BizTalk Server

Per configurare l'indirizzo di ricezione utilizzando la Console di amministrazione BizTalk Server, attenersi alla seguente procedura.

Per configurare le variabili per un indirizzo di ricezione HTTP

1. Configurare Internet Information Services (IIS) in modo che utilizzi gli indirizzi di ricezione HTTP. Per istruzioni sulla configurazione di IIS, vedere Come configurare IIS per un percorso di ricezione HTTP.

2. Nella console di amministrazione di BizTalk Server espandere BizTalk ServerAmministrazione, espandere Gruppo BizTalk, espandere Applicazioni e quindi espandere l'applicazione in cui si vuole creare un percorso di ricezione.

3. Nel riquadro sinistro fare clic sul nodo Porte di ricezione . Nel riquadro destro fare quindi clic con il pulsante destro del mouse sulla porta di ricezione associata a un indirizzo di ricezione esistente o che si desidera associare a un nuovo indirizzo di ricezione e scegliere Proprietà.

4. Nel riquadro sinistro della finestra di dialogo Proprietà porta di ricezione selezionare Percorsi di ricezione e nel riquadro destro fare doppio clic su un percorso di ricezione esistente oppure fare clic su Nuovo per creare una nuova posizione di ricezione.

5. Nella finestra di dialogo Proprietà posizione di ricezione , nella sezione Trasporto accanto a Tipo selezionare HTTP dall'elenco a discesa e quindi fare clic su Configura.

6. Nella finestra di dialogo Proprietà trasporto HTTP eseguire le operazioni seguenti:

   Usare	Per
   Directory virtuale più estensione ISAPI	Specificare il nome della directory virtuale a cui vengono inviati i messaggi ricevuti dall'indirizzo di ricezione HTTP/HTTPS. Nel nome della directory virtuale sono compresi il nome della DLL dell'indirizzo di ricezione e una stringa di query facoltativa. Sono riportati di seguito esempi di nomi di directory virtuale: /<virtual directory>/BTSHTTPReceive.dll /<virtual directory>/BTSHTTPReceive.dll? Acquisto%20Order Questo percorso non deve contenere più di un'estensione ISAPI BTSHTTPReceive.dll, incluse tutte le sottocartelle. Digitare: Stringa Lunghezza massima: 256 Nota: l'URI per una porta di trasmissione o una posizione di ricezione non può superare i 256 caratteri.
   Indirizzo pubblico	Specificare l'URI completo dell'indirizzo di ricezione. Il valore di questa proprietà è una combinazione del nome del server e della directory virtuale. Il motore di messaggistica di BizTalk espone questo indirizzo per i partner esterni. L'URI specificato deve designare l'URL del sito Web pubblico a cui i partner commerciali devono connettersi per inviare messaggi a BizTalk Server. Queste informazioni sono facoltative e non vengono utilizzate da BizTalk Server. Questo parametro viene reso disponibile per consentire agli amministratori di documentare l'URL pubblico a cui l'indirizzo di ricezione è associato. Digitare: Stringa Lunghezza minima: 0 Lunghezza massima: 256
   Tipo di contenuto restituito	Specificare il tipo di contenuto dei messaggi di risposta HTTP restituiti ai client dall'indirizzo di ricezione. La proprietà è valida solo per gli indirizzi di ricezione di tipo richiesta-risposta. Valore predefinito: text/xml Digitare: Stringa Lunghezza minima: 0 Lunghezza massima: 256
   Loopback	Definire l'instradamento del messaggio di richiesta ricevuto in questo indirizzo verso una porta di trasmissione o di nuovo verso questo indirizzo di ricezione per l'invio come risposta. La proprietà è valida solo per gli indirizzi di ricezione di tipo richiesta-risposta. Valore predefinito: False Digitare: Boolean
   Restituire l'handle di correlazione in caso di esito positivo (solo porte unidirezionali)	Definire l'invio da parte dell'indirizzo di ricezione, in caso di esito positivo, del token di correlazione del messaggio inviato nella risposta HTTP al client. La proprietà è valida solo per gli indirizzi di ricezione unidirezionali. Valore predefinito: Vero Digitare: Boolean
   Utilizza Single Sign-On	Indicare che deve essere utilizzato il servizio Enterprise Single Sign-On. Valore predefinito: False Digitare: Nota booleana : se questa opzione è abilitata, è necessario abilitare anche l'opzione Consenti ticket a livello di sistema SSO . L'opzione Allow Tickets è configurabile nella scheda Opzioni della finestra di dialogo Proprietà di sistema SSO disponibile nell'interfaccia MMC amministrazione SSO . Se questa opzione è abilitata e l'opzione Consenti ticket a livello di sistema SSO non è abilitata, tutti i messaggi ricevuti da questa posizione di ricezione verranno sospesi.
   Sospendi richieste non riuscite	Indicare se sospendere o meno le richieste HTTP per le quali l'elaborazione in ingresso ha esito negativo. Il valore False indica di eliminare la richiesta non riuscita e inviare un codice di stato di errore (401 o 500) al client. Il valore True indica di sospendere la richiesta non riuscita e inviare un codice di stato "Accettato" (200) al client per le porte di ricezione unidirezionale o un codice di stato "Errore" (500) al client per le porte di ricezione bidirezionali. Valore predefinito: False Digitare: Boolean

7. Fare clic su OK per salvare le impostazioni.

8. Immettere i valori appropriati nella finestra di dialogo Proprietà indirizzo di ricezione per completare la configurazione dell'indirizzo di ricezione e fare clic su OK per salvare le impostazioni. Per informazioni sulla finestra di dialogo Proprietà indirizzo di ricezione , vedere Come creare un indirizzo di ricezione.

   Mentre il client HTTP chiama l'indirizzo HTTP, l'adapter HTTP lo autentica mediante autenticazione anonima, di base, del digest o integrata di Windows. Se l'utente viene verificato, il contesto dell'utente viene passato al gestore di ricezione.

Nota

Le configurazioni di IIS che consentono a SOAP e HTTP di condividere lo stesso processo non sono valide. È consentito un solo ricevitore isolato per processo.