发布 URL
发布数据 Deluge 任务对应 HTTP POST 请求。用于执行编写操作(例如,添加或更新数据)的服务通常支持此任务。
语法
a. 获取仅带有字符串形式的响应内容的简单响应。
<string-variable> = postUrl(<url string>,<map-variable>,true)
其中,
<string-variable> - 用于以字符串格式保存响应内容的字符串变量的名称。
<url string> - 要访问的 URL,例如,"http://crm.zoho.com"
<map-variable> - 用于将请求值保存为指定格式的键/值对的映射变量。
b. 获取详细响应,此响应以键/值对形式返回响应代码(http 状态码)和响应内容。
<map-variable> = postUrl(<url string>,<map-variable>,false)
其中,
<map-variable> - 用于保存响应代码和响应内容的映射变量的名称。
<url string> - 要访问的 URL,例如,"http://crm.zoho.com"
<map-variable> - 用于将请求值保存为指定格式的键/值对的映射变量。
c. 发布头信息及请求,此信息需要以映射变量的形式传递至第三个自变量。
<String/Map-variable> = postUrl(<url string>,<request map-variable>,<header map variable>, <boolean isSimpleResponse>)
其中,
<map-variable> - 用于保存响应代码和响应内容的映射变量的名称。
<url string> - 要访问的 URL,例如,"http://crm.zoho.com"
<request map-variable> - 用于将请求值保存为指定格式的键/值对的映射变量。
<header map-variable> - 用于将头值保存为指定格式的键/值对的映射变量。
<isSimpleResponse> - 可选布尔值,对于 simple(string) 响应为 true,对于 detailed(map) 响应为 false。默认值为 true。
d. 直接将内容写至 POST 请求主体(例如,使用 GDATA 协议插入条目)。
<String/Map-variable> = postUrl(<url string>,<request string-variable>,<header map variable>, <boolean isSimpleResponse>)
其中,
<map-variable> - 用于保存响应代码和响应内容的映射变量的名称。
<url string> - 要访问的 URL,例如,"http://crm.zoho.com"
<request string-variable> - 用于保存需要写至 POST 请求主体的内容的字符串变量。
<header map-variable> - 用于将头值保存为指定格式的键/值对的映射变量。
<isSimpleResponse> - 可选布尔值,对于 simple(string) 响应为 true,对于 detailed(map) 响应为 false。默认值为 true。
注:
- 可使用 EncodeUrl() 函数对 URL 字符串进行编码。
用于获取响应代码和响应文本的语法:
map.get("responseCode"); // returns the HTTP response status code
map.get("responseText");
如果响应文本的类型为 XML,那么可使用 executeXPath 语句从文档中选择节点。如果响应文本的类型为 JSON,那么它可转换为 XML。
使用脚本构建器
要在脚本构建器中添加“发布 URL”任务,
- 从左侧任务树中拖放 Web 数据 - 发布 URL。
- 点击编辑以显示“编辑”对话框。
- 指定外部网站的 URL 字符串。
- 指定请求映射变量,此变量以外部 API 指定的格式保存 POST 请求参数
- 选择“简单响应”以仅获取字符串形式的响应内容,或选择“详细响应”以获取键/值对形式的响应代码和响应内容。
- 点击完成以将该值添加至脚本编辑器。