# 指令文档

一个指令对应一个组件,本篇文档介绍所有组件的属性配置。IPaaS和RPA流程在组件展示区的组件不尽相同,请根据实际情况进行使用。

TIP

注意:由于软件更新迭代太快,指令文档有时来不及更新😢

# 基本命令

# 逻辑控制

# 变量声明

  • 描述:声明(创建)一个新的变量。
  • 配置:
    类型 默认值 示例 描述
    变量名 变量 temp temp 变量的名称,新声明的变量
    变量值 任意 "abc" 变量的值

# 变量赋值

  • 描述:给已声明过的变量重新赋值。对未声明的变量赋值会创建一个值不可预知的全局变量。
  • 配置:
    类型 默认值 示例 描述
    变量名 变量 temp 变量的名称,已声明过的变量
    变量值 任意 "abc" 变量的值

# if控制

  • 描述:条件为真判断,为真则执行if流程块。
  • 配置:
    类型 默认值 示例 描述
    作用描述 字符串 "" "此人是老王" 该判断的业务描述
    表达式 表达式 name=='老王' 逻辑判断表达式

# if-else控制

  • 描述:条件为真判断,为真则执行if流程块,为否则执行else流程块。
  • 配置:
    类型 默认值 示例 描述
    作用描述 字符串 "" "此人是老王" 该判断的业务描述
    表达式 表达式 name=='老王' 逻辑判断表达式

# for循环

  • 描述:按设置的循环次数,循环执行for流程块。
  • 配置:
    类型 默认值 示例 描述
    作用描述 字符串 "" "循环递增次数" 该循环的业务描述
    循环次数 数字 0 3 循环执行的次数
    索引变量 变量 index i 当前循环的次数索引,在流程块中使用,从0递增

# while循环

  • 描述:若表达式为真,则循环执行while流程块,为否则退出循环。
  • 配置:
    类型 默认值 示例 描述
    作用描述 字符串 "" "此人是老王" 该循环的业务描述
    表达式 表达式 name=='老王' 逻辑判断表达式

# 继续循环

  • 描述:仅限在for或while循环组件中使用,结束本次循环开始下一次循环。
  • 配置:无

# 跳出循环

  • 描述:仅限在for或while循环组件中使用,结束本次循环且不再开始下一次循环。
  • 配置:无

# 异常捕获

  • 描述:用于包裹可能执行出错的流程块,当try流程块执行出错时不会终止整个流程的执行,同时可以在catch流程块中处理出错信息。
  • 配置:
    类型 默认值 示例 描述
    作用描述 字符串 "" "捕获获取订单详情的异常" 异常捕获的业务描述
    输出异常 变量 error err 捕获到的异常信息

# 抛出异常

  • 描述:流程执行过程中主动抛出异常,终止整个流程的执行(try流程块中抛出异常不会终止流程)。
  • 配置:
    类型 默认值 示例 描述
    异常信息 任意 "运行出错" 抛出的异常信息

# 日志

# 写入错误日志

  • 描述:向流程日志中写入错误类型的日志。
  • 配置:
    类型 默认值 示例 描述
    日志信息 任意 ret "一条错误日志" 错误类型的日志内容

# 写入警告日志

  • 描述:向流程日志中写入警告类型的日志。
  • 配置:
    类型 默认值 示例 描述
    日志信息 任意 ret "一条警告日志" 警告类型的日志内容

# 写入调试日志

  • 描述:向流程日志中写入调试类型的日志。
  • 配置:
    类型 默认值 示例 描述
    日志信息 任意 ret "一条调试日志" 调试类型的日志内容

# 对话框

# 消息对话框

  • 描述:弹出消息对话框,确认则流程继续执行,取消则流程终止。
  • 配置:
    类型 默认值 示例 描述
    消息内容 任意 "一条消息" 对话框消息内容

# 输入对话框

  • 描述:弹出输入对话框,确认则流程继续执行,取消则流程终止。
  • 配置:
    类型 默认值 示例 描述
    提示输入 字符串 "请输入:" "请输入" 对话框提示内容
    返回值 变量 ret ret 输入的内容

# 自定义对话框

  • 描述:弹出自定义对话框,确认则流程继续执行,取消则流程终止。
  • 配置:
    类型 默认值 示例 描述
    标题 字符串 "对话框" "配置对话框" 对话框标题
    配置文件 字符串 "" "dg_1683884750566.json" 对话框配置文件
    返回值 变量 ret ret 对话框交互的内容

