【鼠标】点击OCR文本

栏目：云苍穹知识作者：金蝶来源：金蝶云社区发布：2024-09-23浏览：1

【鼠标】点击OCR文本

1 功能说明

通过设置关键字，在拾取的目标区域中查找含有关键字的元素并实现点击。

注：

（1）支持对鼠标的按键位置、按键次数的设置；

（2）适用场景：适用于【鼠标点击】组件不支持抓取的C/S客户端中界面元素的点击。

1、点击组件右上角的拾取按钮，完成目标拾取操作：

2、点击拾取后，设计器首先会最小化，并切回上一次操作的应用程序界面（本例使用钉钉客户端）

3、当鼠标在界面移动时即会出现蓝色拾取框，将鼠标悬浮在需要操作的界面区域上，出现蓝色框后，在蓝框中点击“鼠标左键”，就完成了目标区域的拾取

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

5、在右侧属性“目标文本”中设置想要点击目标元素中包含的文本内容，并设置点击的其他相关属性6、组件运行时，会根据设置的目标文本，查找拾取的目标控件中包含目标文本的界面元素，并根据组件属性进行筛选点击。

注：

（1） “目标文本”为必填属性项；

（2）根据“目标文本”属性中的文本，查找到并默认进行点击包含此文本的整个控件，默认点击的是控件的中间位置，可修改点击位置；

（3）根据“目标文本”属性中的文本，查找到包含此文本的整个控件，可通过设置x/y轴偏移进行其他目标界面元素的点击，例如没有文本信息的图标。

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

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

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

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

“前置延时”参数
用以设置组件功能执行之前等待的时间，单位为ms。
“后置延时”参数
用以设置组件功能执行后等待的时间，单位为ms。
“备注”参数
可对组件进行备注说明，易于理解，方便查找定位。
“等待”参数
用以设置组件功能执行的时间。在这段时间内，组件功能会一直重复执行，直至执行成功，才会停止执行，继续执行下一个组件或步骤流程；等待时间内均未执行成功，组件便停止执行并抛出异常（个别组件执行失败也不会抛出异常，例如【获取文本】组件未找到元素返回为空。

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

“鼠标按键”参数
设置鼠标点击的按键位置，支持左键、右键、中间键
“位置”参数
设置所点击的控件元素中，鼠标的初始位置,支持中间、左上、左下、右上、右下
“X/Y轴偏移”参数
如果点击的目标位置不在上述“位置参数”的五点中，则可以通过设置x轴、y轴偏移来点击目标位置。在设定的位置（上述“位置”参数）的基础上设置x轴、y轴偏移：
鼠标向右为正，向左为负，向下为正，向上为负
“按键次数”参数
设置鼠标快速连续点击次数，默认为1次。
注：当涉及界面文本信息搬运，无法使用获取文本拾取元素时，可采用这种鼠标连续点击多次，全选文本，再进行拷贝的方式
“操作异常时”参数
组件执行过程中，设置异常处理的方式。
（1）默认为“中断”：执行过程中遇到错误，流程中断并抛出异常；
如图中，执行错误则中断流程，不会继续执行后面的【输出】组件。
（2）选择“继续”，则在执行过程中即使遇到错误，流程也会继续执行之后的步骤。
如图中，执行错误也会继续执行后面的【输出】组件。

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

所拾取控件的参数属性。

“目标文本”参数
设置目标界面元素包含的文本信息。组件执行时会根据“目标文本”属性中的文本，查找到并默认进行点击包含此文本的整个控件。
“匹配规则”参数
设置查找文本时使用的规则。

（1）默认为“包含”，则组件执行过程中会查找包含目标文本的所有界面元素；
（2）选择“相等”，则组件执行过程中会查找和目标文本内容完全相同的所有界面元素。
“目标位置”参数
设置点击目标在所有匹配到的界面元素中的位置。
如：目标界面中查找到4个包含目标文本“钉钉”的界面元素，若想点击第三个，则将此属性设置为“3”即可。
“OCR引擎”参数
默认为“互联网”。
“路径”参数：在拾取目标时，按照路径中的名称一层层找到对应的控件