您可以透過程式設計方式或使用 BizTalk Server 管理主控台來設定 HTTP 傳送埠。
以程式設計方式設定 HTTP 傳送埠
HTTP 配接器會將其組態資訊儲存在 BizTalk 管理資料庫中(也稱為組態資料庫)。 您會將組態資訊儲存在自訂 XML 屬性包中。 在 HTTP 配接器初始化及其運行時間期間,伺服器會將組態傳遞至配接器,如下所示:
針對 HTTP 傳送處理程式,組態資訊會藉由呼叫 IPersistPropertyBag 介面的 Load 方法傳遞至配接器。
針對 HTTP 傳送埠,組態資訊會以訊息內容上的一組屬性傳遞至配接器。 HTTP 命名空間會將這些屬性群組在一起。
BizTalk Explorer 物件模型會公開用於傳送埠的配接器組態介面,其中包含可讀寫的屬性。 這個屬性接受 HTTP 傳送埠組態屬性包做為名稱/值組 XML 字串。 請注意,若要在 BizTalk Explorer 物件模型中設定此屬性,必須先在 ITransportInfo 介面的 屬性上
Address設定此屬性。不需要設定 ITransportInfo 介面的 TransportTypeData 屬性。 如果未設定,HTTP 配接器將會使用 HTTP 傳送處理程式的預設值。
如果未定義複製處理程式組態的傳送埠組態屬性,則會使用處理程式的組態屬性。 如果 HTTP 傳送處理程式沒有組態值,HTTP 傳送配接器會在事件記錄檔中記錄錯誤,並將訊息移至備份配接器。
您可以在訊息內容上以程式設計方式設定組態屬性。 您可以在 BizTalk Server 協調流程排程或自定義管線元件中設定這些屬性。 使用這些屬性時,適用下列規則:
如果在協調流程或接收管線中的自訂管線元件上設定組態屬性,則:
如果訊息傳送至靜態傳送埠,則會以針對該傳送埠設定的值覆寫 屬性值。
如果訊息傳送至動態傳送埠,將不會覆寫屬性值。
如果元件屬性是在傳送管線的自訂管線元件中設定,則:
- 不論訊息是傳送至靜態或動態傳送埠,都不會覆寫此值。
下表列出您可以在 BizTalk Explorer 物件模型中為 HTTP 傳送位置設定的組態屬性。
| 屬性名稱 | 類型 | 說明 | 限制 | 評論 |
|---|---|---|---|---|
| RequestTimeout | xs:int | 等候伺服器回應的逾時期限。 如果設定為零 (0),系統會根據要求訊息大小計算逾時。 |
最小值: 0 最大值: MAX_LONG |
預設值: 0 |
| 內容類型 | xs:string | 要求訊息的內容類型 |
最小長度: 0 最大長度:256 |
預設值: 文字/XML |
| MaxRedirects | xs:int | HTTP 配接器可以重新導向要求的次數上限。 |
最小值: 0 最大值: 10 |
默認值: 5 |
| UseHandlerProxySettings | xs:boolean | 指定 HTTP 傳送埠是否會使用傳送處理程式的 Proxy 組態。 | 沒有 |
預設值: 真 若為 true,傳送埠會使用處理程式層級指定的 Proxy 設定。 若為 false,傳送配接器會使用傳送埠上指定的 Proxy 資訊。 |
| UseProxy | xs:boolean | 指定 HTTP 配接器是否會使用 Proxy 伺服器。 所有 HTTP 傳送埠都可以共用 Proxy 伺服器。 | 沒有 |
預設值: 假 如果 UseHandlerProxySettings 為 True,則會忽略此屬性。 |
| ProxyName | xs:string | 指定 Proxy 伺服器名稱。 |
最小長度: 0 最大長度:256 |
預設值: 空 如果 UseHandlerProxySettings 屬性設定為 True,HTTP傳送配接器會忽略此屬性。 否則,只有在 UseProxy 為 True時,HTTP 傳送配接器才會使用這個屬性。 如果 UseProxy 為 True,則需要此屬性。 |
| ProxyPort | xs:int | 指定 Proxy 伺服器埠。 |
最小值: 0 最大值: 65535 |
默認值: 80 如果 UseHandlerProxySettings 為 True,HTTP傳送配接器會忽略此屬性。 否則,只有在 UseProxy 為 True時,HTTP 傳送配接器才會使用這個屬性。 如果 UseProxy 為 True,則需要此屬性。 |
| ProxyUsername | xs:string | 指定使用 Proxy 伺服器進行驗證的用戶名稱。 |
最小長度: 0 最大長度:256 |
默認值: 空白 如果 UseHandlerProxySettings 為 True,HTTP傳送配接器會忽略此屬性。 否則,只有在 UseProxy 為 True時,HTTP 傳送配接器才會使用這個屬性。 |
| ProxyPassword | xs:string | 指定使用 Proxy 伺服器進行驗證的用戶密碼。 |
最小長度: 0 最大長度:256 |
默認值: 空白 如果 UseHandlerProxySettings 為 True,HTTP傳送配接器會忽略此屬性。 否則,只有在 UseProxy 為 True時,HTTP 傳送配接器才會使用這個屬性。 |
| AuthenticationScheme | xs:string | 要與目的地伺服器搭配使用的驗證類型。 | 沒有 |
有效值: - 匿名 (預設值) - 基本 - 摘要 - Kerberos |
| 使用者名稱 | xs:string | 要用於向伺服器進行驗證的用戶名稱。 |
最小長度: 0 最大長度:256 |
預設值: 空 如果您選取 [基本 ] 或 [ 摘要式 驗證],則需要此值。 如果 UseSSO 為 True,HTTP配接器會忽略此屬性的值。 |
| 密碼 | xs:string | 要用於向伺服器進行驗證的用戶密碼。 |
最小長度: 0 最大長度:256 |
默認值: 空白 如果您選取 [基本 ] 或 [ 摘要式 驗證],則需要此值。 如果 UseSSO 為 True,則會忽略此屬性的值。 |
| EnableChunkedEncoding | xs:boolean | 指定 HTTP 配接器是否使用區塊編碼 | 沒有 |
預設值: 對 |
| 憑證 | xs:string | 用戶端 SSL 憑證的指紋。 |
最小長度: 0 最大長度: 59 |
預設值: 空 |
| UseSSO | xs:boolean | 指定 SSO 是否將用於傳送埠。 | 沒有 | 預設值: 假 |
| AffiliateApplicationName | xs:string | 要用於 SSO 的分支機構應用程式名稱。 |
最小長度: 0 最大長度:256 |
默認值: 空白 如果UseSSO為True,則為必要項。 |
下列程式代碼顯示用來設定這些屬性的 XML 字串:
<CustomProps>
<ContentType vt="8">text/xml</ContentType>
<RequestTimeout vt="3">0</RequestTimeout>
<MaxRedirects vt="3">5</MaxRedirects>
<UseHandlerProxySettings vt="8">-1</UseHandlerProxySettings>
<UseProxy vt="8">-1</UseProxy>
<ProxyName vt="8">sdfsd</ProxyName>
<ProxyPort vt="3">80</ProxyPort>
<ProxyUsername vt="8">Somename</ProxyUsername>
<ProxyPassword vt="8">Somepassword</ProxyPassword>
<AuthenticationScheme vt="8">Basic</AuthenticationScheme>
<Username vt="8">Somename</Username>
<Password vt="8">Somepassword</Password>
<EnableChunkedEncoding vt="11">1</EnableChunkedEncoding>
<Certificate vt="8">AAAA BBBB CCCC DDDD</Certificate>
<UseSSO vt="11">0</UseSSO>
<AffiliateApplicationName vt="8">Name</AffiliateApplicationName>
</CustomProps>
使用 BizTalk Server 管理控制台設定 HTTP 傳送埠
您可以在 BizTalk Server 管理控制台中設定 HTTP 傳送埠配接器變數。 如果未設定傳送埠的屬性,則會使用 BizTalk Server 管理控制台中設定的預設傳送處理程式值。
備註
本主題中所述的組態屬性適用於單向和要求回應 HTTP 傳送埠。
在 BizTalk Server 管理控制台中,建立新的傳送埠,或按兩下現有的傳送埠加以修改。 如需詳細資訊 ,請參閱如何建立傳送埠 。 設定所有傳送埠選項,並在 [一般] 索引標籤的 [傳輸] 區段中指定 [類型] 選項的 HTTP。
在 [一般] 索引標籤的 [傳輸] 區段中,按兩下 [類型] 旁的 [設定] 按鈕。
在 [ HTTP 傳輸屬性 ] 對話框的 [ 一般 ] 索引標籤上,執行下列動作:
使用此 若要這樣做 目的地 URL 必須的。 指定要傳送 HTTP 要求的位址。 包含附加至基底 URL 的查詢字串。
類型: 字串
最大長度:256
如需詳細資訊,請參閱 目的地 URL 屬性的限制。 注意: 傳送埠或接收位置的 URI 不能超過 256 個字元。啟用區塊化編碼 指定使用區塊化編碼。 如果啟用此選項,HTTP 配接器將會使用最大區塊大小為 8 KB 的 HTTP 區塊編碼。 如果 HTTP 傳送處理程式設定為 使用 Proxy,則會隱含停用區塊化編碼。
類型: 布爾
預設值: 真要求逾時 (秒) 指定 HTTP/HTTPS 傳輸的逾時時間以秒為單位。 如果 HTTP 配接器在此時間內未收到回應,服務會記錄錯誤,並根據重試基礎結構重新提交訊息。
如果設定為零 (0),BizTalk 傳訊引擎會根據要求訊息大小計算逾時。 如果您沒有提供值,則會使用處理程式的值。
類型: 長
最小值: 0
最大值: MAX_LONG重新導向上限 指定所傳送訊息允許的最大重新導向。
默認值: 5
類型: Int
最小值: 0
最大值: 10內容類型 指定要求訊息的內容類型。
如果未設定此值,則會使用處理程式的值。
類型: 字串
最小長度: 0
最大長度:256在 [HTTP 傳輸屬性] 對話框的 [Proxy(處理程式覆寫)] 索引標籤上,執行下列動作:
使用此 若要這樣做 使用處理程序的預設 Proxy 組態 指定傳送埠組態必須使用為 HTTP 傳送處理程式指定的 Proxy 設定。
這是預設設定。不使用 Proxy 指定 HTTP 傳送處理程式是否使用 Proxy 伺服器。
如果選取,此傳送埠的 HTTP 傳送處理程式不會使用 Proxy 伺服器。使用 Proxy 指定 HTTP 傳送處理程式是否使用 Proxy 伺服器。
如果選取,HTTP 傳送處理程式會使用 Proxy 伺服器。伺服器 指定此傳送埠的 Proxy 伺服器位址。
如果已選取 [使用 Proxy ],則此屬性只需要值。
類型: 字串
最小長度: 0
最大長度:256通訊埠 指定此傳送埠的 Proxy 伺服器埠。
如果已選取 [使用 Proxy ],則此屬性只需要值。
默認值: 80
類型: 長
最小值: 0
最大值: 65535使用者名稱 指定使用者名稱以向 Proxy 伺服器進行驗證。
如果已選取 [使用 Proxy ],則此屬性只需要值。
類型: 字串
最小長度: 0
最大長度:256密碼 指定用戶密碼以向 Proxy 伺服器進行驗證。
如果已選取 [使用 Proxy ],則此屬性只需要值。
類型: 字串
最小長度: 0
最大長度:256在 [ HTTP 傳輸屬性 ] 對話框的 [ 驗證 ] 索引標籤上,執行下列動作:
使用此 若要這樣做 驗證類型 指定要與目的地伺服器搭配使用的驗證類型。
有效的 選項如下:
- 匿名
- 基本
- 摘要
- Kerberos
預設值: 匿名認證 指定要使用的認證類型。
只有在 驗證類型 是 基本 或 摘要時,才可使用。
有效的 選項如下:
- 請勿使用單一登錄
使用者名稱:
要用於向目的地伺服器進行驗證的用戶名稱。 如果 [驗證類型] 屬性為 Anonymous 或 Kerberos,則會停用此選項。 如果已選取 [基本 ] 或 [ 摘要 ],且未使用 Enterprise Single Sign-On,則此屬性需要值。
最小長度: 0
最大長度:256
密碼:
要用於向目的地伺服器進行驗證的密碼。 如果 [驗證類型] 屬性為 Anonymous 或 Kerberos,則會停用此選項。 如果已選取 [基本 ] 或 [ 摘要 ],則此屬性需要值,且不使用 Single Sign-On。
最小長度: 0
最大長度:256
- 使用單一登錄
指定是否要使用單一 Sign-On 來擷取客戶端認證,以向目的地伺服器進行驗證。
分支機構應用程式
指定要用於單一登錄的分支機構應用程式。
選擇您要包含在單一登錄中的應用程式。
最小長度: 0
最大長度:256SSL 用戶端憑證指紋 指定客戶端憑證的指紋,以用來建立安全套接字層 (SSL) 連線。
最小長度: 0
最大長度: 59再次按下 [確定 ] 和 [ 確定 ] 以儲存設定。