配置集成的 BizTalk 适配器的属性

项目
10/14/2023

BizTalk 资源管理器对象模型以名称/值对 XML 字符串的形式公开包含适配器配置属性包的 IReceiveLocation.CustomData 和 ISendPort.CustomData 属性。此名称/值对 XML 字符串存储在<绑定文件中 TransportTypeData> 元素中的 <CustomProps> 元素中。 CustomProps> 元素中的<大多数信息对应于可以在 BizTalk Server 用户界面 (（例如 BizTalk 管理控制台或 BizTalk 资源管理器) ）中为适配器设置的信息。如果在某一绑定文件中提供这些值，则这些值将在导入该绑定文件时应用于指定的接收位置和发送端口的适配器配置。所有适配器的配置信息都存储于单一登录数据库中。

本部分说明可为每个集成的 BizTalk 适配器设置的配置属性。

注意

将屏蔽存储在绑定文件的 TransportTypeData> 元素中的<密码信息，以便敏感数据不会以明文形式保存。根据传输，密码信息或者由 NULL 代替，或者由星号代替。您必须手动在绑定文件中输入此信息，以便在将绑定文件导入到目标 BizTalk Server 配置前更新适配器配置。

使用 Adapter Framework 生成的适配器的配置数据存储在 AdapterConfig> 元素中<。 <由于 AdapterConfig> 元素指定VT_BSTR (vt=“8”) 数据类型，< >因此必须在尝试导入绑定文件时转义此元素中包含的字符，否则会发生错误。这会导致配置数据文本在可读性上比对这些字符进行转义前要低。下面的示例阐释对这些字符（它们来自绑定到 POP3 适配器的发送端口的示例配置数据）进行转义的影响。

不转义 AdapterConfig> 元素中使用的<字符的 <> TransportTypeData 配置数据

此配置数据无效，<因为 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>

转义 AdapterConfig> 元素中使用的<字符的 <> TransportTypeData 配置数据

<由于 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>

以下是使用适配器框架已创建的集成的适配器：