1 功能说明

【鼠标点击】：模拟真实的鼠标点击事件

注： 

（1）支持自动识别应用或系统类型进行鼠标点击操作 

（2）支持多种拾取模式的任意切换 

（3）支持鼠标按键、位置、偏移等参数设置 

（4）支持属性的容错设置

2 基本使用说明

1) 点击组件右上角的按钮拾取，完成控件拾取操作。

2）点击拾取后，设计器首先会最小化，并切回上一次操作的应用程序界面。

3）当鼠标在界面移动时即会出现蓝色拾取框，将鼠标悬浮在需要操作的界面元素上，出现蓝色框后，在蓝框中点击“鼠标左键”，即完成拾取。

注：一般情况下，拾取器会自动识别拾取控件所在的应用或系统类型，如有不准确可通过快捷键手动切换拾取模式。

4）拾取完成后，自动切换回设计器界面，可视化组件的右侧即显示有关该控件的一系列属性，出现这些属性即代表拾取成功。

5) 点击属性中的图片预览，查看拾取的元素图片以及鼠标位置是否正确。

3 参数配置说明

拾取过程中，会在屏幕的左上角或右下角会显示拾取的相关设置，这是拾取类组件的通用设置。

3.1 拾取设置

拾取器应用于多层的悬浮菜单，拾取过程中，便会在屏幕的左上角或右下角会显示拾取的相关设置，一般情况下不需要开发者关注应用或系统类型，自动拾取方式即可，如不准确时，可自行切换其他拾取模式。

具体请见【拾取设置】章节。

3.2 通用属性

通用属性是组件一般都具有的参数属性，包括延时、备注以及等待等参数属性。

注：“消息模式”为【鼠标点击】组件专有参数属性。

• “前置延时”参数 用以设置组件功能执行之前等待的时间，单位为ms。

• “后置延时”参数 用以设置组件功能执行后等待的时间，单位为ms。

• “备注”参数 可对组件进行备注说明，易于理解，方便查找定位。

• “等待”参数 用以设置组件功能执行的时间。在这段时间内，组件功能会一直重复执行，直至执行成功，才会停止执行，继续执行下一个组件或步骤流程；等待时间内均未执行成功，组件便停止执行并抛出异常（个别组件执行失败也不会抛出异常，例如【获取文本】组件未找到元素返回为空。

• 消息模式”参数 （1）不勾选消息模式：执行过程中先激活窗口，再进行鼠标点击； （2）勾选消息模式：不会进行页面激活点击，通过后台请求消息的发送与接收，由后台实现控件点击

3.3 输入属性

用以设置组件执行方式的参数属性。

• “鼠标按键”参数 设置鼠标点击的按键位置，支持左键、右键、中间键。

• "位置"参数 设置所点击的控件元素中，鼠标的初始位置,支持中间、左上、左下、右上、右下。

注：如默认为中间时，图片预览图中，鼠标位置在中间

如选择右下，图片预览图中，鼠标位置即为右下

• “X/Y轴偏移”参数 如果点击的目标位置不在上述“位置参数”的五点中，则可以通过设置x轴、y轴偏移来点击目标位置。在设定的位置（上述“位置”参数）的基础上设置x轴、y轴偏移： 鼠标向右为正，向左为负，向下为正，向上为负。

       注： 如设置鼠标向左偏移100，查看预览图，鼠标位置相应改变

• “按键次数”参数 设置鼠标快速连续点击次数，默认为1次。

注：当涉及界面文本信息搬运，无法使用获取文本拾取元素时，可采用这种鼠标连续点击多次，全选文本，再进行拷贝的方式

• “操作异常时”参数 组件执行过程中，设置异常处理的方式。

（1）默认为“中断”：执行过程中遇到错误，流程中断并抛出异常； 如图中，执行错误则中断流程，不会继续执行后面的【输出】组件。 

（2）选择“继续”，则在执行过程中即使遇到错误，流程也会继续执行之后的步骤。 如图中，执行错误也会继续执行后面的【输出】组件。 

