Proprietà di configurazione di adapter HTTP
Nella tabella seguente vengono elencate le proprietà di configurazione che è possibile impostare per l'indirizzo di ricezione di un adapter HTTP.
| Nome proprietà | Type | Descrizione | Restrizioni | Commenti |
|---|---|---|---|---|
| ReturnCorrelationHandle | VT_BOOL | Specifica che, in caso di esito positivo, l'indirizzo di ricezione invia il token di correlazione del messaggio inviato nella risposta HTTP al client. | La proprietà è valida solo per gli indirizzi di ricezione unidirezionali. I valori validi sono: - -1 (true) - 0 (false) |
Nessuno |
| ResponseContentType | VT_BSTR | 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. Lunghezza minima: 0 Lunghezza massima: 256 |
Il valore predefinito è text/xml. |
| SuspendFailedRequests | VT_BOOL | Specifica se sospendere o meno le richieste HTTP per le quali l'elaborazione in ingresso ha esito negativo. | I valori validi sono: - -1 (true) - 0 (false) |
Il valore 0 (false) indica di eliminare la richiesta non riuscita e inviare un codice di stato di errore (401 o 500) al client. Il valore -1 (true) indica di sospendere la richiesta non riuscita e inviare al client il codice di stato "Accettato" (200) per le porte di ricezione unidirezionali o il codice di stato "Errore" (500) per le porte di ricezione bidirezionali. Il valore predefinito è 0 (false). |
| UseSSO | VT_BOOL | Specifica che deve essere utilizzato il servizio Enterprise Single Sign-On. | I valori validi sono: - -1 (true) - 0 (false) |
Il valore predefinito è 0 (false). |
| LoopBack | VT_BOOL | Specifica che il messaggio di richiesta ricevuto a questo indirizzo viene indirizzato a una porta di trasmissione o torna a questo indirizzo di ricezione per l'invio come risposta. | La proprietà è valida solo per gli indirizzi di ricezione di tipo richiesta-risposta. I valori validi sono: - -1 (true) - 0 (false) |
Il valore predefinito è 0 (false). |
Nel codice seguente viene illustrato il formato della stringa XML utilizzata per impostare le proprietà:
<CustomProps>
<ReturnCorrelationHandle vt="11">-1</ReturnCorrelationHandle>
<ResponseContentType vt="8">text/xml</ResponseContentType>
<SuspendFailedRequests vt="11">-1</SuspendFailedRequests>
<UseSSO vt="11">-1</UseSSO>
<LoopBack vt="11">-1</LoopBack>
</CustomProps></
Nella tabella seguente vengono illustrate le proprietà di configurazione che è possibile impostare per la porta di trasmissione di un adapter HTTP:
| Nome proprietà | Type | Descrizione | Restrizioni | Commenti |
|---|---|---|---|---|
| ProxyPort | VT_I4 | Specificare la porta del server proxy per la porta di trasmissione. | I valori validi sono compresi tra 0 e 65535. | Questa proprietà non richiede un valore se la proprietà UseProxy è impostata su 0 (false). Il valore predefinito è 80. |
| RequestTimeout | VT_I4 | Specifica il timeout in secondi per la trasmissione HTTP/HTTPS. | I valori validi sono compresi tra 0 e MAX_LONG. | Se l'adapter HTTP non riceve risposta entro il periodo di tempo specificato, il servizio registrerà l'errore e rinvierà il messaggio in base alle impostazioni per la riesecuzione. Se impostato su 0, il timeout viene calcolato automaticamente dal motore di messaggistica BizTalk in base alla dimensione del messaggio della richiesta. Se non viene fornito alcun valore, verrà utilizzato il valore per il gestore. |
| Certificato | VT_BSTR | Specificare l'identificazione personale del certificato client da utilizzare per stabilire una connessione SSL (Secure Sockets Layer). | Lunghezza minima: 0 Lunghezza massima: 59 |
Il valore predefinito è vuoto. |
| AuthenticationScheme | VT_BSTR | Specifica il tipo di autenticazione da utilizzare con il server di destinazione. | I valori validi sono: -Anonimo -Base -Digerire -Kerberos |
Il valore predefinito è Anonimo. |
| Username | VT_BSTR | Specifica il nome utente da utilizzare per l'autenticazione con il server di destinazione. | È necessario indicare un valore per questa proprietà se viene utilizzata la modalità Di base o Digest di AuthenticationScheme e non viene utilizzato il servizio Enterprise Single Sign-On. Lunghezza minima: 0 Lunghezza massima: 256 |
Nessuno |
| EnableChunkedEncoding | VT_BOOL | Specifica di utilizzare la codifica Chunked. | La codifica Chunked è implicitamente disattivata se il gestore di trasmissione HTTP è configurato su Utilizza proxy. I valori validi sono: - -1 (true) - 0 (false) |
Se questa opzione è attivata, l'adapter HTTP utilizzerà la codifica Chunked HTTP con una dimensione massima del blocco di 8 Kb. Il valore predefinito è 0 (false). |
| UseProxy | VT_BOOL | Specifica se il gestore di trasmissione HTTP utilizza un server proxy. | I valori validi sono: - -1 (true) - 0 (false) |
Il valore predefinito è 0 (false). |
| ProxyName | VT_BSTR | Specificare l'indirizzo del server proxy per la porta di trasmissione. | Lunghezza minima: 0 Lunghezza massima: 256 |
Questa proprietà non richiede un valore se la proprietà UseProxy è impostata su 0 (false). |
| UseSSO | VT_BOOL | Specificare se deve essere utilizzato il servizio Single Sign-On per recuperare le credenziali del client per l'autenticazione con il server di destinazione. | I valori validi sono: - -1 (true) - 0 (false) |
Il valore predefinito è 0 (false). |
| Password | VT_NULL | Specifica la password da utilizzare per l'autenticazione con il server di destinazione. | È necessario indicare un valore per questa proprietà se viene utilizzata la modalità Di base o Digest di AuthenticationScheme e non viene utilizzato il servizio Enterprise Single Sign-On. Questo valore è sempre impostato su null quando si esporta un file di associazione. Questo campo deve essere compilato manualmente con la password prima di importare il file di associazione nella configurazione di BizTalk Server di destinazione. Lunghezza minima: 0 Lunghezza massima: 256 |
Impostare il tipo di questa proprietà su VT_BSTR (vt="8") prima di importare il file di associazione, se si fornisce un valore per il campo. |
| MaxRedirects | VT_I4 | Specificare il numero massimo di reindirizzamenti consentiti per il messaggio da inviare. | I valori validi sono compresi tra 0 e 10. | Il valore predefinito è 5. |
| ContentType | VT_BSTR | Specificare il tipo di contenuto dei messaggi di richiesta. | Lunghezza minima: 0 Lunghezza massima: 256 |
Se non viene specificato un valore, verrà utilizzato il valore fornito per il gestore. |
| ProxyPassword | VT_NULL | Specificare la password utente da utilizzare per l'autenticazione con il server proxy. | Questo valore è sempre impostato su null quando si esporta un file di associazione. Questo campo deve essere compilato manualmente con la password prima di importare il file di associazione nella configurazione di BizTalk Server di destinazione. Lunghezza minima: 0 Lunghezza massima: 256 |
Questa proprietà non richiede un valore se la proprietà UseProxy è impostata su 0 (false). |
| ProxyUsername | VT_BSTR | Specificare il nome utente da utilizzare per l'autenticazione con il server proxy. | Lunghezza minima: 0 Lunghezza massima: 256 |
Questa proprietà non richiede un valore se la proprietà UseProxy è impostata su 0 (false). |
| UseHandlerSetting | VT_BOOL | Specifica che la configurazione per la porta di trasmissione deve utilizzare le impostazioni proxy specificate per il gestore di trasmissione HTTP. | I valori validi sono: - -1 (true) - 0 (false) |
Il valore predefinito è -1 (true). |
Nel codice seguente viene illustrato il formato della stringa XML utilizzata per impostare le proprietà:
<CustomProps>
<ProxyPort vt="3">80</ProxyPort>
<RequestTimeout vt="3">60</RequestTimeout>
<Certificate vt="8">A7 6D F9 06 5E FC 97 66 75 59 B5 D6 67 0C 84 DC 64 F5 BF B9</Certificate>
<AuthenticationScheme vt="8">Basic</AuthenticationScheme>
<Username vt="8">authenticateduser</Username>
<EnableChunkedEncoding vt="11">-1</EnableChunkedEncoding>
<UseProxy vt="11">-1</UseProxy>
<ProxyName vt="8">proxyserver</ProxyName>
<UseSSO vt="11">0</UseSSO>
<Password vt="1" />
<MaxRedirects vt="3">5</MaxRedirects>
<ContentType vt="8">text/xml</ContentType>
<ProxyPassword vt="1" />
<ProxyUsername vt="8">proxyuser</ProxyUsername>
<UseHandlerSetting vt="11">0</UseHandlerSetting>
</CustomProps>