如何配置 HTTP 接收位置

2025-06-05

可以通过编程方式或使用 BizTalk Server 管理控制台设置 HTTP 接收位置适配器变量。如果未在接收位置设置属性，将使用 BizTalk Server 管理控制台中设置的默认接收处理程序值。

注释

在完成以下过程之前，必须已添加接收端口。有关详细信息，请参阅如何创建接收端口。

如何以编程方式配置 HTTP 接收位置

HTTP 适配器将其配置信息存储在 BizTalk 管理数据库中（也称为配置数据库）。配置存储在自定义 XML 属性包中。

BizTalk Explorer 对象模型公开 IReceiveLocation 配置接口，该接口具有 TransportTypeData 读/写属性。此属性接受以名称-值对形式的 XML 字符串中包含的 HTTP 接收位置配置属性包。

不需要设置 IReceiveLocation 的 TransportTypeData 属性。如果未设置，则使用 HTTP 接收位置配置的默认值。下表列出了默认值，还列出了可在 BizTalk 资源管理器对象模型中为 HTTP 接收位置设置的配置属性。

属性名称	类型	DESCRIPTION	限制	注释
响应内容类型	字符串	HTTP 适配器从此接收位置发回客户端的 HTTP 响应消息的内容类型。此属性仅对请求响应接收端口有效，对于单向接收端口，将忽略此属性。	字符串最小长度： 0 最大长度：256	默认值：文本/XML
LoopBack	布尔型	指定在此位置上收到的请求消息将被路由到发送端口，或者回到接收位置以作为响应发送。此属性仅适用于请求-响应接收端口。对于单向接收端口，将忽略它。	没有	默认值：假
ReturnCorrelationHandle	布尔型	指定如果提交成功，HTTP 适配器在 HTTP 响应中向客户端发送的提交消息的关联令牌。此属性仅对单向接收端口有效，对于请求响应接收端口，将忽略此属性。	没有	默认值：真
暂停失败的请求	布尔型	指定是否挂起失败的 HTTP 请求。 True 值表示挂起已失败的请求，并： 1. 对于单向接收端口，发送“已接受”状态代码（202）到客户端。 2. 对于双向接收端口，发送“错误”状态代码（500）到客户端。	没有	默认值：假
UseSSO	布尔型	指定 HTTP 适配器是否会向到达此接收位置的消息颁发 SSO 票证。	没有	默认值：假

要设置这些属性的 XML 字符串的格式如下所示：

<CustomProps>  
   <UseSSO vt="11">-1</UseSSO>  
   <SuspendFailedRequests vt="11">-1</SuspendFailedRequests>  
   <ReturnCorrelationHandle vt="11">-1</ReturnCorrelationHandle>  
   <ResponseContentType vt="8">text/xml</ResponseContentType>  
   <LoopBack vt="11">-1</LoopBack>  
</CustomProps>

如何使用 BizTalk Server 管理控制台配置 HTTP 接收位置

若要使用 BizTalk Server 管理控制台配置接收位置，请使用以下过程。

为 HTTP 接收位置配置变量

将 Internet Information Services （IIS）配置为使用 HTTP 接收位置。有关配置 IIS 的说明，请参阅如何为 HTTP 接收位置配置 IIS。
在 BizTalk Server 管理控制台中，展开 BizTalk Server管理、 BizTalk 组、 应用程序，然后展开要在其中创建接收位置的应用程序。
在左窗格中，单击 “接收端口 ”节点。然后在右窗格中，右键单击与现有接收位置关联的接收端口或要与新接收位置关联的接收端口，然后单击“ 属性”。
在 “接收端口属性 ”对话框的左窗格中，选择“ 接收位置”，然后在右窗格中双击现有接收位置，或单击“ 新建 ”创建新的接收位置。
在“接收位置属性”对话框中，在“类型”旁边的“传输”部分中，从下拉列表中选择 HTTP，然后单击“配置”。

在 “HTTP 传输属性 ”对话框中，执行以下作：

用这个	要执行的操作
虚拟目录和 ISAPI 扩展	指定发布 HTTP/HTTPS 接收位置接收的消息的虚拟目录的名称。虚拟目录包括接收位置 DLL 的名称和可选的查询字符串。虚拟目录名称的示例包括： /<virtual directory>/BTSHTTPReceive.dll /<virtual directory>/BTSHTTPReceive.dll？购买%20Order 此位置不得包含多个 BTSHTTPReceive.dll ISAPI 扩展，包括所有子文件夹。类型：字符串最大长度： 256 注意：发送端口或接收位置的 URI 不能超过 256 个字符。
公共地址	指定此接收位置的完全限定 URI。此属性的值是服务器名称和虚拟目录的组合。 BizTalk 消息引擎向外部合作伙伴公开此地址。指定的 URI 应指定贸易合作伙伴在向 BizTalk Server 发送消息时要连接到的公共网站 URL。此信息是可选的，并且不受 BizTalk Server 使用。此参数可用于允许管理员记录接收位置绑定到的公共 URL。类型：字符串最小长度： 0 最大长度：256
返回内容类型	指定接收位置发回客户端的 HTTP 响应消息的内容类型。此属性仅适用于请求-响应接收位置。默认值： text/xml 类型：字符串最小长度： 0 最大长度：256
环回	定义在该位置接收到的请求消息，将被路由到发送端口，或被路由回到此接收位置以作为响应发送。此属性仅适用于请求-响应接收位置。默认值：假类型：布尔
成功时返回关联句柄（仅限单向端口）	如果定义成功，接收端将提交消息的相关令牌通过 HTTP 响应发送给客户端。此属性仅适用于单向接收位置。默认值：真类型：布尔
使用单一登录	指示使用企业单体编号 Sign-On。默认值：假类型：布尔值注意：如果启用此选项，则还必须在 SSO 系统级别启用“允许票证”选项。 “允许票证”选项可以在SSO 管理 MMC 界面中的SSO 系统属性对话框的选项选项卡上进行配置。如果启用此选项，并且 SSO 系统级别的“允许票证”选项未启用，则此接收位置接收的任何消息都将暂停。
挂起失败的请求	指示是否暂停入站处理失败的 HTTP 请求。 False 值指示放弃失败的请求，并将错误状态代码（401 或 500）发送到客户端。值为 True 表示应挂起失败的请求，并将“接受”状态代码（200）发送到单向接收端口的客户端，或将“错误”状态代码（500）发送到双向接收端口的客户端。默认值：假类型：布尔

单击“确定”以保存设置。
在 “接收位置属性 ”对话框中输入相应的值，以完成接收位置的配置，然后单击“ 确定 ”保存设置。有关 “接收位置属性 ”对话框的信息，请参阅 “如何创建接收位置”。

当 HTTP 客户端调用 HTTP 位置时，HTTP 适配器使用匿名、基本、摘要或 Windows 集成身份验证对 HTTP 客户端进行身份验证。如果用户已验证，则用户上下文将传递给接收处理程序。

注释

导致 SOAP 和 HTTP 共享同一进程的任何 IIS 配置都无效。每个进程只能有一个隔离接收器。

通过

如何配置 HTTP 接收位置

为 HTTP 接收位置配置变量

反馈

其他资源