迈容插件版IDE-API描述总览

本文档是对插件版IDE用到的所有API进行文档型描述。本处提到的API是指迈容公司基于python自动化进行的二次封装,目的是方便使用者直接调用函数,函数简单易用。

操作系统支持度

自动化范围 是否支持
window7、8、10
linux

自动化范围

自动化范围 包名称 归属 描述
系统应用 rpa.system 操作系统 打开操作系统的命令等
对话框 rpa.dialog 操作系统 生成对话框界面,用于提示或者用户交互等
鼠标 rpa.mouse 鼠标 控制鼠标进行操作等
键盘 rpa.keyboard 键盘 控制键盘进行输入操作等
剪贴板 rpa.clipboard 操作系统 调用操作系统的剪贴板命令等
浏览器 rpa.webdriver 浏览器 通过webdriver控制浏览器进行自动化操作等
新浏览器 rpa.page 新浏览器 通过playwright控制浏览器进行自动化操作等
识图 rpa.picture 识图 通过识图方式进行自动化操作等
安卓 rpa.android 安卓 控制安卓手机进行自动化操作等
通用文件 rpa.commonfile 通用文件 对文件进行操作等
INI格式 rpa.ini INI格式 对INI格式文件进行操作等
CSV格式 rpa.csvfile CSV格式 对CSV格式文件进行操作等
PDF格式 rpa.pdf PDF格式 对PDF格式文件进行操作等
Word文档 rpa.word Word文档 对Word文档进行操作等
Excel表格 rpa.excel Excel表格 对Excel表格进行操作等
网络设备 rpa.net 网络设备 获取网络设备的信息等
HTTP rpa.httpclient HTTP 进行HTTP请求操作等
SMTP/POP rpa.smtp SMTP/POP 通过SMTP/POP对邮件进行操作等
FTP rpa.ftp FTP 对ftp进行操作等
数据库 rpa.db 数据库 对数据库进行增删改查操作等
json rpa.mrjson json 对json进行数据解析操作等
字符串 rpa.mrstr 字符串 对字符串类型进行数据解析操作等
正则表达式 rpa.reg 正则表达式 使用正则表达式进行操作等
数字 rpa.mrmath 数字 进行数学运算操作等
时间 rpa.mrtime 时间 处理日期和时间操作等
二维码 rpa.mrqrcode 二维码 进行识别二维码和生成二维码操作等
解析html rpa.parseHtml 解析html 解析html并进行处理操作等

 

系统应用(1000)

对话框(2000)

鼠标(3000)

键盘(4000)

剪贴板(5000)

浏览器(6000)

新浏览器(7000)

win32(8000)

识图(9000)

安卓(10000)

通用文件(11000)

INI格式(12000)

CSV格式(13000)

PDF格式(14000)

Word文档(15000)

Excel表格(16000)

网络设备(17000)

HTTP(18000)

SMTP/POP(19000)

FTP(20000)

数据库(21000)

json(22000)

字符串(23000)

正则表达式(24000)

数字(25000)

时间(26000)

二维码(27000)

解析html(28000)

......


API详细介绍


rpa.system.uname

获取操作系统当前用户

rpa.system.cmdExe

打开应用或命令窗口

rpa.system.environ

获取环境变量信息,并返回环境变量值

rpa.system.environGet

读取某环境变量

rpa.system.getcwd

获取当前工作目录并返回值

rpa.system.system

关闭指定的应用程序

rpa.system.voice

播放指定路径下的音频文件

rpa.system.rectCapturePlus

屏幕截图

rpa.system.lockScreen

锁屏

rpa.system.inputMethodJudgment

判断当前输入法

rpa.system.setInputer

切换输入法


rpa.dialog.msgbox

创建一个提示框

rpa.dialog.enterbox

创建一个单行输入框.

rpa.dialog.passwordbox

创建一个单行密码输入框

rpa.dialog.multenterbox

创建一个多行输入框

rpa.dialog.multpasswordbox

创建一个登录框

rpa.dialog.diropenbox

返回用户选择的目录名(带完整路径),如果用户选择“Cancel”则返回None

rpa.dialog.fileopenbox

从指定目录打开文件

rpa.dialog.filesavebox

保存文件到指定目录

rpa.dialog.choicebox

创建一个列表选择框


rpa.mouse.click

执行鼠标点击操作.

