| 目录 |
|---|
1.HCM机器人所在位置
token已无效化处理
系统设置 → > 基础服务 →> 机器人设置
2.HCM机器人存在背景
...
| 脚本配置参数路径 | 类型 | 说明 | |
|---|---|---|---|
| stages | list | 任务list，里面包含了多个任务的详细信息，每个任务对应一个dict | |
| context | dict | 脚本预制上下文 | |
| return | list | 返回值字典 | |
| stages.meta | dict | 单个任务接口信息 | 需要 name （接口名称）和 param （接口参数）在Message引擎下 有to（目标人ID，缺省发给自己） 和context（消息内容） 两个参数 |
| stages.name | str | 单个任务名称 会在执行过程中提示任务执行情况 | |
| stages.engine | str | 任务接口引擎 | OpenAPI：本系统接口。RemoteAPI：外系统接口 使用这个引擎 stages.meta 里面需要有url 和token Shortcut：调用其他的HCM机器人，在这里stages.meta.name 是其他机器人的名称，Message：发送消息 这个引擎下stages.meta |
| stages.output | dict | 本任务执行结束输出的内容 | 包含两个参数message 页面消息提示 ，context 类型为dict （本任务结束将一些参数放入上下文中） |
| stages.iterator | 表达式/可迭代对象 | 根据迭代对象 循环执行 | ITER_V 特定写法stages.iterator 单元值 ITER_I 特定写法stages.iterator 单元值 的index 比如list 的index |
| stages.parallel | 表达式/可迭代对象 | 根据迭代对象 循环执行加入队列 | ITER_V 特定写法stages.iterator 单元值 ITER_I 特定写法stages.iterator 单元值 的index 比如list 的index |
| stages.queue | str | 只有定义了stages.parallel 才有用到意思是在什么队列执行缺省shortcut队列 | |
| stages.error | dict | 任务执行失败需要的操作 | 包含两个参数 ignore 执行失败 是否跳过，跳过就继续执行下面的任务，不跳过整个将结束，没有这个参数也将直接结束 context 是将一些参数 放入上下文中 在这里 err 为报错堆栈信息 固定写法 |
| stages.condition | 表达式/boolean | 是否跳过此任务 | |
| output | stages下meta返回值 | context 上下文 message 输出执行消息 | 例子："output": { "context": { "info": "=ret" } ret为固定变量，即stages下meta的返回值，此配置代表将返回值给到环境变量中，下一个任务可以调用使用 |
配置举例一：
需求：选中自定义模型TestModel下的数据，将该条TestModel模型下note备注字段编辑成： 已完成{}的查验
...
所以配置 "iterator": "=node_ids"
4、执行效果：
配置举例二：
机器人设计规则：
1）取外部inspur6环境下车厘子的信息
...
| 代码块 | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"return": {
"id": "x_ID"
},
"stages": [{
"meta": {
"url": "https://inspur6.hcmcloud.cn",
"name": "hcm.model.list",
"param": {
"model": "Employee",
"filter_dict": {
"name": "车厘子"
}
},
"token": "hcm0af7a670b548ccfab3352d74b52bf596b1084209hcm0af7a67123aa3352d74b3434596b1443sdf"
},
"name": "取外部数据",
"engine": "RemoteAPI",
"output": {
"context": {
"x_ID": "=ret['list'][0]['id']"
},
"message": "='共{}条记录'.format(ret['count'])"
}
}, {
"meta": {
"name": "hcm.model.get",
"param": {
"id_": "=x_ID",
"model": "Employee"
}
},
"name": "查看本系统是否有该数据",
"error": {
"ignore": true,
"context": {
"is_error": true,
"get_mobile_error": "=err"
}
},
"engine": "OpenAPI",
"output": {
"context": {
"is_error": false,
"employee_id": "=ret['list'][0]['id']"
},
"message": "='共{}条记录'.format(ret['count'])"
}
}, {
"meta": {
"name": "hcm.model.create",
"param": {
"info": {
"name": "机器人测试日志",
"type": 2,
"content": {
"get_mobile_error": "=str(get_mobile_error)"
}
},
"model": "SyncOuterRecord"
}
},
"name": "记录日志",
"engine": "OpenAPI",
"output": {},
"condition": "=is_error"
}, {
"meta": {
"name": "机器人脚本示例",
"param": {
"node_ids": [{
"id": 402186251,
"employee": {
"name": "梁天华"
}
}]
}
},
"name": "调用其他机器人",
"engine": "Shortcut"
}, {
"meta": {
"to": 1508957,
"sender": 1508957,
"content": "本次HCM机器人演示成功"
},
"name": "发送消息",
"engine": "Message"
}],
"context": {}
} |
配置地址：https://inspur6.hcmcloud.cn/#/pc/setting/setting.hcm_shortcut?page_index=1&page_size=20
配置举例三：
机器人设计规则：
1）将语种代码项下的描述编辑成：描述：xx
...