# 其它操作

# 延时

  • 描述:流程暂停,等待设置的延时时间后继续执行。
  • 配置:
    类型 默认值 示例 描述
    延时时间 数字 3 5 流程暂停的时间,单位:秒

# 系统通知

  • 描述:右下角弹出系统通知。
  • 配置:
    类型 默认值 示例 描述
    标题 字符串 "通知" "系统通知" 通知标题
    内容 字符串 "xx成功了" 通知内容

# 运行指定路径

  • 描述:以操作系统的默认运行方式,运行指定路径。比如:打开文件夹。
  • 配置:
    类型 默认值 示例 描述
    路径 字符串 "c:/path/to" 本地路径

# 自定义代码

  • 描述:直接为流程编辑代码,代码被插入流程中随着流程一同执行,代码上下文作用域和流程作用域相同,仅支持javacript代码。
  • 配置:
    类型 默认值 示例 描述
    代码作用 字符串 "标题" "人名校验" 代码段的作用
    编辑代码 字符串 "var a = 1;" js代码

# 接口请求

  • 描述:向一个接口发起ajax请求,超时则终止流程。
  • 配置:
    类型 默认值 示例 描述
    请求类型 字符串 "get" "post" 请求类型
    接口地址 字符串 "http://x.com/api" 请求地址
    请求参数 对象 {k1:1, k2:"abc"} 请求参数
    请求头 对象 {token:"xxx"} 请求headers
    超时时间 数字 30 10 请求超时时间
    返回值 变量 ret ret 请求返回值

# 退出流程

  • 描述:终止流程。
  • 配置:
    类型 默认值 示例 描述
    退出码 数字 0 1 流程退出码

# 软件自动化

# 浏览器

# 打开浏览器

  • 描述:打开浏览器应用。
  • 配置:
    类型 默认值 示例 描述
    浏览器 字符串 "默认浏览器" "指定执行路径" 浏览器类型
    运行路径 字符串 "c:/xx" 指定执行路径时才设置
    用户数据目录 字符串 "c:/xx" 多账号运行时才设置
    代理服务器 字符串 "xx.xx.xx.xx" 浏览器访问代理IP
    后台执行 字符串 "否" "是" 是否无头模式运行
    无感模式 字符串 "否" "是" 是否标签页界面跟随操作切换
    结束后关闭 字符串 "是" "是" 是否流程结束后关闭浏览器
    返回值 变量 browser browser1 浏览器对象

# 打开网址

  • 描述:访问指定的网址,超时则终止流程。
  • 配置:
    类型 默认值 示例 描述
    浏览器 变量 browser browser1 浏览器对象
    网址 字符串 "http://xx.com" 要访问的网址
    超时时间 数字 30 30 打开网址的超时时间
    返回值 变量 page page1 页面对象

# 点击目标

  • 描述:点击页面目标。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象
    触发导航 字符串 "否" "是" 是否会触发当前页面导航
    模拟点击 字符串 "否" "是" 是否采用代码模拟点击
    触发下载 字符串 "否" "是" 是否会触发下载文件

# 点击打开新标签页

  • 描述:点击页面目标打开新标签页。
  • 配置:
    类型 默认值 示例 描述
    原页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象
    返回值 字符串 page page2 新页面对象

# 是否存在目标

  • 描述:页面上是否存在指定的目标,超时则返回false。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象
    检测超时 数字 3 5 检测超时时间
    匹配内容 字符串 "否" "是" 是否内容也要匹配
    返回值 变量 ret ret 是否存在,true/false

# 移动到目标上

  • 描述:移动鼠标到页面指定的目标上。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象

# 选择下拉框选项

  • 描述:选择指定的下拉框选项,只支持原生select页面元素。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象
    选项值 字符串 "value0" 要选中的选项值

# 获取下拉框选项值

  • 描述:获取选中的下拉框选项值,只支持原生select页面元素。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象
    返回值 变量 ret ret 选中的选项值

# 勾选目标

  • 描述:勾选一个复选框或者单选框,只支持原生checkbox或者radio页面元素。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象

# 获取勾选目标值

  • 描述:获取勾选类型元素的值,只支持原生checkbox或者radio页面元素。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象
    返回值 变量 ret ret 勾选类型元素的值

# 获取目标文本

  • 描述:获取目标的文本内容。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象
    返回值 变量 ret ret 目标文本内容