rpa.mouse.moveTo

鼠标移动到指定位置.

rpa.mouse.moveRel

鼠标从上一位置移动到指定位置,相对移动.

rpa.mouse.position

获取鼠标当前所在位置,返回一个(x,y)坐标

rpa.mouse.dragTo

鼠标从当前位置拖动到指定位置

rpa.mouse.scroll

鼠标滑轮移动的距离


rpa.keyword.typewrite

键盘输入数字、字母...

rpa.keyword.hotkey

键盘输入组合键,其中输入的参数为需要键入的组合键内容

rpa.keyword.press

键盘输入单个按键内容,参数为要输入的按键


rpa.clipboard.copy

复制内容到剪切板

rpa.clipboard.paste

从剪切板粘贴

rpa.clipboard.copyImg

复制图片

rpa.clipboard.pasteImg

粘贴图片


rpa.webdriver.create

创建并启动一个浏览器

rpa.webdriver.bind

绑定已启动地浏览器

rpa.webdriver.get

打开浏览器网页

rpa.webdriver.quitOrClose

退出或关闭当前浏览器

rpa.webdriver.explicitWait

设置获取元素时需要等待的时间

rpa.webdriver.parseHtml

获取当前浏览器页面的网页源码

rpa.webdriver.executeJs

执行 js 脚本

rpa.webdriver.setCookie

设置当前浏览器页面的 cookie 中的参数值

rpa.webdriver.getCookie

获取当前 cookie 并返回 cookie 值

rpa.webdriver.refresh

刷新当前浏览器页面

rpa.webdriver.findElement

定位元素,并返回会获取到的元素值

rpa.webdriver.findElements

定位多个元素,并返回会获取到的元素值

rpa.webdriver.operElement

元素触发处理

rpa.webdriver.toFrame

切换iframe并返回切换到的iframe

rpa.webdriver.parentFrame

切换到上一个iframe,并返回iframe值

rpa.webdriver.submit

表单提交

rpa.webdriver.scrollIntoView

滚动至元素处

rpa.webdriver.scroll

网页向左右或上下滚动

rpa.webdriver.elementDrag

元素拖动

rpa.webdriver.elementDragByOffset

元素偏移拖动

rpa.webdriver.maxOrMin

浏览器窗口最大或最小化

rpa.webdriver.getWindowHandle

获取当前浏览器窗口并返回

rpa.webdriver.getAllWindowHandle

获取所有窗口

rpa.webdriver.changeWindow

切换到下一个窗口

rpa.webdriver.changeAssignWindow

切换到指定窗口

rpa.webdriver.changeEndWindow

切换到最后一个窗口

rpa.webdriver.closeOtherWindow

关闭其他窗口

rpa.webdriver.forwardOrBack

浏览器页面前进或后退

rpa.webdriver.screenShot

截取当前浏览器图片,并返回图片存放路径

rpa.webdriver.elementScreenshot

浏览器元素截图

rpa.webdriver.getAlert

获取弹窗

rpa.webdriver.textAlert

获取弹窗内容

rpa.webdriver.acceptAlert

点击弹窗确认

rpa.webdriver.sendkeysAlert

输入数据至弹窗

rpa.webdriver.dismissAlert

弹窗取消


rpa.page.create

创建一个浏览器页面并返回上下文在后续的启动浏览器中对上下文操作

rpa.page.newPage

选择启动浏览器类型,并创建page对象

rpa.page.goPage

在创建的浏览器页面里打开一个新网页

rpa.page.locator

在打开的页面中根据Xpath定位元素

rpa.page.waitUtil

等待元素加载

rpa.page.handle

对定位的元素执行操作,参数"operation"为操作属性

rpa.page.swtichFrame

定位网页iframe

rpa.page.executeJs

执行js脚本

rpa.page.keyboardType

通过键盘在网页输入指定字符串

rpa.page.keyboardPress

键入键盘按键

rpa.page.mouseClick

通过鼠标点击指定坐标位置

rpa.page.mouseDbclick

通过鼠标双击指定坐标位置

rpa.page.mouseMove

将鼠标移动到指定位置

rpa.page.mouseWheel

鼠标滚动到指定坐标位置

rpa.page.screenShot

浏览器页面截图

rpa.page.dialog

对话框操作

rpa.page.reload

刷新页面

rpa.page.getPageSource

