适配器注册文件
成功生成自定义适配器代码后,必须将其注册到 BizTalk Server。 可通过使用适当的适配器设置更新注册表来完成此步骤。 你可以手动编写注册表文件,但由于需要输入的信息要求精确且比较复杂,这样做容易出错。 一个更好的办法是运行适配器注册向导。 适配器注册向导提供的所有选项与从头创建注册表文件时提供的完全一样,能降低文件中出错的可能性。 有关适配器注册表向导的详细信息,请参阅 适配器注册表向导。
StaticAdapterManagement.reg 文件和 DynamicAdapterManagement.reg 文件位于 <drive>:\Program Files\Microsoft BizTalk Server\SDK\Samples\AdaptersDevelopment\File Adapter。 (运行其中一个文件时,可以双击它或右键单击它并选择“ 合并) ”,它会向注册表注册示例文件适配器,并将程序集安装到全局程序集缓存中。 若要注册自定义适配器,最好的方法是使用适配器注册向导创建一个新的注册表文件。 如果自定义静态适配器类似于示例适配器,并且你决定修改现有的注册表文件,请在 StaticAdapterManagement.reg 文件中打开并修改以下属性:
约束
InboundTypeName
InboundAssemblyPath
OutboundTypeName
OutboundAssemblyPath
AdapterMgmtTypeName
AdapterMgmtAssemblyPath
PropertyNameSpace
注意
对于 OutboundAssemblyPath 和 AdapterMgmtAssemblyPath ,建议不要在属性值中包含本地路径,因为安装在不同的服务器位置时,配置可能会中断。 一个更好的选择是,使用强名称,并在全局程序集缓存中安装它。
你可以通过两种方式指定实现适配器接收器、适配器发送器和适配器管理的 .NET 类型:
将适配器安装到一个文件夹,并指定 *TypeName 和 *AssemblyPath,其中,*TypeName 是类的 type.FullName,*AssemblyPath 是程序集的路径和文件名。
将适配器安装在全局程序集缓存中,仅指定 *TypeName,*TypeName 是类的 type.AssemblyQualifiedName。 这是建议选项。
所有适配器必须包括具有指定 GUID 的注册表项:
Implemented Categories\{7F46FC3E-3C2C-405B-A47F-8D17942BA8F9}
"InboundProtocol_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A281}"
"OutboundProtocol_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A283}"
"ReceiveLocation_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A280}"
"TransmitLocation_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A282}"
基于适配器框架的适配器必须将这些特定的 GUID 用于发送和接收处理程序以及位置属性页。 请注意,如果适配器是仅限发送的适配器,它只需要 OutboundProtocol_PageProv和 TransmitLocation_PageProvGUID。 同样,仅接收适配器只需要 InboundProtocol_PageProv 和 ReceiveLocation_PageProv GUID。
以下代码来自 StaticAdapterManagement.reg 文件,DynamicAdapterManagement.reg 文件的代码几乎完全一样。 有关每个注册表属性的详细信息,请参阅 注册适配器。 对注册表文件进行更改后,保存该文件,然后运行它。
Windows Registry Editor Version 5.00
[HKEY_CLASSES_ROOT\CLSID\{62018D08-281A-415b-A6D3-6172E3762867}]
@="Static DotNetFile Adapter"
"AppID"="{12A6EBAA-CF68-4B58-B36E-A5A19B22C04E}"
[HKEY_CLASSES_ROOT\CLSID\{62018D08-281A-415b-A6D3-6172E3762867}\BizTalk]
@="BizTalk"
"TransportType"="Static DotNetFile"
"Constraints"=dword:00003C0b
"InboundProtocol_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A281}"
"OutboundProtocol_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A283}"
"ReceiveLocation_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A280}"
"TransmitLocation_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A282}"
"InboundEngineCLSID"="{3D4B599E-2202-4bbb-9FC6-7ACA3906E5DE}"
"InboundTypeName"="Microsoft.BizTalk.SDKSamples.Adapters.DotNetFileReceiver""InboundAssemblyPath"="C:\\Program Files\\Microsoft BizTalk Server <version>\\SDK\\Samples\\AdaptersDevelopment\\File Adapter\\Runtime\\bin\\Debug\\Microsoft.BizTalk.SDKSamples.Adapters.DotNetFile.Runtime.dll"
"OutboundEngineCLSID"="{024DB758-AAF9-415e-A121-4AC245DD49EC}"
"OutboundTypeName"="Microsoft.BizTalk.SDKSamples.Adapters.DotNetFileTransmitter""OutboundAssemblyPath"="C:\\Program Files\\Microsoft BizTalk Server <version>\SDK\\Samples\\AdaptersDevelopment\\File Adapter\\Runtime\\bin\\Debug\\Microsoft.BizTalk.SDKSamples.Adapters.DotNetFile.Runtime.dll""AdapterMgmtTypeName"="Microsoft.BizTalk.SDKSamples.Adapters.Designtime.StaticAdapterManagement""AdapterMgmtAssemblyPath"="C:\\Program Files\\Microsoft BizTalk Server <version>\SDK\\Samples\\AdaptersDevelopment\\File Adapter\\Design Time\\Adapter Management\\bin\\Debug\\Microsoft.BizTalk.SDKSamples.Adapters.DotNetFile.Designtime.dll""PropertyNameSpace"="http://schemas.microsoft.com/BizTalk/2003/SDK_Samples/Messaging/Transports/dotnetfile-properties"
"AliasesXML"="<AdapterAliasList><AdapterAlias>DotNetFILE://</AdapterAlias></AdapterAliasList>"
"ReceiveHandlerPropertiesXML"="<CustomProps><AdapterConfig vt=\"8\"/></CustomProps>"
"SendHandlerPropertiesXML"="<CustomProps><AdapterConfig vt=\"8\"/></CustomProps>"
"ReceiveLocationPropertiesXML"="<CustomProps><AdapterConfig vt=\"8\"/></CustomProps>"
"SendLocationPropertiesXML"="<CustomProps><AdapterConfig vt=\"8\"/></CustomProps>"
[HKEY_CLASSES_ROOT\CLSID\{62018D08-281A-415b-A6D3-6172E3762867}\Implemented Categories]
[HKEY_CLASSES_ROOT\CLSID\{62018D08-281A-415b-A6D3-6172E3762867}\Implemented Categories\{7F46FC3E-3C2C-405B-A47F-8D17942BA8F9}]
注册静态示例适配器
使用以下过程运行 SDK 中的文件适配器。 有关详细信息,请参阅文件适配器 (BizTalk Server 示例) 。
单击“ 开始”,指向 “所有程序”,指向“ 附件”,然后单击“ Windows 资源管理器”。
导航到BizTalk Server的安装驱动器,然后导航到<
drive
>:\Program Files\MicrosoftBizTalk Server\SDK\Samples\AdaptersUsage\File Adapter。若要将示例适配器添加到注册表,请双击 StaticAdapterManagement.reg。 (如果要将动态文件适配器添加到注册表,请改为运行 DynamicAdapterManagement.reg ,并在其他位置根据需要使用该文件。)
注意
如果计算机的驱动器 C 上未安装 BizTalk Server,则必须使用适当的安装路径修改 StaticAdapterManagement.reg 文件。 在文件中搜索 C: 并将其替换为正确的安装驱动器。
在“ 注册表编辑器 ”对话框中,单击“ 是 ”将示例适配器添加到注册表,然后单击“ 确定 ”关闭对话框,验证是否已将信息添加到注册表中。
若要关闭 Windows 资源管理器,请在“ 文件 ”菜单上单击“ 关闭”。
示例静态适配器现已注册到 BizTalk Server。
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