# 在目标中输入

  • 描述:在输入框或文本框中输入指定内容。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象
    输入值 字符串 "你好!" 输入的内容
    输入间隔 数字 1 0.5 输入单个内容的间隔,单位:秒
    清空后输入 字符串 "是" "否" 是否清空内容后再输入
    强制输入 字符串 "否" "是" 是否采用代码强制输入
    直接输入 字符串 "否" "是" 是否不focus目标直接输入

# 等待目标

  • 描述:等待直到目标出现,超时则终止流程。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象
    等待超时 数字 30 60 等待目标超时时间,单位:秒

# 批量抓取数据

  • 描述:批量抓取页面数据,支持分页抓取。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象
    抓取页数 数字 1 3 抓取的页数
    分页间隔 数字 1 3 操作分页的间隔时间,单位:秒
    抓取链接 字符串 "否" "是" 是否同时抓取对应条目的链接
    先滚动到底部 字符串 "否" "是" 是否抓取前先滚动到页面底部
    返回值 变量 ret ret 抓取到的数据

# 获取相似目标

  • 描述:获取相似目标中指定位置的目标。比如:页面列表中的第2个元素
  • 配置:
    类型 默认值 示例 描述
    目标 对象 {frameUrl:"xx"...} 目标对象
    位置 数字 1 2 目标所在相似目标中的位置
    返回值 变量 ret ret 目标对象

# 查找目标

  • 描述:在页面中查找指定匹配条件的目标。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象
    匹配类型 字符串 "文本匹配" "文本匹配" 目标匹配类型
    匹配内容 字符串 "订单中心" 目标匹配的内容
    返回值 变量 ret ret 找到的目标对象,查找不到返回null

# 获取页面地址

  • 描述:获取指定页面的地址。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    返回值 变量 ret ret 页面地址

# 上传文件

  • 描述:在页面中上传文件,支持同时上传多个文件。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象
    文件路径 数组 [] ['c:/xx/file','d:/xx/file1'] 待上传的文件路径

# 滚动到目标

  • 描述:滚动页面至指定的目标处。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    目标 对象 {frameUrl:"xx"...} 目标对象

# 滚动页面

  • 描述:在页面中滚动指定的距离。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    滚动距离 数字 300 页面滚动的距离,单位:px

# 键盘按键

  • 描述:模拟键盘按键。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象
    按键名称 字符串 "Enter" 模拟的按钮名称

# 关闭页面

  • 描述:关闭指定浏览器标签页面。
  • 配置:
    类型 默认值 示例 描述
    页面 变量 page page1 页面对象

# 关闭浏览器

  • 描述:关闭指定浏览器。
  • 配置:
    类型 默认值 示例 描述
    浏览器 变量 browser browser1 浏览器对象

# excel

WARNING

注意:仅支持xlsx格式的文件操作,所有excel组件的操作都是在后台进行的无感操作。

# 创建excel文件

  • 描述:创建一个excel文件对象,需要调用保存excel文件组件才能真正创建。
  • 配置:
    类型 默认值 示例 描述
    返回值 变量 excel excel1 文件对象

# 打开excel文件

  • 描述:打开本地excel文件。
  • 配置:
    类型 默认值 示例 描述
    文件路径 字符串 "c:/path/file" excel文件路径
    返回值 变量 excel excel1 文件对象

# 保存excel文件

  • 描述:保存excel文件,文件被保存至默认的目录。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    表格名称 字符串 '新建XLSX工作表' "名称记录" 文件名称
    返回值 变量 ret ret 文件路径

# 查找工作表数据

  • 描述:在excel文件指定工作表中查找包含指定内容的单元格。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称
    查找内容 字符串 "老王" 查找的内容
    返回值 变量 ret ret 单元格坐标,如:'A1'

# 读取单元格

  • 描述:在excel文件指定工作表中读取指定单元格的数据。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称
    单元格 字符串 "A1" 读取的单元格
    返回值 变量 ret ret 单元格数据

# 读取行

  • 描述:在excel文件指定工作表中读取指定行的数据。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称
    行索引 数字 1 行的索引
    返回值 变量 ret ret 读取到的行数据

# 读取列

  • 描述:在excel文件指定工作表中读取指定列的数据。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称
    列索引 数字 1 列的索引
    返回值 变量 ret ret 读取到的列数据

# 写入行

  • 描述:在excel文件指定工作表中指定行中写入数据。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称
    行索引 数字 1 行的索引
    行数据 数组 [1,11] 写入的行数据

