阿里云RPA产品服务型机器人操作说明

具体步骤如下:
1.png

1)在Studio里面创建一个服务型机器人应用

2.png

2)设置相应的参数

3.png
•参数的获取:
参数的获取,按照正常的应用写法获取参数。 rpa.params[“myInput”]
•结果的返回:
调用提供的API,把应用的结果返回。rpa.workbench.task_result(resStr)
完成上述步骤之后,在Studio里正常发布此服务型应用。

3)创建API代理用户

服务型的应用,是通过API的方式提供给外部系统进行使用。API的调用,需要有一个阿里云RPA的用户进行授权,每次API的调用,都会记录在这个用户名下。

4)订阅服务型应用

服务型的应用,需要在获取后,才能使用。有两种方式可以获取服务型应用。
1. 如果API代理用户有 企业应用市场管理 的权限,那么可以直接在控制台来获取。
4.png
2. 如果API代理用户不具备 企业应用市场管理 的权限,那么需要让用户先登录有人值守机器人的客户端,申请应用并由管理员审核通过。

5)获取API用户AK

使用API用户登录控制台,进入系统设置,获取用户的AK(access key和access token)。后续其他应用通过这个AK进行调用,操作日志会记录在这个用户下面。
5.png

6) 获取服务型应用的接口地址

管理员登录控制台,在企业应用市场管理 中,可以看到服务型应用的接口。
6.png

7) API列表

•公共请求
所有的API请求中,都需要在HTTP请求中,增加头参数:

参数key **类 **
accessKey String 从控制台中获取到的 accessKey
accessKeySecret String 从控制台中获取到的 accessKeySecret

•调用服务型接口
1. 使用方通过指定的API地址,AK调用接口,随后触发服务型机器人工作,执行对应的流程,流程执行结束后,会获取到数据。 这个数据有两种返回形式,一种是在接口调用的时候,注册一个回调的地址,在流程执行完成后,把数据通过回调接口传送回去;一种是接口调用的时候,可以获取到一个数据结果地址,可以过一段时间,获取到结果。
2. 表单不支持文件的上传,如果需要上传文件,需要先单独上传文件,然后再把文件地址,放到参数中。
3. appParams的结构,建议是json格式,但是也可以是任何格式,具体格式的解析,需要在阿里云RPAAPP中进行解析。
调用地址:http://rpa-demo.allinbots.com/rpa/api/ak/server/call/${appUuid}
请求方式:POST 请求参数:

参数key 类型 请求方式 是否必选 描述
config String FormParam 回调接口

config参数说明:
config是一个一维的 json object 对象。

  1. {
  2. "appParams": "{\"myCheckBox\":\"cserver\",\"myPassword\":\"myServerPwdValue\",\"mySelect\":\"server\",\"myTime\":\"2018-09-19 19:59:59\",\"myColor\":\"3422101\",\"myInput\":\"myServerInputValue\",\"myFile\":\"C:\\\\Users\\\\njwander\\\\Desktop\\\\AliRPA\\\\AliyunRPA Studio.bat\"}",
  3. "robotName": "wfx-fw-0906",
  4. "callbackUrl": "http://30.5.121.152:8887/rpa/received",
  5. "timeout": 0
  6. }
key 类型 必选 可选值 默认值 说明
appParams string 应用的参数json对象的序列化string,注意转义。
robotName string 服务型机器人的名称,如果不指定,则会随机选择一个空闲的服务型机器人。
callbackUrl string 回调的url地址,如果有指定这个值,那么需要保证这个接口地址是可以直接调用到的。目前没有鉴权的能力。服务端会以POST的方式进行调用,返回的结果,会放在request的body中。详细说明
timeout int 3600 任务最大等待时间(单位秒)。默认值为一小时。

返回参数:

  1. {
  2. "success": true,
  3. "code": 200,
  4. "msg": "",
  5. "data": {
  6. "resultUrl": "http://rpa-demo.allinbots.com/rpa/api/ak/server/result?uuid=11fdeba2-f7ad-4a74-8ce5-6d8b716ee88f",
  7. "taskId": "fa77b557-3538-4a77-98fc-e80ab6e0b485"
  8. }
  9. }

获取数据的接口。如果有传递callbackUrl, 那么通过回调接口返回。
服务型应用的调用地址,可以在这里看到:
•查看机器人状态
根据启动后,得到的taskId,再次调用,获取任务状态。
调用地址:http://rpa-demo.allinbots.com/rpa/api/ak/server/task/status/{taskUuid}
请求方式:GET
返回结果:

  1. {
  2. "success": true,
  3. "code": 200,
  4. "msg": "",
  5. "data": {
  6. "status": "Running",
  7. "remark": "中文描述"
  8. }
  9. }

文件上传

单独上传文件的接口
调用地址:http://rpa-demo.allinbots.com/rpa/api/ak/server/uploadFile
请求方式:multipart/form-data

参数key **类 **请求方 **是否必 **
file File FormParam 上传的文件

•接口回调数据说明
回调的数据,是在机器人执行的应用中,调用api:rpa.workbench.task_result(string) 写入的,写入的string需要是一个标准的jsonobject对象。
callbackUrl需要满足如下条件:
1.http 或 https 的 post 请求。
2.接口免登
3.Content-type:application/x-www-form-urlencoded
4.数据采用 form 表单方式发送,键值为:data

回调是由RPA服务端发起的,所以要确保RPA服务端可以访问回调地址

本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可
RPA学习 » 阿里云RPA产品服务型机器人操作说明

常见问题FAQ

免费下载或者学员专享资源能否直接商用?
本站所有资源(非注明本站原创内容)版权均属于原作者所有,这里所提供资源均只能用于参考学习用,请勿直接商用。若由于商用引起版权纠纷,一切责任均由使用者承担。已注明本站原创资源的,可直接商用。
提示下载完但解压或打开不了?
最常见的情况是下载不完整: 可对比下载完压缩包的与网盘上的容量,若小于网盘提示的容量则是这个原因。这是浏览器下载的bug,建议用百度网盘软件或迅雷下载。 若排除这种情况,可在对应资源底部留言,或 联络我们。
找不到素材资源介绍文章里的示例图片?
对于PPT,KEY,Mockups,APP,网页模版等类型的素材,文章内用于介绍的图片通常并不包含在对应可供下载素材包内。这些相关商业图片需另外购买,且本站不负责(也没有办法)找到出处。 同样地一些字体文件也是这种情况,但部分素材会在素材包内有一份字体下载链接清单。

发表评论

17 + 16 =

提供最优质的RPA学习资源集合

立即查看 了解详情