获取并返回网页源码

rpa.page.close

关闭当前网页

quit

退出当前打开的浏览器


rpa.window.get

指定操作窗口

rpa.window.setActive

设置活动窗口

rpa.window.visiblity

窗口隐藏/显示

rpa.window.isExist

窗口是否存在

rpa.window.getSize

获取窗口大小

rpa.window.minMax

窗口最大化/最小化

rpa.window.reSize

窗口调整

rpa.window.top

窗口置顶

rpa.window.pid

获取进程PID

rpa.window.close

关闭窗口

rpa.window.findControl

查找指定元素

rpa.window.getChildren

获取子元素

rpa.window.getParent

获取父元素

rpa.window.oper

元素指定操作

rpa.window.operControlIsExist

判断元素是否存在

rpa.window.getAttribute

获取元素特征


rpa.picture.moveTo

鼠标移动至图像

rpa.picture.findAndClick

识别并点击图像

rpa.picture.findAndDrag

识别并拖动图像

rpa.picture.compare

图像对比


rpa.android.list

查看连接设备

rpa.android.connect

查看手机设备连接并在终端输出一个手机序列号

rpa.android.deviceInfo

获取手机信息

rpa.android.deviceDetailInfo

获取手机详细信息

rpa.android.deviceSerial

获取手机序列号

rpa.android.closeConnect

关闭手机连接

rpa.android.startApp

启动APP

rpa.android.closeApp

关闭APP

rpa.android.restart

重启手机

rpa.android.close

关闭手机

rpa.android.getElement

获取元素对象

rpa.android.touch

点击元素

rpa.android.input

输入信息至元素

rpa.android.clear

清除元素内容

rpa.android.text

获取元素文本

rpa.android.touchSlide

触摸滑动

rpa.android.clickKey

键盘按键

rpa.android.capture

屏幕截图

rpa.android.clickScreen

点击屏幕

rpa.android.getClipboardContent

获取剪切板内容

rpa.android.setClipboardContent

设置剪切板内容

rpa.android.getScreenDirection

获取屏幕方向

rpa.android.getUITree

获取UI树

rpa.android.pushFile

推送文件至手机

rpa.android.getFile

获取文件从手机


rpa.commonfile.openFile

打开普通文件

rpa.commonfile.read

读取文件

rpa.commonfile.write

写入字符串到文件对象中

rpa.commonfile.addwrite

不改变原文件文本,追加文本写入文件

rpa.commonfile.close

关闭文件

rpa.commonfile.getName

获取文件名称

rpa.commonfile.getExtension

获取文件扩展名

rpa.commonfile.dirname

获取文件路径

rpa.commonfile.getsize

获取文件大小

rpa.commonfile.getdirsize

获取文件夹大小

rpa.commonfile.copy

复制文件并粘贴到另一目录

rpa.commonfile.copyFolder

复制文件夹并粘贴到另一目录

rpa.commonfile.move

移动文件或文件夹到指定目录

rpa.commonfile.rename

重命名文件或文件夹

rpa.commonfile.rmdir

删除指定文件

rpa.commonfile.removedirs

删除指定目录

rpa.commonfile.mkdir

创建目录

rpa.commonfile.makedirs

递归创建目录

rpa.commonfile.exists

判断文件/文件夹是否存在

rpa.commonfile.isfile

判断路径是否为文件

rpa.commonfile.isdir

判断路径是否为文件夹

rpa.commonfile.listdir

获取文件或文件夹列表

rpa.commonfile.lookup

查找指定路径下的文件

rpa.commonfile.mkZip

将指定文件压缩成ZIP文件

rpa.commonfile.decZip

将ZIP文件解压到指定目录

rpa.commonfile.getLastedFile

获取目录中最新日期文件

rpa.commonfile.printFile

文件打印


rpa.ini.read

读取INI文件

rpa.ini.getSections

获取INI文件所有Sections

rpa.ini.getOptions

获取指定section下的options

rpa.ini.getkeys

枚举指定section下所有的option与value

rpa.ini.getValue

获取指定section与option的value值

rpa.ini.removeOption

删除指定option

rpa.ini.removeSection

删除指定section

rpa.ini.addSection

增加section

rpa.ini.setKeyValue

重新设置INI文件中的Section与Option的value

rpa.ini.write

追加写入文件,对ini文件做出修改后,需追加写入文件才可生效。