# 写入列

  • 描述:在excel文件指定工作表中指定列中写入数据。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称
    列索引 数字 1 列的索引
    列数据 数组 [1,11] 写入的列数据

# 写入区域

  • 描述:在excel文件指定工作表中指定区域上写入数据。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称
    开始区域 字符串 "A1" "B2" 开始写入的单元格
    区域数据 数组 [[1,2],[3,4]] 写入的数据,二维数组

# 删除行

  • 描述:在excel文件指定工作表中删除指定的行数据。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称
    行索引 数字 1 行的索引
    删除行数 数字 1 2 删除的行数

# 删除列

  • 描述:在excel文件指定工作表中删除指定的列数据。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称
    列索引 数字 1 列的索引
    删除列数 数字 1 2 删除的列数

# 插入行

  • 描述:在excel文件指定工作表中插入行数据。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称
    行索引 数字 1 行的索引
    行数据 数组 [1,11] 插入的行数据

# 插入列

  • 描述:在excel文件指定工作表中插入列数据。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称
    列索引 数字 1 列的索引
    列数据 数组 [1,11] 插入的列数据

# 合并拆分

  • 描述:在excel文件指定工作表中合并或拆分指定区域的单元格。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称
    区域 字符串 "A1:B1" 操作的区域
    操作 字符串 "合并" 操作的类型

# 编辑单元格

  • 描述:在excel文件指定工作表中指定单元格写入数据。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称
    单元格 字符串 "A1" 编辑的单元格
    单元数据 字符串 "老王" 写入的数据

# 新增工作表

  • 描述:在excel文件中新增工作表,存在同名的工作表则新增失败。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称

# 重命名工作表

  • 描述:在excel文件中重命名工作表,存在同名的工作表则重命名失败。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称
    新名称 字符串 "Sheet2" 工作表新名称

# 删除工作表

  • 描述:在excel文件中删除工作表。
  • 配置:
    类型 默认值 示例 描述
    表格实例 变量 excel excel1 文件对象
    工作表 字符串 "Sheet1" "Sheet1" 工作表名称

# 邮件

# 发送邮件

WARNING

注意:IPaaS流程中被归类到【基本命令 -> 其它】

  • 描述:向指定人员发送邮件,支持发送附件,需要发件邮箱开通smtp协议。
  • 配置:
    类型 默认值 示例 描述
    smtp地址 字符串 "smtp.xx.com" 发送邮箱的smtp地址
    授权码 字符串 "xxxxx" 发送邮箱的授权码,在邮箱管理后台查看
    发件人 字符串 "xx@qq.com" 发送人的邮箱
    收件人 字符串 "xx@qq.com,xx@sina.com" 收件人的邮箱,英文逗号分隔
    抄送人 字符串 "xx@qq.com,xx@sina.com" 抄送人的邮箱,英文逗号分隔
    邮件标题 字符串 "欢迎使用Aboter!" 邮件标题
    邮件内容 字符串 "您好,欢迎使用Aboter!" 邮件内容
    附件 数组 ['c:/file1','c:/file2'] 附件文件路径,支持多个附件。IPaaS流程中为url

# 数据处理

TIP

数据处理组件用于对流程执行过程中的数据进行处理。

# 字符串

# 合并字符串

  • 描述:两个字符串合并为一个字符串。
  • 配置:
    类型 默认值 示例 描述
    原字符串 字符串 "ab" 原字符串
    合并字符串 字符串 "cd" 待合并字符串
    合并位置 字符串 "右侧" "左侧" 合并的类型
    返回值 变量 ret ret 合并后的字符串

# 替换字符串

  • 描述:替换字符串中的指定字符串。
  • 配置:
    类型 默认值 示例 描述
    原字符串 字符串 "abcd" 原字符串
    被替换字符串 字符串 "cd" 被替换的字符串
    替换字符串 字符串 "ef" 替换的字符串
    返回值 变量 ret ret 替换后的字符串

# 截取字符串

  • 描述:截取字符串中指定位置的字符串。
  • 配置:
    类型 默认值 示例 描述
    原字符串 字符串 "abcd" 原字符串
    开始位置 数字 0 开始截取的位置
    结束位置 数字 5 结束截取的位置
    返回值 变量 ret ret 截取到的字符串

