使用 SOAP Web 服务 操作 传递两个数值,并从在线计算器应用程序中返回总和。

过程

要调用 SOAP Web 服务,请执行以下步骤:

  1. 双击或拖动 SOAP Web 服务操作。
  2. 选择连接方法:
    • 要使用 URI 进行连接,请输入 URI,例如 http://www.dneonline.com/calculator.asmx?WSDL
    • 要使用文件连接,请从 Control Room 或 Desktop 选择一个文件,或插入变量。
  3. 可选: 地址位置字段中输入 SOAP 端点。
    如果您指定地址位置,则 机器人 在执行期间使用该位置;否则,机器人 使用来自 WSDL 文件的地址位置。
    注: 如果您手动创建 SOAP URI 并且不使用构建 SOAP 请求选项,请前往步骤 6
  4. 单击构建 SOAP 请求
    SOAP 请求窗口出现,显示服务和端口,以及有关其操作和参数的详细信息。
  5. SOAP 请求窗口中,展开要查看其端口列表的服务。 单击所需端口以显示可用操作列表。 选择所需的操作并单击应用以从 SOAP 请求中检索操作详细信息。
    如果您使用构建 SOAP 请求选项,服务端口操作操作参数字段将根据您选择的操作自动填充详细信息。 前往步骤 10
  6. 服务字段中,输入服务名称。
    此字段标识 Web 服务支持的端口集合。 它保留 SOAP Web 服务@调用的服务名称值,例如 Calculator
  7. 可选: 端口字段中,输入要连接的端点。
    如果不指定端口,则 机器人 将根据所选服务使用 WSDL 文件中提及的第一个端口。 但是,如果 SOAP Web 服务不支持该端口,机器人 执行将失败。
    此字段保留 SOPA Web 服务@调用的绑定名称值,例如 CalculatorSoap
  8. 选择您在端口字段中指定的端点的 SOAP 版本
    选择 1.11.2
    注: 可以使用 WSDL 文件中指定的以下命名空间之一来确定 SOAP 版本
    • SOAP 1.1 命名空间:http://schemas.xmlsoap.org/soap/envelope
    • SOAP 1.2 命名空间:http://www.w3.org/2003/05/soap-envelope
  9. 操作字段中,输入您在端口字段中指定的端点的服务功能名称。
    如果以下任一情况为真,则 机器人 执行失败:
    • 端口字段中提及的端口没有任何操作。
    • 该端口的 SOAP 请求中提及的操作不可用。
    此字段保留 SOPA Web 服务@服务调用的操作名称值,例如 Add
  10. 选择操作参数原始数据参数以提供参数详细信息。
    注: 如果您选择了构建 SOAP 请求,则操作选项卡中的参数详细信息表将自动填充所选操作的参数。 为这些参数提供值。 您也可以为特定操作添加、编辑或删除参数。
    • 如果选择操作参数,请输入每个参数的名称和值。 例如,输入以下值:
      1. 在第一个名称字段中输入 intA
      2. 在第一个字段中输入 10
      3. 在第二个名称字段中输入 intB
      4. 在第二个字段中输入 20
    • 如果您选择原始数据参数,请选择参数凭据参数
  11. 参数: 您可以使用凭据存储柜中的凭据值,而无需在原始数据中以纯文本形式公开凭据(用户名或密码)。 为此,您必须首先在凭据映射器中映射凭据,并使用大括号内原始数据中的参考名称。

    例如,在原始数据中,您以纯文本形式提供密码,以对服务器进行身份验证。

    <aut:AuthHeader> <aut:Password> abc@123</aut:Password> </aut:AuthHeader>
    要使用凭据存储柜中的密码,请执行以下步骤:
    1. 单击添加替换
      XML 中的名称字段中输入参考名称,例如 pwd。 选择凭据以使用凭据保管库、变量中可用的值,以使用凭据变量,或选择不安全的字符串以手动指定要使用的值。
      有关凭据保管库及其使用方法的更多信息,请参阅 凭据保管库 中的凭据和 存储柜
    2. 单击添加
    3. 指定大括号内原始数据中的参考,如下所示:
      <aut:AuthHeader> <aut:Password>{{pwd}}</aut:Password> </aut:AuthHeader>
      在原始数据中指定的参考名称 pwd 将替换凭据保管库中存储的相应值。
      确保您按照添加替换中指定的相同格式输入参考名称。 例如,如果您在添加替换中输入密码为 pwd,并在原始数据中输入 password 作为参考名称,则在运行 机器人 时,机器人 将遇到错误。
  12. 凭据参数: 如果您想输入原始数据参数作为凭据。 您可以选择凭据以使用 Credential Vault 中可用的值,或选择变量以使用凭据变量,或选择“不安全的字符串”以手动指定要使用的值。
  13. 身份验证模式列表中选择无身份验证基本身份验证
    • 如果您选择无身份验证,请继续下一步。
    • 如果您选择基本身份验证,请输入您的凭据。
  14. 可选: 通过从 Control Room 或桌面选择文件或插入变量来提供客户端证书。
  15. 可选: 提供自定义标题。
  16. 可选: 提供一个文件以保存 XML 输出。
  17. 选择完整回复选定回复以缩小回复范围。
    • 如果您选择完整回复,请继续下一步。
    • 如果您选择所选响应则在您手动创建 Xpath 表达式而不使用构建 Xpath 选项时,请执行以下步骤。
      1. 提供 XPath 表达式。 例如:
        /*[local-name()='Envelope' and namespace-uri()='http://schemas.xmlsoap.org/soap/envelope/']/*[local-name()='Body' and namespace-uri()='http://schemas.xmlsoap.org/soap/envelope/']/*[local-name()='AddResponse' and namespace-uri()='http://tempuri.org/']/*[local-name()='AddResult' and namespace-uri()='http://tempuri.org/']
      2. 选择 XML 输出的部分: 内部 XML外部 XML
      3. 如果您选择选项,请选择返回内容为: 分隔的字符串字符串列表
        • 如果您选择分隔的字符串,请选择分隔符选项: 管道符分号自定义
          如果您选择自定义,请在自定义分隔符(可选)字段中输入变量或字符。
          注: 不支持将特殊字符美元符号 ($) 作为分隔符。
        • 选择字符串列表,将 SOAP 响应的输出作为字符串列表返回。
          注: 您只能指定数据类型为字符串的列表类型变量。
  18. 单击构建 Xpath
    将出现“输出预览”窗口。
  19. 从回复正文中选择适当的节点。 XML 路径将自动创建。 单击应用
    如果您使用构建 Xpath 选项,XPath 表达式字段将根据您选择的操作自动填充详细信息。
  20. 可选: 要在发送 SOAP 请求和接收响应时设置超时值,请在等待操作完成字段中指定等待时间(以毫秒为单位)。
    默认情况下,等待时间为 60000 毫秒。
  21. 配置 P12 证书:
    • 要获取 SSL 认证文件,请选择以下选项之一: Control Room 文件桌面文件变量
    • 配置 Keystore 属性:
      • 密钥库文件(可选): 要提供 .p12 格式的密钥库文件,请选择以下选项之一: Control Room 文件桌面文件变量。 密钥库文件包含客户端私钥和证书。
      • 密钥库密码(可选): 要提供密钥库文件的密码,请选择以下选项之一: 凭据变量不安全字符串。 密码用于访问密钥库文件。
  22. 选择变量以存储 XML 输出。
    例如,prompt-assignment
  23. 通过在正文消息中插入带有变量 prompt-assignment操作 消息框 操作 来验证 SOAP web 服务的输出。
    运行 机器人 时,消息框应显示 30