全部产品
云市场

rpa3.ie

更新时间:2019-09-18 15:39:08

目录

发生变更的sdk

input

input(self, element, value, , index=1, parent_element=None, simulate=True, replace=False, timeout=10)
rpa.ie中
~~input(self, element, value,
, index=1, parent_element=None, simulate=True, timeout=10)~~
rpa3.ie中增加了replace参数,为true时将会替换输入框中已有的值,false则会追加输入,不同于旧版本中模拟输入时追加非模拟输入是覆盖写入。
输入

  • element : 控件名称(弹出框点击) <str>
  • index : 如果有多个控件,给出下标 <int>
  • value : 输入的内容 <str>
  • parent_elemet : 父控件对象 <str>
  • simulate : 是否模拟输入<bool>
  • replace: 是否清空之前的内容<bool>
  • timeout : 超时时间<int>
  1. #模拟覆盖输入"aa"
  2. page.input("控件名称", "aa", simulate=True, replace=True)
  3. #模拟追加输入"aa"
  4. page.input("控件名称", "aa") #简略的写法
  5. page.input("控件名称", "aa", simulate=True, replace=False)
  6. #非模拟覆盖输入"aa"
  7. page.input("控件名称", "aa", simulate=False, replace=True)
  8. #非模拟追加输入"aa"
  9. page.input("控件名称", "aa") #简略的写法
  10. page.input("控件名称", "aa", simulate=False, replace=False)

table

table(self, element, *, rtrtype=’text’, index=1, parent_element=None, timeout=10)
rpa.ie中
table(self, value, type=’index’, rtrtype=’text’, parent_element=None)
rpa3.ie中需要录制控件来获取对应的表格,相比于rpa中的在整个页面中通过关键字或者索引查找的方式,录制控件可以更快更准确的定位想要的表格
获取表格

  • element : 控件名称 <str>
  • rtrtype : ‘text’|’html’返回类型文本或者html <str>
  • index : 如果有多个,给出控件下标<int>
  • parent_elemet : 父控件对象 <str>
  • timeout : 超时时间<int>
    返回二维数组或html
  1. #获取表格文本内容
  2. result = page.table("控件名称")
  3. result = page.table("控件名称", rtrtype='text')
  4. #获取表格html
  5. result = page.table("控件名称", rtrtype='html')

alert

alert(self, value=’yes’, , element=None, index=1, parent_element=None, simulate=True, timeout=10)
rpa.ie中
~~alert(self, element, value=’yes’,
, index=1, parent_element=None,timeout=10)~~
rpa3.ie中 支持了页面中的弹出框处理,不只是针对主动点击按钮弹出的弹出框。支持的弹出框类型 alert/confirm
弹出框点击

  • element : 控件名称(弹出框点击) <str>
  • index : 如果有多个控件,给出下标 <int>
  • value : ‘yes’|’no’ 点确定或取消 <str>
  • parent_elemet : 父控件对象 <str>
  • timeout : 超时时间 <int>
  1. #处理点击按钮的弹出框
  2. #确认点击
  3. result = page.alert(element='控件名称')
  4. result = page.alert(element='控件名称',value='yes')
  5. #取消点击
  6. result = page.alert(element='控件名称',value='no')
  7. #处理页面中的弹出框
  8. #确认点击
  9. result = page.alert()
  10. result = page.alert(value='yes')
  11. #取消点击
  12. result = page.alert(value='no')

click

click(self, element, , index=1, parent_element=None, simulate=True, button=’left’, timeout=10)
rpa.ie中
~~click(self, element,
, index=1, parent_element=None, simulate=True, timeout=10)

rpa3.ie中
增加了参数button,可以设置左键还是右键,支持了右键点击的操作
点击

  • element : 控件名称 <str>
  • index : 如果有多个,给出控件下标<int>
  • parent_element : 父控件对象 <str>
  • button: ‘left’|’right’ 左键或右键 <str>
  • simulate : 是否模拟点击<bool>
  • timeout : 超时时间<int>
  1. #左键点击
  2. page.click("控件名称")
  3. page.click("控件名称", button='left')
  4. #右键点击
  5. page.click("控件名称", button='right')

