使用 BizTalk Web 服务发布向导将架构发布为 Web 服务。
将架构发布为 Web 服务
在 “程序”中,选择 “BizTalk Server”,然后选择 “BizTalk Web 服务发布向导”。
重要
在运行 BizTalk Web 服务发布向导之前,必须生成 BizTalk 项目。
在“欢迎”页面上,单击“下一步”。
在“ 创建 Web 服务 ”页上,选择“ 发布架构”作为 Web 服务 ,然后单击“ 下一步”。
在 “Web 服务 ”页上,定义要发布的 Web 服务。 使用 Web 服务说明 对话框中的树添加、删除、重命名和编辑 Web 服务说明节点。 “ 信息 ”对话框提供有关所选节点的信息,并在当前节点或任何子节点中显示任何错误:
树的根节点(Web 服务说明)描述 Web 服务项目名称。 虚拟目录名称使用根节点作为默认名称。 可以通过选择 “重命名 Web 服务说明”来修改 Web 服务说明。
若要添加新的 Web 服务,请右键单击 Web 服务说明 节点,然后单击“ 添加 Web 服务”。 这会创建新的 Web 服务,而无需任何 Web 方法。 若要修改 Web 服务的名称,请右键单击 Web 服务节点,然后选择“ 重命名 Web 服务”,然后按 Enter 接受新名称。
若要添加新的 Web 方法,请右键单击 Web 服务节点,指向 “添加 Web 方法”,然后单击快捷菜单中的 “单向 ”(请求 Web 方法)或 请求响应 (对于请求响应 Web 方法)。
若要设置请求和响应架构类型,请右键单击 “请求 ”或“ 响应 ”节点,然后单击“ 选择架构类型”。 在“ 请求消息类型 ”对话框中,在 BizTalk 程序集文件 文本框中键入包含文档架构的程序集的名称,或单击“ 浏览 ”以搜索程序集。 可用架构类型列表视图显示架构的每个根元素。 选择要添加为请求或响应架构类型的根节点。
注释
如果将 BizTalk 程序集文件安装到全局程序集缓存 (GAC),请确保 GAC 中的程序集已使用将在 “请求消息类型 ”对话框中选择的程序集进行更新。 如果 GAC 具有相同的完全限定名称,BizTalk Web 服务发布向导将使用 GAC 中的程序集文件,而不是所选程序集文件。
可以重命名 请求 和 响应 节点,而不会影响生成的代码。 定义架构后,可以重命名部件元素,以修改 Web 方法参数名称。 可以通过查看生成的 Web 服务代码来查看更改。
注释
重命名任何 Web 服务说明节点时,不能使用空格。
单击“下一步”以继续向导。
在 “Web 服务属性 ”页上的 “Web 服务目标命名空间 ”对话框中,键入 Web 服务的目标命名空间,然后选择相应的框以指定向导如何处理 SOAP 标头和对 Web 服务的单个 Sign-On 支持。 若要进一步自定义 Web 服务实现,请单击“ 高级 ”按钮。 它将显示更多可用选项:
选项 价值 DESCRIPTION SOAP 参数样式 违约 此选项指定如何在 SOAP 消息中设置参数的格式。 有关详细信息,请参阅 SoapParameterStyle 枚举。https://go.microsoft.com/fwlink/?LinkId=62259 SOAP 参数样式 裸 此选项指定如何在 SOAP 消息中设置参数的格式。 有关详细信息,请参阅 SoapParameterStyle 枚举类型。https://go.microsoft.com/fwlink/?LinkId=62259 SOAP 参数样式 包裹的 此选项指定如何在 SOAP 消息中设置参数的格式。 有关详细信息,请参阅 SoapParameterStyle 枚举。https://go.microsoft.com/fwlink/?LinkId=62259 一致性声明 没有 此选项指定绑定声明符合的 Web 服务互作性(WSI)规范。 有关详细信息,请参阅 WebServiceBindingAttribute.ConformsTo 属性。https://go.microsoft.com/fwlink/?LinkId=193064 一致性声明 WS-I 基本概况 1.1 此选项指定绑定声明符合的 Web 服务互作性(WSI)规范。 有关详细信息,请参阅 WebServiceBindingAttribute.ConformsTo 属性。https://go.microsoft.com/fwlink/?LinkId=193064 强制的请求响应 [默认值] 此选项指定是否应将单向 BizTalk 操作以请求-响应 Web 方法的形式公开。 默认情况下,不强制执行单向标志。 注释
选择任何 SOAP 标头选项将全局应用于运行向导实例时创建的所有 Web 服务和 Web 方法。
在 “Web 服务属性 ”页上,单击“ 下一步”。
如果选择 了“添加其他 SOAP 标头”,将显示 “请求 SOAP 标头 ”和 “响应 SOAP 标头” 页。 可以使用以下对话框中的 “添加 ”和 “删除 ”按钮添加和删除请求和响应 SOAP 标头:
若要添加 SOAP 标头,请单击“ 添加”。 在 BizTalk 程序集名称(*.dll) 文本框中,键入程序集名称或浏览 BizTalk 程序集文件 文本框中包含 SOAP 标头架构的程序集。 可用架构类型列表视图显示架构的每个根元素。 选择要添加为请求或响应 SOAP 标头的根节点。 若要选择多个项,请按住 Ctrl 键并单击“ 确定”。
若要从列表中删除 SOAP 标头,请从添加的 SOAP 标头列表中选择它,然后单击“ 删除”。
在每个 SOAP 标头页上单击“ 下一步 ”以继续向导。
注释
目标命名空间和根元素名称定义 SOAP 标头。
注释
如果将目标命名空间/根元素名称的相同组合添加为请求和响应 SOAP 标头,则不会将其视为 in/out 标头。 必须将传入标头手动复制到编排内的传出标头。
注释
目标命名空间/根元素名称的相同组合只能分别添加一次:一次作为请求 SOAP 标头,一次作为响应 SOAP 标头。
在 “Web 服务项目” 页上的 “项目位置 ”文本框中,键入项目位置。 可以接受默认位置(
http://localhost/your_project_name
)、键入项目的位置,或单击“ 浏览 ”并选择 Web 目录。 选择以下任一选项:覆盖现有项目。 仅当项目位置已存在时,此选项才可用。 选择此选项后,您只能发布到同一位置。 否则,必须输入其他项目位置。
允许匿名访问 Web 服务。 此选项将匿名访问添加到创建的虚拟目录。 默认情况下,虚拟目录从其父虚拟目录或网站继承访问权限(如果它是顶级虚拟目录)。
创建 BizTalk 接收位置。 此选项会自动创建 SOAP 适配器接收与每个生成的 .asmx 文件对应的端口和位置。 如果已存在另一个接收位置,则不会替换接收位置。 使用格式“/<虚拟目录名称>/<编排namespace_typename_portname>.asmx”解析 SOAP 适配器的接收位置。 选择此选项后,选择将生成接收端口和位置的应用程序。
注释
项目位置可以存在于其他服务器上。 若要将 Web 服务发布到其他服务器,请键入项目名称。
http://<servername>/<project_name>
注释
项目位置可以存在于非默认网站上。 发布到非默认网站时,请在 URL 中包含网站的端口号:
http://localhost:8080/<project_name>
注释
使用向导创建接收位置时,向导将使用许多默认值创建接收位置。 接收和发送管道的默认值 为 Microsoft.BizTalk.DefaultPipelines.PassThruReceive 和 Microsoft.BizTalk.DefaultPipelines.PassThruTransmit。 如果通过发布的 Web 服务接收的消息需要任何特殊的管道处理(例如验证、关联或入站/出站映射),则应将发送和接收管道设置为 Microsoft.BizTalk.DefaultPipelines.XMLReceive、 Microsoft.BizTalk.DefaultPipelines.XMLSend 或自定义管道。
单击“ 下一步 ”查看 ASP.NET Web 服务项目的设置。
单击“ 创建 ”以创建 ASP.NET Web 服务。
单击“ 完成 ”以完成 BizTalk Web 服务发布向导。