Come configurare un percorso di ricezione HTTP

È possibile impostare le variabili dell'adapter del percorso di ricezione HTTP a livello di codice o tramite la console di amministrazione di BizTalk Server. Se le proprietà non sono impostate nel percorso di ricezione, vengono usati i valori predefiniti del gestore di ricezione impostati nella console di amministrazione di BizTalk Server.

Annotazioni

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

Come configurare un percorso di ricezione HTTP a livello di codice

L'adapter HTTP archivia le informazioni di configurazione nel database di gestione BizTalk , noto anche come database di configurazione. La configurazione viene archiviata in un contenitore di 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 . Questa proprietà accetta l'insieme di proprietà di configurazione della posizione di ricezione HTTP in una stringa XML contenente coppie nome-valore.

L'impostazione della proprietà TransportTypeData di IReceiveLocation non è obbligatoria. Se non è impostata, vengono usati i valori predefiniti per la configurazione del percorso di ricezione HTTP. La tabella seguente elenca i valori predefiniti ed elenca anche le proprietà di configurazione che è possibile impostare nel modello a oggetti di BizTalk Explorer per il percorso di ricezione HTTP.

Nome della proprietà	TIPO	Descrizione	Restrizioni	Commenti
ResponseContentType	corda	Tipo di contenuto dei messaggi di risposta HTTP che l'adapter HTTP invia ai client da questa posizione di ricezione. Questa proprietà è valida solo per le porte di ricezione request-response e viene ignorata per le porte di ricezione unidirezionale.	Stringa Lunghezza minima: 0 Lunghezza massima: 256	Valore predefinito: Testo/XML
Loopback	Booleano	Specifica che il messaggio di richiesta ricevuto in questa posizione verrà instradato a una porta di trasmissione o di nuovo alla posizione di ricezione da inviare come risposta. Questa proprietà è valida solo per le porte di ricezione request-response. Viene ignorato per le porte di ricezione unidirezionale.	Nessuno	Valore predefinito: Falso
ReturnCorrelationHandle	Booleano	Specifica che il token di correlazione del messaggio inviato che l'adattatore HTTP invia come risposta HTTP al client se l'invio ha esito positivo. Questa proprietà è valida solo per le porte di ricezione unidirezionale e viene ignorata per le porte di ricezione request-response.	Nessuno	Valore predefinito: Vero
SuspendFailedRequests	Booleano	Specifica se sospendere le richieste HTTP non riuscite. Il valore True indica di sospendere la richiesta non riuscita e inviare un codice di stato "Accettato" (202) al client per le porte di ricezione unidirezionale o un codice di stato "Errore" (500) al client per le porte di ricezione bidirezionali.	Nessuno	Valore predefinito: Falso
Usare Single Sign-On	Booleano	Specifica se l'adapter HTTP emetterà il ticket SSO ai messaggi che arrivano in questa posizione di ricezione.	Nessuno	Valore predefinito: Falso

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 percorso di ricezione HTTP con la console di amministrazione di BizTalk Server

Per configurare il percorso di ricezione tramite la console di amministrazione di BizTalk Server, seguire questa procedura.

Per configurare le variabili per un percorso di ricezione HTTP

1. Configurare Internet Information Services (IIS) per l'uso con i percorsi 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 una localizzazione di ricezione.

3. Nel riquadro sinistro fare clic sul nodo Porte di ricezione . Quindi, nel riquadro destro fare clic con il pulsante destro del mouse sulla porta di ricezione associata a un percorso di ricezione esistente o che si desidera associare a un nuovo percorso di ricezione, quindi 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 un nuovo percorso di ricezione.

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

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

   Usare questo	Per farlo
   Directory virtuale e estensione ISAPI	Specificare il nome della directory virtuale in cui si pubblicano i messaggi ricevuti dal percorso di ricezione HTTP/HTTPS. La directory virtuale include il nome della DLL della posizione di ricezione e una stringa di query opzionale. Esempi di nomi di directory virtuali sono: /<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. Tipo: 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 per questo percorso di ricezione. Il valore di questa proprietà è una combinazione del nome del server e della directory virtuale. Il motore di messaggistica BizTalk espone questo indirizzo ai partner esterni. L'URI specificato deve designare l'URL del sito Web pubblico a cui i partner commerciali si connettono durante l'invio di messaggi a BizTalk Server. Queste informazioni sono facoltative e non vengono usate da BizTalk Server. Questo parametro è disponibile per consentire agli amministratori di documentare l'URL pubblico a cui è associato il percorso di ricezione. Tipo: Stringa Lunghezza minima: 0 Lunghezza massima: 256
   Tipo di contenuto restituito	Specificare il tipo di contenuto dei messaggi di risposta HTTP restituiti dal percorso di ricezione ai client. Questa proprietà è valida solo per le sedi di ricezione richiesta-risposta. Valore predefinito: text/xml Tipo: Stringa Lunghezza minima: 0 Lunghezza massima: 256
   Loopback	Definire che il messaggio di richiesta ricevuto in questa posizione viene instradato verso una porta di invio o a questa posizione di ricezione per essere inviato come risposta. Questa proprietà è valida solo per i percorsi di ricezione di richiesta-risposta. Valore predefinito: Falso Digitare: Booleano
   Restituisce l'handle di correlazione in caso di esito positivo (solo porta unidirezionale)	Definire che, in caso di esito positivo, il percorso di ricezione invia al client il token di correlazione del messaggio inviato nella risposta HTTP. Questa proprietà è valida solo per le posizioni di ricezione unidirezionale. Valore predefinito: Vero Digitare: Booleano
   Usare l'Autenticazione unica (Single Sign-On)	Indicare che viene usato Enterprise Single Sign-On. Valore predefinito: Falso Tipo: Booleano Nota: se questa opzione è abilitata, è necessario abilitare anche l'opzione Consenti ticket a livello di sistema SSO. L'opzione Consenti ticket è 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 che non superano l'elaborazione in ingresso. Il valore False indica di rimuovere 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: Falso Digitare: Booleano

7. Fare clic su OK per salvare le impostazioni.

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

   Mentre il client HTTP chiama la localizzazione HTTP, l'adapter HTTP autentica il client HTTP usando l'autenticazione anonima, di base, digest o autenticazione integrata di Windows. Se l'utente viene verificato, il contesto utente viene passato al gestore di ricezione.

Annotazioni

Qualsiasi configurazione IIS che porta alla condivisione dello stesso processo da parte di SOAP e HTTP non è valida. È possibile avere un solo ricevitore isolato per processo.