option

option(self, element, text, , type=’match’, index=1, parent_element=None, clearSelected=False, timeout=10)
rpa.ie中
~~option(self, element, value,
, index=1, parent_element=None, type=’match’, timeout=10)~~
rpa3.ie中
增加了参数clearSelected,针对于多选的下拉框,可以清除已有的选择
下拉框选择

  • element : 控件名称(下拉框控件) <str>
  • value : 选择内容 <str>
  • index : 如果有多个,给出控件下标<int>
  • type : ‘match’|’full’|’regex’ 分表标识模糊匹配|完全匹配|正则匹配 <str>
  • parent_elemet : 父控件对象 <str>
  • clearSelected : 是否清空之前的选择(仅作用于多选时) <bool>
  • timeout : 超时时间<int>
  1. #单选
  2. page.option('控件名称','Sa')
  3. page.option('控件名称','Saab',type='full')
  4. page.option('控件名称','Saab',type='regx')
  5. #多选不清空原来的选择同上
  6. #多选清空原来的选择
  7. page.option('控件名称','Sa', clearSelected=True)
  8. page.option('控件名称','Saab',type='full', clearSelected=True)
  9. page.option('控件名称','Saab',type='regx', clearSelected=True)

新增的sdk

forward

forward(self, *, wait=True, timeout=10)
浏览器前进

  • wait : 是否等待页面加载完成 <bool>
  • timeout : 超时时间<int>
  1. page.forward()

executejs

executejs(self, code)
执行js代码

  • code: js代码 <str>
  1. #在页面弹出一个内容为"aa"的弹框
  2. result = page.excutejs("alert('aa')")

scroll

scroll(self, height, *, element=None, index=1, parent_element=None, timeout=10, direction=’top’)
滚动页面(传入控件则为设置控件内的滚动条)

  • height : 设置则滚动指定高度 <int>
  • element : 控件名称(弹出框点击) <str>
  • index : 如果有多个控件,给出下标 <int>
  • direction : 选择滚动条方向 left|top <str>
  • parent_elemet : 父控件对象 <str>
  • timeout : 超时时间 <int>
    返回True表示还能滚动,返回False表示已经滚到底
  1. #页面纵向滚动20像素
  2. result = page.scroll(20) #简略的写法
  3. result = page.scroll(20, direction='top')
  4. #页面横向滚动20像素
  5. result = page.scroll(20, direction='left')
  6. #控件纵向滚动20像素
  7. result = page.scroll(20, element='控件名称') #简略的写法
  8. result = page.scroll(20, element='控件名称', direction='top')
  9. #页面横向滚动20像素
  10. result = page.scroll(20, element='控件名称', direction='left')

get_scroll_height

get_scroll_height(self, *, element=None, index=1, parent_element=None, timeout=10)
获取纵向滚动条高度(传入控件则为设置控件内的滚动条)

  • element : 控件名称 <str>
  • index : 如果有多个控件,给出下标 <int>
  • parent_elemet : 父控件对象 <str>
  • timeout : 超时时间 <int>
    返回纵向滚动条高度
  1. #获取页面纵向滚动条高度
  2. result = page.get_scroll_height()
  3. #获取控件纵向滚动条高度
  4. result = page.get_scroll_height(element='控件名称')

get_scroll_width

get_scroll_width(self, *, element=None, index=1, parent_element=None, timeout=10)
获取横向滚动条高度(传入控件则为设置控件内的滚动条)

  • element : 控件名称 <str>
  • index : 如果有多个控件,给出下标 <int>
  • parent_elemet : 父控件对象 <str>
  • timeout : 超时时间 <int>
    返回横向滚动条高度
  1. #获取页面横向滚动条高度
  2. result = page.get_scroll_width()
  3. #获取控件横向滚动条高度
  4. result = page.get_scroll_width(element='控件名称')

option_by_index