# 分割字符串

  • 描述:按指定分割符分割字符串。
  • 配置:
    类型 默认值 示例 描述
    原字符串 字符串 "abcd" 原字符串
    分割符 字符串 "," 分割符
    返回值 变量 ret ret 分割得到的数组

# 大小写转换

  • 描述:对字符串进行大小写转换。
  • 配置:
    类型 默认值 示例 描述
    原字符串 字符串 "abcd" 原字符串
    转换类型 字符串 "小写" "大写" 转换类型
    返回值 变量 ret ret 转换后的字符串

# 查找字符串

  • 描述:查找字符串中指定的字符串,未找到返回-1。
  • 配置:
    类型 默认值 示例 描述
    原字符串 字符串 "abcd" 原字符串
    查找字符串 字符串 "cd" 被查找的字符串
    返回值 变量 ret ret 找到的字符串索引位置

# 转化为数字

  • 描述:把字符串转化为数字,转化失败返回null。
  • 配置:
    类型 默认值 示例 描述
    原字符串 字符串 "1223" 原字符串
    返回值 变量 ret ret 转化后的数字

# 编码字符串

  • 描述:对字符串进行URI编码,一般用于编码url中的中文字符。
  • 配置:
    类型 默认值 示例 描述
    原字符串 字符串 "http://a.com/测试" 原字符串
    返回值 变量 ret ret 编码后的字符串

# 解码字符串

  • 描述:对字符串进行URI解码,一般用于解码被编码过的url。
  • 配置:
    类型 默认值 示例 描述
    原字符串 字符串 "http://a.com/%E6%B5%8B%E8%AF%95" 原字符串
    返回值 变量 ret ret 解码后的字符串

# 字符串长度

  • 描述:获取字符串的长度。
  • 配置:
    类型 默认值 示例 描述
    原字符串 字符串 "abcd" 原字符串
    返回值 变量 ret ret 字符串长度

# 数组

# 插入元素

  • 描述:在数组指定位置插入元素。
  • 配置:
    类型 默认值 示例 描述
    原数组 数组 ['a','b'] 原数组
    插入元素 任意 "c" 插入的元素
    插入位置 数字 0 插入的位置,插入尾部:-1
    返回值 变量 ret ret 插入后的数组

# 删除元素

  • 描述:在数组指定位置删除元素。
  • 配置:
    类型 默认值 示例 描述
    原数组 数组 ['a','b'] 原数组
    删除位置 数字 0 删除的位置,删除最后一个元素:-1
    返回值 变量 ret ret 删除后的数组

# 截取数组

  • 描述:在数组指定位置截取数组。
  • 配置:
    类型 默认值 示例 描述
    原数组 数组 ['a','b','c','d'] 原数组
    开始位置 数字 0 开始截取的位置
    结束位置 数字 1 结束截取的位置
    返回值 变量 ret ret 截取到的数组

# 合并数组

  • 描述:以指定的合并类型合并数组。
  • 配置:
    类型 默认值 示例 描述
    原数组 数组 ['a','b'] 原数组
    合并数组 数组 ['c','d'] 合并数组
    合并位置 字符串 "右侧" "左侧" 合并类型
    返回值 变量 ret ret 合并后的数组

# 查找数组

  • 描述:在数组中查找指定元素,未找到返回-1。
  • 配置:
    类型 默认值 示例 描述
    原数组 数组 ['a','b'] 原数组
    查找元素 数字/字符串 "b" 查找的元素
    返回值 变量 ret ret 元素索引位置

# 转化为字符串

  • 描述:按指定连接符将字符串类型的数组转化为字符串。
  • 配置:
    类型 默认值 示例 描述
    原数组 数组 ['a','b','c','d'] 原数组
    连接符 字符串 "," 连接符
    返回值 变量 ret ret 转化后的字符串

# 数组长度

  • 描述:获取数组的长度。
  • 配置:
    类型 默认值 示例 描述
    原数组 数组 ['a','b','c','d'] 原数组
    返回值 变量 ret ret 数组长度

# 数学

# 基础算术

  • 描述:基础算术:加减乘除。
  • 配置:
    类型 默认值 示例 描述
    左边数值 数字 1 左边的数值
    右边数值 数字 2 右边的数值
    算术类型 字符串 "加法" "乘法" 算术类型
    返回值 变量 ret ret 计算后的值

# 转化为字符串

  • 描述:数字转化为字符串。
  • 配置:
    类型 默认值 示例 描述
    原数值 数字 1 原数值
    返回值 变量 ret ret 转化后的字符串