rpa.csvfile.reader

读取csv文件

rpa.csvfile.lineNum

读取csv行数

rpa.csvfile.writer

csv文件写入器

rpa.csvfile.writerRow

csv写入一行

rpa.csvfile.writerRows

csv写入多行

rpa.csvfile.dictReader

csv字典读取

rpa.csvfile.dictWriter

csv字典写入


rpa.pdf.getPageCount

获取PDF总页数

rpa.pdf.setPageToImage

将PDF文件中指定页另存为图片

rpa.pdf.getTextOnPage

获取指定页文本

rpa.pdf.mergePDF

合并PDF

rpa.pdf.assignSplitPdf

拆分指定页PDF

rpa.pdf.splitPdf

按页拆分PDF


rpa.word.create

创建word对象

rpa.word.getParagraphs

获取所有段落对象

rpa.word.getParagraphText

获取段落文本

rpa.word.addHead

添加标题

rpa.word.addParagraph

添加内容

rpa.word.addPic

添加图片

rpa.word.addTable

添加表格

rpa.word.addTableContext

添加表格内容

rpa.word.addTableContexts

指定表格追加多行内容

rpa.word.save

文档保存

rpa.word.updateFormat

更新样式

rpa.word.replaceChar

关键字替换

rpa.word.wordTurnPdf

Word转PDF


rpa.excel.xls2xlsx

xls转xlsx

rpa.excel.get_excel_object

获取Excle对象

rpa.excel.create_excel_object

创建Excle对象

rpa.excel.save

保存Excle工作簿

rpa.excel.create_sheet

新建sheet表

rpa.excel.get_sheetnames

获取所有sheet名

rpa.excel.get_sheet

获取sheet表对象

rpa.excel.remove_sheet

删除sheet表

rpa.excel.copy_sheet

复制sheet表

rpa.excel.title_sheet

修改sheet表名称

rpa.excel.get_cell

读取单元格

rpa.excel.get_cell_value

读取单元格数据

rpa.excel.get_rows_value

读取单元格行数据

rpa.excel.get_columns_value

读取单元格列数据

rpa.excel.get_all_value

读取所有单元格数据

rpa.excel.get_area_value

读取指定区域单元格数据

rpa.excel.set_cell

设置单元格数据

rpa.excel.append

插入行数据

rpa.excel.insert_cols

插入空列

rpa.excel.insert_rows

插入空行

rpa.excel.delete_rows

删除行

rpa.excel.delete_cols

删除列

rpa.excel.move_range

移动单元格

rpa.excel.freeze_panes

冻结窗口

rpa.excel.set_filter

添加筛选器

rpa.excel.set_font

修改字体样式

rpa.excel.get_font

获取字体样式

rpa.excel.set_alignment

设置对齐样式

rpa.excel.cell_side

边框样式

rpa.excel.set_side_style

设置边框样式

rpa.excel.set_pattern_fill

设置填充样式

rpa.excel.set_gradient_fill

设置填充渐变样式

rpa.excel.set_row_dimensions

设置行高

rpa.excel.set_column_dimensions

设置列宽

rpa.excel.merge_cells

合并单元格

rpa.excel.unmerge_cells

取消合并单元格


rpa.net.getMacAddress

获取主机的MAC地址

rpa.net.getHostName

获取主机名

rpa.net.getIPv4Address

获取主机IPv4地址

rpa.net.getIPv6Address

获取主机IPv6地址


rpa.httpclient.doGet

通过GET请求获取数据

rpa.httpclient.doPost

通过POST请求提交表单

rpa.httpclient.upload

通过POST请求提交表单

rpa.httpclient.doPut

通过PUT请求获取数据

rpa.httpclient.doDelete

通过Deleat请求获取数据

rpa.httpclient.doHead

通过Head请求获取数据

rpa.httpclient.doOptions

通过Options请求获取数据


rpa.smtp.send

发送邮件

rpa.smtp.connect

连接邮箱

rpa.smtp.disconnect

断开邮箱连接


rpa.ftp.connectFTPServer

连接FTP服务器

rpa.ftp.mkd

在连接到的服务器当中创建文件夹

rpa.ftp.nlst

列举远程目录下的内容

rpa.ftp.exists

判断远程文件是否存在

rpa.ftp.downloadFile

