菜单

自定义指令

一、什么是自定义指令

1. 功能价值

1.1 拓展RPA能力

开发者可以自行封装一些八爪鱼RPA官方未支持的指令,将自己常用的功能模块封装成一个指令,例某网站的数据获取

1.2 降低维护成本

开发者可以封装需要经常复用的流程片段,方便后期维护。假设A、B、C三个应用都需要用到登录淘宝功能,淘宝前端迭代时可能会影响这部分流程,如果不使用自定义指令,就得逐个修改应用,耗时耗力。但如果封装成指令进行引用,改动一处,剩余部分都会自动同步。

2. 使用场景

2.1 开发者通用角度

小八是一名有RPA搭建能力的小红书创作者,之前搭建了很多小红书相关的RPA应用,如小红书笔记采集、图文批量发布、评论采集。每个应用初始步骤都是登录模块,为了提升开发效率,他将小红书登录模块封装成指令库,然后在开发其他应用时就可以直接进行调用。后期登录逻辑有改动的话,他就可以只优化该指令库,其他用到这个指令块的RPA应用会直接更新。

2.2 企业开发者角度

小八是一名企业开发者,他经常会封装一些已有场景的自定义指令库,这些指令库都可以被企业内的成员使用

2.3 共享角度

小八将使用了自定义指令库的应用分享给其他人使用时,指令库可以自动加载,无需使用者额外操作

3. 常用定义

3.1 自定义指令

实现某个功能的可执行模块,如登录判断等。如下图所示,红框内均为自定义指令

3.2 指令库

多个功能类似的指令合集,可进行统一发布和版本管理。如下图所示,淘宝登录和小红书登录都是指令库

3.3 输入变量和输出变量

  • 输入变量
  • 指令的输入参数

  • 选择此类型,后续用户使用到此指令时,会提醒他输入相关数据
  • 如果需要设置输入提示、占位符等,可点击指令后方的“编辑”按钮

  • 输出变量
  • 指令的输出参数
  • 这类变量会在指令运行结束后返回给用户

 

二、自定义指令

1. 使用全流程(流程图)

2. 具体案例

以开发“小红书”指令库为案例进行说明,该指令库包含环境初始化、登录状态判断、消息通知3个指令

2.1 新建指令库

切换到“指令库”--->点击“新建指令库”

2.2 开发指令库

以“消息通知”指令为例,其他指令开发方法相同。日常搭建过程中,消息通知有多种方式,例如在飞书群内通知、邮件通知等,下方案例采用邮件通知的形式。
  • 新建自定义指令

点击“新增指令按钮”--->给指令重命名,命名为“消息通知”

 
  • 定义输入、输出变量
    • 消息通知:需要输入发件邮箱、发件授权码、收件邮箱,输出邮件发送状态
    • 切换“变量”--->点击“新增自定义变量”按钮--->输入变量名、数据类型、默认值和变量类别
 
    • 输入变量、输出变量创建完成示例图
  • 指令搭建
与常规流程开发逻辑一致,即之前怎么搭建主流程、子流程,现在用同样的方式搭建自定义指令即可
 
  • 指令界面编辑、预览
    • 自定义指令信息编辑
   可以设置自定义指令展示的图标、名称、描述等信息,如下图
    • 自定义指令变量信息编辑
可以设置指令的输入输出参数的展示样式、显示名称、参数描述、控件类型、校验等;也可以调整参数的显示顺序,常规、高级设置;可以编辑指令在画布中显示的内容,可以调用变量

2.3 自定义指令显示与隐藏

鼠标hover想要操作的指令上,即可看到显示/隐藏图标,点击即可设置显示与否

2.4 指令库预览

 指令库开发完成后,可以进行预览,预览的效果就是未来其用户使用时的效果

2.5 指令库发版

指令库开发完成或编辑完成后,点击“发版”,发版后就可以在其他应用/指令库引用

2.6 拓展指令

在指令列表中点击“扩展”-->选择个人/企业开发的指令库--->即可看到自己开发的或企业开发的指令库

 

三、指令库管理

指令库管理界面

  • 新建/编辑指令库
  • 查看指令库详情:可看到指令库中包含哪些指令

  • 拷贝为副本
  • 删除:删除指令库后会进入回收站,可以在回收站找回

 

四、指令管理

  • ①新建自定义指令:和新建子流程交互一致
  • ②指令库预览:可以查看当前指令库包含的指令及每个自定义指令的界面预览
  • ③预览及编辑:可以编辑自定义指令的名称、描述、参数顺序、参数的名称、描述、控件设置等
  • ④指令的显示设置:眼睛处于睁开的状态时,表示发版后其他应用/指令库可以使用该自定义指令;  闭上时,在其他应用或者指令库编辑的时候,看不到该自定义指令

  • ⑤变量的新增与引用关系查看,与流程一致

 

五、调用其他指令

 

  • 为提高流程的复用性,当指令库中多个自定义指令中部分流程片段可以复用,就可以将它单独拿出来,设置为隐藏的自定义指令,然后在其他指令中进行调用

 

六、拓展指令

  • 在应用和指令库中,都可以使用已封装好的指令库(不能自己调用自己)
  • 自己发版的指令库和官方指令库都可以在此处进行查找和使用
  • 找到目标指令直接拖入流程中即可
  • 我的tab可查看当前应用/指令库用到的所有指令库,当指令库有更新时,会出现更新提醒,可以单个指令库更新、也可以进行批量更新

 

 七、指令库加载

  • 当应用打开/运行时,会自动安装需要的的指令库
  • 当依赖个人开发的指令库的应用被分享时,接受应用的用户同时会获得指令库的使用权限,即在当前应用中可以使用该指令库,其他应用/指令库将无法获得该指令库
  • 版本兼容规则:
    • 安装指令库只可安装最新版本,由于存在已安装未更新的用户,因此所有版本需要保留,不提供安装入口
    • 当已安装的指令库有依赖冲突时,遵循向上更新原则,即当依赖多个指令库的多个版本时,默认使用最新的那个版本
上一个
自定义指令
下一个
专题文档
最近修改: 2025-03-04