如何填写RPA runWith运行参数

2022-09-27 567

为方便填写RPA参数,推荐您使用RPA参数生成器:https://rpa-api-assistant.ziniao.com/

1、RPA详情查看接口说明

( 为方便填写RPA参数,推荐您使用RPA参数生成器:虎步OpenAPI开发助手
首先要在RPA市场中找到一个合适业务的RPA ,然后查看这个RPA的ID【如何获取RPAID】,通过这个ID调用【RPA详情查看接口】,就可以看到这个RPA运行时所需要的参数和取值范围。
如下图为查看RAP详情接口的返回值
runWith,表示该RPA需要的参数列表。
如上图,表示该RPA需要一个名为daterange(日期范围)的参数,format参数,表示其取值范围,如 {\"value\":\"yesterday\",\"name\":\"昨日\"},表示可取值为"yesterday",代表的含义是"昨天"。
自定义daterange类型时比较特殊,参数取值由开始时间戳+结束时间戳组成。
常用的参数类型还有string类型,该类型没有取值范围限制。

2、创建RPA计划接口和RPA运行参数的关系

(1)快速创建一个RPA执行计划

如下图,在创建RPA执行计划时,选择使用的RPA其ID为1030,功能为账户余额截图,并设置了这个RPA的运行参数 runWIth参数,将名为“datarange”的参数值,设置为”yesterday“。表示,要截取当前时间前一天(昨天)的账户余额截图。

(2)多参数如何填写?

如:要运行一个ID为1657248644的RPA,功能为:亚马逊-广告活动-品牌推广导入的RPA。通过RPA详情查看接口发现,需要三个参数,分别是要下载的报表日期范围、下载时选择的报表类型、下载时选择的时间单位。这三个参数对应的是RPA在运行时,需要在电商平台上输入或选择的三个元素。
RPA详情查看接口返回如下:
多参数RPA详情
当使用上方的RPA创建多参数RPA执行计划时,需要输入的参数如下图

(3)自定期日期范围如何填写?

当RPA可输入自定义类型的日期范围时,其格式为开始时间戳,结束时间戳,如下面样例,daterange类型,会精确到天。
"scriptList": [ { "scriptId": "1002", "runWith":[ { "name":"daterange", "value":"1658246400000,1658332800000" } ] } ]

3、常用参数类型

类型:daterange 日期范围类型

取值 参数描述
beforeyestoday 前天
yesterday 昨天
today 今天
lastweek 上周(周一开始)
lastweek_saturday 上周(周六开始)
lastweek_sunday 上周(周天开始)
lastmonth 上月
last3months 上3个月
month 本月至今
3daysago 三天前
4daysago 四天前
last7 最近7天
last14 最近14天
last30 最近30天
last60 最近60天
pastyear 去年
yeartotoday 今年至今天
1648806245409,1648806245409 自定义(开始时间戳、结束时间戳)

4、参数生成器

为方便填写RPA参数,推荐您使用RPA参数生成器:虎步OpenAPI开发助手 (ziniao.com)