# 保留小数

  • 描述:对数字进行保留小数位数处理。
  • 配置:
    类型 默认值 示例 描述
    原数值 数字 1.234 原数值
    小数位数 数字 2 保留的小数位数
    返回值 变量 ret ret 保留小数后的数值

# 四舍五入取整

  • 描述:对数字进四舍五入处理。
  • 配置:
    类型 默认值 示例 描述
    原数值 数字 1.3 原数值
    返回值 变量 ret ret 四舍五入后的数值

# 生成随机整数

  • 描述:生成一个指定区间的整数数值。
  • 配置:
    类型 默认值 示例 描述
    最小值 数字 0 1 最小值
    最大值 数字 10 100 最大值
    返回值 变量 ret ret 随机整数

# 时间

# 获取时间

  • 描述:获取指定类型的时间字符串。
  • 配置:
    类型 默认值 示例 描述
    时间类型 字符串 "完整时间" "年月日" 获取时间的类型
    返回值 变量 ret ret 时间字符串

# 设置时间

  • 描述:获取按指定规则设定的时间字符串。
  • 配置:
    类型 默认值 示例 描述
    时间 字符串 "1971-01-01" 时间字符串
    偏移量 数字 0 1 时间偏移量,负数表示过去的时间
    偏移单位 字符串 "年" "天" 时间偏移单位
    返回值 变量 ret ret 时间字符串

# 对比时间

  • 描述:比较两个时间。
  • 配置:
    类型 默认值 示例 描述
    左边时间 字符串 "1971-01-01" 左边时间字符串
    右边时间 字符串 "1972-01-01" 右边时间字符串
    比较运算符 字符串 "等于" "大于" 比较运算符
    返回值 变量 ret ret 比较结果,true/false

# 获取时间戳

  • 描述:获取当前时间戳。
  • 配置:
    类型 默认值 示例 描述
    返回值 变量 ret ret 时间戳,单位:毫秒

# 文件处理

# 通用文件

# 复制

  • 描述:复制本地文件或目录到指定目录。
  • 配置:
    类型 默认值 示例 描述
    复制类型 字符串 "文件" "目录" 复制的类型
    原路径 字符串 "c:/path/file" 待复制的文件或目录路径
    目标路径 字符串 "d:/path" 复制到的目标路径
    是否覆盖 字符串 "否" "是" 是否覆盖目标路径中同名的文件或目录

# 移动

  • 描述:移动本地文件或目录到指定目录。
  • 配置:
    类型 默认值 示例 描述
    移动类型 字符串 "文件" "目录" 移动的类型
    原路径 字符串 "c:/path/file" 待移动的文件或目录路径
    目标路径 字符串 "d:/path" 移动到的目标路径
    是否覆盖 字符串 "否" "是" 是否覆盖目标路径中同名的文件或目录

# 删除

  • 描述:删除本地文件或目录。
  • 配置:
    类型 默认值 示例 描述
    删除类型 字符串 "文件" "目录" 删除的类型
    删除路径 字符串 "c:/path/file" 待删除的文件或目录路径

# 创建目录

  • 描述:创建本地目录。
  • 配置:
    类型 默认值 示例 描述
    目录路径 字符串 "c:/path/dir" 待创建的目录路径

# 是否存在

  • 描述:是否存在指定路径上的文件或目录。
  • 配置:
    类型 默认值 示例 描述
    路径 字符串 "c:/path/file" 文件或目录路径
    返回值 变量 ret ret 是否存在,true/false

# 读取文件

  • 描述:读取指定路径的文件内容。不支持读取的文件返回乱码。
  • 配置:
    类型 默认值 示例 描述
    文件路径 字符串 "c:/path/file" 文件路径
    返回值 变量 ret ret 文件内容

# 写入文件

  • 描述:在指定路径的文件内写入内容。不支持写入的文件会写入失败。
  • 配置:
    类型 默认值 示例 描述
    文件路径 字符串 "c:/path/file" 文件路径
    写入内容 字符串 "欢迎使用Aboter!" 写入的内容
    写入方式 字符串 "追加" 写入的方式

# 查找内容

  • 描述:在指定路径的文件中查找内容。
  • 配置:
    类型 默认值 示例 描述
    文件路径 字符串 "c:/path/file" 文件路径
    查找内容 字符串 "您好" 查找的内容
    返回值 变量 ret ret 内容是否存在,true/false