从服务器下载指定文件并保存

rpa.ftp.uploadFile

从本地上传文件至远程服务器

rpa.ftp.delete

从远程服务器删除文件

rpa.ftp.quit

关闭远程服务器连接


rpa.db.connect

连接数据库

rpa.db.query

SQL查询

rpa.db.update

SQL插入更新

rpa.db.delete

SQL删除

rpa.db.batch

SQL批量执行

rpa.db.commit

提交

rpa.db.rollback

回滚

rpa.db.close

关闭连接


rpa.mrjson.loads

将JSON字符串转换为对象并返回JSON对象

rpa.mrjson.dumps

将JSON对象转换为JSON字符串并返回JSON字符串

rpa.mrjson.fromFile

读取JSON文件并将读取到的文件转换为JSON对象

rpa.mrjson.toFile

对象保存至JSON文件


rpa.mrstr.capitalize

将字符串首字符转换为大写,并返回转换后的值

rpa.mrstr.casefold

将字符串全部转换为小写并返回转换后的值

rpa.mrstr.count

返回某个字符在字符串中出现的次数

rpa.mrstr.encode

以指定的格式编码字符串

rpa.mrstr.endswith

判断字符串的结尾是否为指定值

rpa.mrstr.index

在字符串中搜索指定值

rpa.mrstr.isalnum

判断字符串中是否全部是字母或数字

rpa.mrstr.isalpha

判断字符串中所有字符是否都在字母表中

rpa.mrstr.isdecimal

判断字符串中所有字符是否都是十进制字符

rpa.mrstr.isdigit

判断字符串中所有字符是否为整数

rpa.mrstr.isidentifier

判断字符串中所有字符是否为标识符

rpa.mrstr.islower

判断字符串中所有字符是否都是小写

rpa.mrstr.isnumeric

判断字符串中所有字符是否都是数字

rpa.mrstr.isprintable

判断字符串中所有字符是否都可打印

rpa.mrstr.isspace

判断字符串中所有字符是否都是空格

rpa.mrstr.isupper

判断字符串中所有字符是否都是大写

rpa.mrstr.lower

将字符串转换为小写

rpa.mrstr.replace

替换指定字符串

rpa.mrstr.split

在指定的分隔符处拆分字符串

rpa.mrstr.startswith

判断字符串是否以指定值开头

rpa.mrstr.swapcase

交换大小写,小写变成大写,反之亦然

rpa.mrstr.upper

将字符串转换为大写


rpa.reg.find

正则表达式查找子串

rpa.reg.findall

正则表达式查找全部子串

rpa.reg.sub

正则表达式替换


rpa.mrmath.constant

生成一个数学常量

rpa.mrmath.base

进行加减乘除等基本运算

rpa.mrmath.pow

进行进制转化

rpa.mrmath.common

通用函数

rpa.mrmath.expLog

幂/对数函数

rpa.mrmath.trigonometric

三角函数

rpa.mrmath.degree

角度转换

rpa.mrmath.hyperbolic

双曲函数

rpa.mrmath.getRounding

特殊函数

rpa.mrmath.randomfunc

随机函数

rpa.mrmath.convert

数值转化


rpa.mrtime.getStamp

获取当前时间戳

rpa.mrtime.getTimes

获取当前时间

rpa.mrtime.the_other_day

获取T+n的时间

rpa.mrtime.getDate

获取当前日期

rpa.mrtime.fromatTime

格式化时间

rpa.mrtime.getYear

获取年份

rpa.mrtime.getMonth

获取月份

pa.mrtime.getDay

获取当前是每个月第几天

rpa.mrtime.getHour

获取当前小时数

rpa.time.getMinute

获取当前分钟数

rpa.time.getSeconds

获取当前秒数

rpa.time.getWeek

获取今天是本周第几天

rpa.mrtime.difference

计算两个时间差

rpa.mrtime.differ_day

计算天数差(取绝对值)

rpa.mrtime.strToTime

字符串转时间格式


rpa.mrqrcode.identifyqrcode

识别二维码图片

rpa.mrqrcode.createqrcode

生成二维码图片


rpa.parseHtml.getHtmlObj

获取并返回html对象

rpa.parseHtml.getTables

解析html并返回表格列表

rpa.parseHtml.getImages

提取图片数据

rpa.parseHtml.downloadImg

解析html并下载图片数据