整合式 BizTalk 配接器的組態屬性

發行項
07/21/2023

BizTalk Explorer 物件模型會公開 IReceiveLocation.CustomData 和 ISendPort.CustomData 屬性，這些屬性會以名稱/值組 XML 字串的形式包含配接器組態屬性包。這個名稱/值組 XML 字串會儲存在 < 系結檔之 TransportTypeData > 元素內的 < CustomProps > 元素中。 CustomProps > 元素中的 < 大部分資訊都會對應至可在 bizTalk 管理主控台或 BizTalk Explorer () 等BizTalk Server使用者介面中為配接器設定的資訊。如果這些值存在於繫結檔案中，當匯入繫結檔案時，它們便會套用至指定之接收位置和傳送埠的配接器組態。所有配接器的組態資訊都會儲存在「單一登入」資料庫中。

本節描述可為每個整合式 BizTalk 配接器設定的組態屬性。

注意

系結檔案之 < TransportTypeData > 元素中儲存的密碼資訊會遮罩，以便不會以純文字儲存敏感性資料。取決於傳輸方式，密碼資訊若非以 NULL 取代，就會以星號取代。將繫結檔案匯入到目標 BizTalk Server 組態之前，您必須以手動方式將此資訊輸入繫結檔案以更新配接器組態。

使用 Adapter Framework 建置之配接器的組態資料會儲存在 AdapterConfig > 元素中 < 。 <由於 AdapterConfig > 元素指定 VT_BSTR (vt=「8」) 資料類型，因此當您嘗試匯入系結檔案時， < > 必須逸出此元素中包含的字元，否則會發生錯誤。這樣會使組態資料的文字，比沒有逸出字元時更加難以閱讀。下列範例說明從繫結至 POP3 配接器之傳送埠的範例組態資料，逸出這些字元的效果。

TransportTypeData 組態資料，不會逸出 <> AdapterConfig > 元素中使用的 < 字元

此設定資料無效， < 因為 AdapterConfig > 元素會指定VT_BSTR (vt=「8」) 資料類型 >< ，而且不會逸出 AdapterConfig > 元素中包含的 < 字元：

<TransportTypeData>  
<CustomProps>  
<AdapterConfig vt="8">  
<Config xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
<mailServer>test.microsoft.com</mailServer>  
<serverPort>0</serverPort>  
<userName>testuser</userName>  
<password>******</password>  
<authenticationScheme>Basic</authenticationScheme>  
<sslRequired>false</sslRequired>  
<applyMIME>true</applyMIME>  
<bodyPartContentType>text/xml</bodyPartContentType>  
<bodyPartIndex>1</bodyPartIndex>  
<errorThreshold>10</errorThreshold>  
<pollingInterval>5</pollingInterval>  
<pollingUnitOfMeasure>Minutes</pollingUnitOfMeasure>   
<uri>POP3://test.microsoft.com#testuser</uri>  
</Config>  
</AdapterConfig>  
</CustomProps>  
</TransportTypeData>

TransportTypeData 組態資料，其會逸出 <> AdapterConfig > 元素中使用的 < 字元

<由於 AdapterConfig > 元素指定 VT_BSTR (vt=「8」) 資料類型，因此必須從 < AdapterConfig > 元素逸出字元， <> 如下所示：

<TransportTypeData>  
<CustomProps>  
<AdapterConfig vt="8">  
<Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
xmlns:xsd="http://www.w3.org/2001/XMLSchema"><mailServer>test  
microsoft.com</mailServer><serverPort>0</serverPort>&  
lt;userName>testuser</userName><password>******</pass  
word><authenticationScheme>Basic</authenticationScheme>&  
lt;sslRequired>false</sslRequired><applyMIME>true</ap  
plyMIME><bodyPartContentType>text/xml</bodyPartContentType&  
gt;<bodyPartIndex>1</bodyPartIndex><errorThreshold>10  
</errorThreshold><pollingInterval>5</pollingInterval>  
<pollingUnitOfMeasure>Minutes</pollingUnitOfMeasure><uri  
>POP3://test.microsoft.com#testuser</uri></Config>  
</AdapterConfig>  
</CustomProps>  
</TransportTypeData>

以「配接器架構」建立的整合式配接器包括下列各項：