option_by_index(self, element, item_index, *, index=1, parent_element=None, clearSelected=False, timeout=10)
通过下标下拉框选择

  • element : 控件名称(下拉框控件) <str>
  • item_index: 选项下标 <int>
  • index : 如果有多个,给出控件下标<int>
  • parent_elemet : 父控件对象 <str>
  • clearSelected : 是否清空之前的选择(仅作用于多选时) <bool>
  • timeout : 超时时间<int>
  1. #单选下拉第一个选项
  2. #多选不清空下拉第一个选项
  3. page.option_by_index('控件名称', 1)
  4. #多选清空原来的值并下拉第一个选项
  5. page.option_by_index('控件名称', 1, clearSelected=True)

get_options

get_options(self, element, *, mode=’all’, index=1, parent_element=None, timeout=10)
返回下拉框选中的值/所有的选项

  • element : 控件名称(弹出框点击) <str>
  • index : 如果有多个控件,给出下标 <int>
  • mode : selected|all <str>(selected|all)
  • parent_elemet : 父控件对象 <str>
  • timeout : 超时时间 <int>
    返回一个集合
  1. #返回所有选项的集合
  2. result = page.get_options('控件名称') #简略的写法
  3. result = page.get_options('控件名称', mode='all')
  4. #返回选中的值的集合(因为有多选的情况,统一返回集合)
  5. result = page.get_options('控件名称', mode='selected')

double_click

double_click(self, element, *, index=1, parent_element=None, timeout=10)
双击

  • element : 控件名称 <str>
  • index : 如果有多个,给出控件下标<int>
  • parent_elemet : 父控件对象 <str>
  • timeout : 超时时间<int>
  1. page.double_click('控件名称')

alert_message

alert_message(self)
获取弹出框消息

  1. result = page.alert_message()

screenshot

screenshot(self, element, file, *, index=1, parent_element=None, timeout=10)
截图

  • element : 控件名称 <str>
  • file : 保存的截图路径 <str>
  • index : 如果有多个,给出控件下标 <int>
  • parent_elemet : 父控件对象 <str>
  • timeout:超时时间<int>
  1. page.screenshot('控件名称',r'D:\aaa.jpg')

drag

drag(self, element, *, x=None, y=None, index=1, parent_element=None,
timeout=10)
将元素拖拽到指定的位置

  • element : 控件名称 <str>
  • index : 如果有多个,给出控件下标 <int>
  • x : x轴偏移量 <int>
  • y : y轴偏移量 <int>
  • parent_elemet : 父控件对象 <str>
  • timeout:超时时间<int>
  1. page.drag('控件名称')

css

css(self, css, *, index=1, parent_element=None, timeout=10)
通过css获取对象

  • element : 控件名称 <str>
  • css : 控件css表达式 <str>
  • index : 如果有多个,给出控件下标 <int>
  • parent_elemet : 父控件对象 <str>
  • timeout:超时时间<int>
    返回控件对象
  1. #通过css获取百度一下按钮控件
  2. element_obj = page.css('input#su.bg.s_btn')

attr

attr(self, element, name, *, index=1, parent_element=None, timeout=10)
获取属性

  • element : 控件名称 <str>
  • name : 属性名 <str>
  • index : 如果有多个,给出控件下标 <int>
  • parent_elemet : 父控件对象 <str>
  • timeout:超时时间<int>
  1. #获取控件的value
  2. result = page.attr()

in_view

in_view(self, element, *, index=1, parent_element=None, timeout=10)
控件是否在可见区域

  • element : 控件名称 <str>
  • index : 如果有多个,给出控件下标 <int>
  • parent_elemet : 父控件对象 <str>
  • timeout:超时时间<int>
  1. result = page.in_view('控件名称)

scroll_into_view

scroll_into_view(self, element, index=1, parent_element=None,timeout=10)
滚动控件到可视区域

  • element : 控件名称 <str>
  • index : 如果有多个,给出控件下标 <int>
  • parent_elemet : 父控件对象
  • timeout:超时时间 <int>