• “ScrollIntoView”参数 从2020.2.0版本开始，组件开启了智能滚动页面，该参数便是用以设置查找与滚动的顺序(默认勾选“窗口标题”，窗口被激活的情况下）

（1）默认不勾选ScrollIntoView： 先查找所拾取元素，若是元素不在当前页面，便进行滚动调整，然后进行点击。

 （2）勾选ScrollIntoView： 无论拾取的元素是否在当前页面前端呈可见状态，执行功能时页面均会先自动滚动调整，将所拾取的元素滚动到页面最顶部呈可见状态，最后进行点击操作

• “是否开启缩放”参数
  当使用Java拾取或者区域拾取时，提供该参数用以确保在不同桌面缩放比的情况下能够准确点击目标元素。

  

  （1）默认开启缩放。此时在桌面缩放比不为100%的情况下也能准确点击到目标位置

  （2）若选择关闭缩放，在桌面缩放比不为100%的情况下使用Java拾取和区域拾取可能会导致点击不准确的情况。

3.4 目标属性

所拾取控件的参数属性如下。

• “窗口标题”参数 记录控件所在的窗口的标题信息。 勾选上则表示在操作该步骤前会进行激活窗口的操作，如去掉勾选，则不会进行窗口激活的操作。 执行过程中，要是窗口标题发生变化导致激活窗口正常执行，可以直接去掉变化的部分，保留标题连续的一段。

注：如果流程当中需要来回的切换不同的页面或系统，建议勾选“窗口标题”，如果流程中多个操作都在一个页面中完成，可以去掉勾选“窗口标题”。

• “标签名”参数 记录拾取的控件在网页html信息中的标签名。

• “查找路径”参数 记录该控件在网页html信息中的层级关系，下拉选项中，每一种都表示元素的selector属性，可任意选择一种进行定位元素。

点击按钮，进入selector编辑器，界面如下。

selector编辑器能捕捉当前页面Dom树供查看浏览，可以对selector进行搜索或自定义等。支持IE、Chrome、Firefox三种浏览器。

• “网址”参数 记录当前拾取元素所在窗口的网址信息，执行过程中，要是网址发生变化导致无法正常执行，可以用通配符 * 代替变化的部分。

• 上述属性中，所有参数均可通过变量来替代使用

• 设置完相应参数成后，运行组件，鼠标则自动点击指定元素位置。成功模拟人的鼠标点击动作，接  着执行后续操作。

4 进阶操作

【鼠标点击】实则分为两步：1）激活窗口；2）鼠标点击。 

其中： 激活窗口与“窗口标题”和“网址”参数有关； 定位元素与“查找路径”参数有关。

4.1 准确激活指定窗口

（1）窗口标题 属性的容错机制是：Sub（包含）方式，将窗口标题中变化的部分删除，使其结果包含于原来的一部分

【示例】例如打开QQ邮箱，在首页拾取“写信”按钮。

此时查看“窗口标题”参数。

首次运行流程，鼠标可成功点击到。

当再次运行流程时，未激活窗口导致报错 。

原因：当再次拾取后，可以看到“窗口标题”参数发生了改变。

比之之前多了“写信”二字。

处理：去掉变化的部分，保留标题连续且不会变化的一段。 例如将后面的“写信 - Internet Explorer”删除。

（2）网址 当窗口激活失败，也可能因为网址发生变化 属性的容错机制是：针对网址中变化的部分，用通配符*替代

【示例】首次打开邮箱，“网址”如下所示。

当重新打开后，“网址”变为下图所示。

原因：发现每次重新打开邮箱，“sid”后面部分会发生变化。

处理：将“sid”后面变化部分用*替代。

做好上述两个容错，以确保每次运行流程，准确激活指定窗口

4.2  准确定位指定元素

当元素定位失败，可能因为查找路径有误或发生变化。 属性的容错机制是：针对查找路径会发生变化的，下拉选项中，任意选择一个固定不变的selector属性来定位元素

针对查找路径有误的，可根据selector编辑器重新搜索或自定义,以确定正确的查找路径来定位元素（略）

【示例】

1.  例如打开163邮箱登录界面，在页面拾取“用户名”输入框。

2. 首次运行流程，鼠标可成功点击到，其中“查找路径”为：'#auto-id-1590649348568。

3. 当刷新页面后，再次运行流程时，可成功激活页面，但是定位元素失败导致报错。

错误原因：刷新或重新打开页面，目标控件的默认查找路径发生了改变。当再次拾取，可以注意到查找路径变为：'#auto-id-1590649406991'。

处理方法：下拉选项中，任意选择一个固定不变的selector属性来定位。

例如选择第三个selector属性，运行流程后，即可成功点击输入框。