SOAP 请求

UiPath.Web.Activities.Design.SoapClientWithBodyFactory

描述

用于对使用 SOAP 协议的指定网页 API 执行 HTTP 请求。首次将此活动拖动至“设计器”面板时，系统会显示“SOAP 请求向导”窗口。该向导提供了创建请求及预览服务器响应的便捷方法。关闭向导后，便无法重新打开。

此窗口中显示的所有字段也可在“属性”面板中找到。因此，您仍可在关闭向导后编辑首选项。

项目兼容性

Windows - 旧版

备注：

SOAP 请求仅受 Windows - 旧版项目支持。如果必须在 Windows 或跨平台项目中执行 SOAP 请求，请尝试以下解决方案：

• 对整个流程使用 Windows 旧版。

• 仅对 SOAP 请求部分使用 Windows 旧版流程，并通过输入/输出参数从 Windows 流程调用它

• 使用“调用代码”活动。

• 使用编码工作流（从 Studio 2023.10 开始可用）。

• 使用“HTTP 请求”活动创建您自己与 SOAP 定义匹配的请求。确保使用正确的标头，并在请求正文中包含正确的 XML。

SOAP 请求向导

• “服务说明 ” - WSDL 架构位置。
• 省略号 - 用于浏览硬盘以获取 .wsdl 文件。
• 获取 - 从提供的 .wsdl 文件中获取信息，并在表中显示可用参数。
• 合同- 此为用于描述 SOAP 服务所公开方法的合同名称。
• 方法 - 所有受支持方法的列表。更改方法也会更改表中显示的参数。

参数表

• 名称- 所有受支持参数的名称。
• 类型- 每个受支持参数的类型。在某些情况下，将鼠标悬停在类型上方会显示更多信息，例如参数是否可选。
• 值- 用于为每个参数分别添加值，以便发出所需请求。

• 身份验证 - 此为下拉列表，用于从中选择网页服务所用的验证类型。提供以下选项：

  • 无- 默认选项。指明网页服务不使用任何类型的授权。
  • 简单- 指明服务使用简单身份验证。如果选中此方法，系统会显示用户名和密码字段，以便您输入凭据。
  • Windows- 指明服务使用 Windows 身份验证。
  • 客户端证书- 指明服务使用客户端证书进行授权。选中后，系统会显示客户端证书字段，以便您浏览本地驱动器以获取证书。
• 调用- 用于根据指定选项执行请求。
• 响应- 显示网页服务器响应的预览。

属性

客户端证书身份验证

• 客户端证书- 指明服务使用客户端证书进行授权，且可用于浏览本地驱动器以获取证书。
• “客户端证书 密码” - 客户端证书的密码。 此字段支持 String 变量。
• SecureClientCertificatePassword - 客户端证书的密码，采用 Secure String 变量的形式。

常见

• “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。

  注意：如果 Try Catch 异常处理中包含该活动且出错时继续属性的值为 True，则系统在执行项目时不会捕获任何错误。
• “显示名称”- 活动的显示名称。

输入

• 合同名称- 此为用于描述 SOAP 服务所公开方法的合同名称。该属性支持字符串或字符串变量。
• 端点- WSDL 架构位置。系统会默认提供http://www.webservicex.com/globalweather.asmx?wsdlURL，以供测试所用。该属性支持字符串和字符串变量，并且对应于SOAP 请求向导窗口中的服务描述字段。
• 方法- 客户端调用的方法名称。
• 参数 - 此为指定方法的参数。单击省略号按钮，打开“参数”窗口，以便在其中添加所需参数。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

输出

• 标头- 从 SOAP 请求接收到的响应。
• 结果- 以String变量呈现的网页服务器响应。

简单身份验证

• 用户名- 指明网页服务使用简单身份验证，并且允许输入用户名。您还需添加密码。该属性支持字符串或字符串变量。
• 密码- 指明网页服务使用简单身份验证，并且允许输入密码。您还需添加用户名。该属性支持Strings和String变量。
• 安全密码- 指明网页服务使用安全身份验证，并且允许输入安全字符串密码。您还需添加用户名。此属性支持 Secure String 数组变量。

Windows 身份验证

• 使用 Windows 凭据- 选中后，此复选框便会指明 Windows 凭据应与指定的网页服务配合使用。