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