发送 Web 服务请求 |
“发送 Web 服务请求”操作用于发送对 Web 服务(REST 或 SOAP)的 HTTP 请求。
可以在以下选项卡上配置“发送 Web 服务请求”操作的属性。
Web 服务请求
URL: 输入希望发送到的 Web 服务器的 URL。也可以通过添加变量来指定 URL。
方式: 选择希望使用的 Web 请求 HTTP 方法。选项包含 POST、GET、PUT、DELETE 或 HEAD。
内容类型: 选择用于 Web 请求的内容类型。在选择 POST 或 PUT 方法时可用。
HTTP 头: 输入要通过 Web 请求发送的 HTTP 头属性和值。可以从 HTTP 头属性和值的字典中选择,也可以通过添加变量来指定头属性或值。还可以向您输入的值添加特殊字符。
来源
内容数据: 指定希望通过 POST 或 PUT Web 请求 HTTP 方法发送的内容数据。在为“方法”属性选择 POST 或 PUT 时可用。
查询字符串: 指定希望通过 GET、DELETE 或 HEAD Web 请求 HTTP 方法发送的查询字符串。在为“方法”属性选择 GET、DELETE 或 HEAD 时可用。
变量:
变量: 输入想要为来源使用的变量。也可以单击 选择最近使用的变量,或单击“更多变量”打开“插入变量”对话框。
外部文件:
HTTP 请求变量:
变量名: 指定希望用作来源的 HTTP 请求变量的变量名称。
值: 指定 HTTP 请求变量的值。
身份验证
方式: 指定操作用来连接到客户端的身份验证方法。
匿名: 指定任何用户无需提供用户名和密码即可访问客户端。
使用当前的 Windows 证书: 指定当前 Windows 用户帐户用于连接到客户端。
使用指定的证书: 指定提供的用户名、域和密码用于连接到客户端。
我们的回答
成功状态代码: 指定您视为成功的状态代码。
将响应保存到变量: 指定希望保存 Web 服务响应的变量。在输入框中输入所需变量。或者,可以添加一个变量。
高级选项
源内容在“SOAP 正文”标记中自动换行: 指定在发送之前,源内容将在“SOAP 正文”标记中自动换行。在为“方法”属性选择 POST 或 PUT 时可用。
发送超时: 指定在操作失败之前等待客户端响应的时间(以秒为单位)。
重试计数: 指定当操作失败时重新发送请求的次数。
Action
名称: 指定操作的名称。可以通过在字段中输入新名称来替换默认名称。
描述: 指定操作的描述。
运行操作: 指定所需的操作运行频率。
始终: 指定只要发生事件就运行操作。
从不: 指定发生事件时不运行操作。
根据变量,在一定条件下: 指定仅当所选变量满足指定条件时,才会运行操作。在仅有一个条件可以确定是否运行操作的情况下才可使用此选项。选择此选项后,就可以在输入框中创建条件语句。
变量: 指定希望为条件语句使用的变量。在输入框中输入变量。单击 查看最近使用的变量的列表,或单击“更多变量”打开“插入变量”对话框。
[关系运算符]: 指定用于条件语句的关系运算符。单击现有运算符显示更多运算符的列表,然后单击一个希望使用的运算符。有关更多信息,请参见关系运算符。列表中的可用运算符取决于为“类型”选项选择的是“文本”还是“小数”。
值: 指定用于条件语句的值。要添加值,请单击 ,单击“<输入值>”,输入所需值,然后按
Enter
。要删除值,请使用次要鼠标按钮单击该值,然后单击“删除”。一些运算符(如“is blank”和“is not blank”)不需要指定值。在这些情况下,“值”字段不可用。
类型: 指定条件语句是对文本值还是小数值求值。
根据表达式,在一定条件下: 指定操作的运行条件。此选项在需要不只一个条件语句的情况下使用。如果选择此选项,则可通过创建所需条件语句,在输入框中创建条件表达式。可以在“树视图”选项卡中创建和编辑条件表达式。单击“文本视图”选项卡可查看条件表达式的只读文本视图。
[条件连接符]: 指定组中的条件语句的条件连接符。默认条件连接符为 And。
单击现有条件连接符将显示一个菜单,可用于以下面的一种方式配置条件表达式:
And、Or、NotAnd、NotOr: 在列表中单击希望为条件语句使用的条件连接符。有关受支持的条件连接符的更多信息,请参阅条件连接符。
添加条件: 单击可向当前组添加其他条件语句。
添加组: 单击可向当前组添加一个条件语句子组。
移除组: 单击将删除子组。在从子组打开菜单时可用。
全部清除: 单击可删除所有条件语句(包括子组)。在从最上方的组打开菜单时可用。
: 向与该连接符关联的组中添加条件语句。在表达式中每个条件连接符的右侧可见。
: 删除该条件语句。 指向某个现有条件语句时在该条件语句的右侧可见。
变量: 指定希望为条件语句使用的变量。在输入框中输入变量。单击 查看最近使用的变量的列表,或单击“更多变量”打开“插入变量”对话框。
[关系运算符]: 指定用于条件语句的关系运算符。单击现有运算符显示更多运算符的列表,然后单击一个希望使用的运算符。有关更多信息,请参见关系运算符。列表中的可用运算符取决于为“类型”选项选择的是“文本”还是“小数”。
值: 指定用于条件语句的值。要添加值,请单击 ,单击“<输入值>”,输入所需值,然后按
Enter
。要删除值,请使用次要鼠标按钮单击该值,然后单击“删除”。一些运算符(如“is blank”和“is not blank”)不需要指定值。在这些情况下,“值”字段不可用。
类型: 指定条件语句是对文本值还是小数值求值。
错误处理和诊断
忽略错误并继续运行操作: 指定如果操作失败,那么会继续运行其余操作。如果未选中此选项,并且操作失败,那么产生的行为取决于多种因素,如下所示:
失败时重试: 指定如果操作失败,那么 BarTender 会尝试再次运行操作。
最大重试次数: 指定 BarTender 将会再次尝试运行操作的最大次数。选中“失败时重试”选项时可用。
重试间隔: 指定 BarTender 在操作失败后尝试再次运行操作之前等待的时间长度。选中“失败时重试”选项时可用。