当前位置: 首页>前端>正文

uibot 嵌入java uibot creator教程

UiBot官方开发者指南 >>

 

一、简介

1.什么是RPA?

Robotic Process Automation,中文翻译为机器人流程自动化,简称RPA。

RPA是软件机器人,用来完成计算机上重复的工作

 

2.UiBot是什么?

UiBot是一种RPA平台

 

3.RPA平台组成部分

1.开发工具:制作、运行、调试软件机器人

2.运行工具:普通用于运行已有流程,查阅结果。

3.控制中心:对多台PC上的机器人集中控制(分发流程、设定启动条件等)

Creator把流程先上传到Commander,再由Commander统一下发给各个Worker,并统一指挥各个Worker执行流程

                                       UiBot的三个组成部分

 

 

二、基本概念

流程 > 流程快 > 命令 > 属性

1.流程:UiBot流程是一连串的执行动作,以流程图的方式显示,包含一个文件夹。

uibot 嵌入java uibot creator教程,uibot 嵌入java uibot creator教程_流程图,第1张

 

 

2.流程图:

包含“开始”、“结束”、“流程块”和“判断”四种元素,用箭头连起来。

 只能有一个“开始”元素,可以有多个“结束”元素,可以有多个“判断”元素,至少一个“流程块”。

一个流程分多个步骤,每个步骤用流程块来描述(冰箱打开 -> 装进大象 -> 关上冰箱)。

推荐把逻辑独立的封装成一个流程块,留个流程块最好不要超过20个,多个沟通起来困难。

uibot 嵌入java uibot creator教程,uibot 嵌入java uibot creator教程_流程图_02,第2张

 

 

3.可视化视图

uibot 嵌入java uibot creator教程,uibot 嵌入java uibot creator教程_uibot 嵌入java_03,第3张

命令:把一个步骤具体细化成命令去执行,如:模拟鼠标、键盘操作,对窗口、浏览器操作等

属性:细化描述具体的命令

 

4.源代码视图

uibot 嵌入java uibot creator教程,uibot 嵌入java uibot creator教程_流程图_04,第4张

 

 

uibot 嵌入java uibot creator教程,uibot 嵌入java uibot creator教程_SAP_05,第5张

 

 

5.小结

这一章学习了四个概念:流程、流程块、命令、属性。还看到了三种视图:流程图、可视化视图、源代码视图。它们之间的关系如下图所示:

uibot 嵌入java uibot creator教程,uibot 嵌入java uibot creator教程_SAP_06,第6张

 

流程包含多个流程块,流程块包含多个命令,命令包含多个属性。流程图是流程的展现,可视化视图和源代码视图都是流程块的展现。

 

6.进阶:流程图的输入和输出

流程图中的变量,其作用域也仅限于当前流程中,在流程块里面是无法直接使用的。

当一个流程块开始运行的时候,可以把一个值(可以是变量或者表达式)“输入”到流程块中;而当一个流程块运行结束的时候,也可以把一个值“输出”到流程图中的某个变量中。还可以在流程图中加入一个“判断”,根据某个值,来决定究竟后面要找哪条路径去运行。

UiBot用到的编程语言是不区分关键字、变量名的大小写的,所以您也可以写 SELF.INPUTself.input,或者 RETURN <输出值> 等。

                                               流程图的属性栏

 

如下图所示,“判断”元素有两个出箭头,一个标有yes,一个标有no,当其属性中的“条件表达式”为真时,沿着yes箭头往后运行,否则,沿着no箭头往后运行。

uibot 嵌入java uibot creator教程,uibot 嵌入java uibot creator教程_SAP_07,第7张

 

流程图输入和输出的具体用法:

uibot 嵌入java uibot creator教程,uibot 嵌入java uibot creator教程_流程图_08,第8张

 

我们首先选中“流程块1”,在其“输出”属性中,填写一个变量名,假设是X;然后选中“流程块2”,在其“输入”属性中,填写同样的变量名(不区分大小写)。这样,通过变量X,就把“流程块1”的输出和“流程块2”的输入连接起来了。如下图所示。 这个变量X仅在当前流程图中有效,其作用仅仅是把两个流程块连接起来。在流程块1和流程块2中,均无法直接使用X来设置或者获取其值。

                 通过同一个变量,连接流程块1的输出和流程块2的输入

 

如何让流程块1输出,又如何让流程块2输入呢?

我们先点击“纸和笔”图标进入流程块1,只需要插入一条“获取系统时间”和一条“格式化时间”命令(在“时间”分类下),并把“格式化时间”中的“时间”属性设为“获取系统时间”的结果,即可得到当前时间,并以容易阅读的格式保存在变量sRet中。 然后,再插入一条“跳出返回”命令(在“词法语法”分类下),并把sRet设为返回值,即可让流程块1正确输出。如下图所示。为了方便读者理解,图中同时列出了这个流程块的可视化视图和源代码视图,读者可根据掌握程度任选其一。

                                            在流程块1中输出当前时间

再点击“纸和笔”图标进入流程块2,只需要插入一条“输出调试信息”命令,并把“输出内容”属性设为Self.Input(不区分大小写)即可。如下图所示。同样,我们也列出了这个流程块的可视化视图和源代码视图,以方便理解。

                          在流程块2中输出调试信息,信息来自于流程块1

回到流程图界面,然后点击“运行”按钮,即可看到运行结果。注意,由于流程块2需要获得流程块1的输出,所以,在流程图中运行的结果是正确的。虽然流程块2也可以单独运行,但在单独运行时,由于缺乏流程块1的输出,结果可能会有不同。

 

 

三、界面元素

 1.什么是界面元素?

  鼠标下面都是一个小的图形部件,我们把这些图形部件称为“界面元素”。

   在UiBot中,界面元素的作用,就是作为“有目标”的命令中的目标使用。

uibot 嵌入java uibot creator教程,uibot 嵌入java uibot creator教程_SAP_09,第9张

 

2.目标选取


点击目标”命令和“选择目标”按钮

用“目标选择器”选中开始菜单按钮

“目标”属性的值

{"wnd":[{"app":"explorer","cls":"Shell_TrayWnd"},{"cls":"Start","title":"开始"}]}

 

3.目标编辑

目标常见错误:

  • 无论如何移动鼠标,都无法使遮罩恰好遮住要作为目标的界面元素(通常是遮罩太大,遮住了整个窗口)
  • 遮罩可以恰好遮住界面元素,但用生成的数据查找目标时,发生了:
  • 错选:找到界面元素不是我们选的
  • 漏选:界面元素存在,却找不到

                    修改目标

 

                                     目标编辑器

 

0:这是目标的上级界面元素  1:是目标界面元素,程序逐级从上往下查找。

 

  • 不理解的特征名称,比如cls、aaname等,暂时不管它们;
  • 善用通配符 *,代表“匹配任意内容”。如界面元素title特征的值是“姓名:张三”,“张三”可能变,但“姓名:”不变。所以,可以用title: "姓名:*"来作为特征,而不是把这条特征去掉;
  • 去掉特征的时候要慎重。去掉特征可以减少漏选,但会增加错选。流程运行时漏选易发现,错选不易发现。

大多数的“有目标”命令在找不到目标时会报错,除非:(1)判断了目标是否存在 (2)用Try…Catch捕获异常。

程序错选的时候,UiBot并不知道,还会继续往下运行。

 

提醒:不同操作系统、浏览器上,同样的界面元素特征可能不一样。

uibot 嵌入java uibot creator教程,uibot 嵌入java uibot creator教程_uibot 嵌入java_10,第10张

 

保持开发环境和生产环境的一致性,以减少不必要的错误。

 

4.进阶

遮罩选取目标常见问题:只能遮罩选取整个窗口,不能具体选中目标界面元素。

 

如何正常选取?

1.Chrome浏览器:

Chrome浏览器需要安装扩展程序“UiBot Native Message Plugin”,并启用。

uibot 嵌入java uibot creator教程,uibot 嵌入java uibot creator教程_Chrome_11,第11张

 

Chrome浏览器或IE浏览器(360安全浏览器、QQ浏览器等容易出错)

 

2.跨域网页

网页中通过iframe嵌套了另一个域名下的网页(不同的二级域名或顶级域名),Chrome浏览器处于安全考虑,禁止对引用的网页访问,如元素选取,执行JS等,无法自动化操作。(IE可以)

解决办法:

(1)使用IE浏览器

(2)通过启动参数命令,来关闭Chrome的安全设置

右键点击Google Chrome图标,选择 属性->快捷方式,在“目标”一栏填入启动参数,具体格式如下:<Chrome安装路径> --disable-web-security --user-data-dir=用户数据目录。比如,我们的Chrome安装在C:\Program Files (x86)\Google\Chrome\Application\chrome.exe下,用户数据目录为D:\temp,那么套用格式,我们在Chrome目标窗口应填入C:\Program Files (x86)\Google\Chrome\Application\chrome.exe --disable-web-security --user-data-dir=D:\temp,如下图:

                        Chrome关闭安全设置

在目标后添加(双引号后面): --disable-web-security --user-data-dir=D:\temp

 

在经过以上操作后,我们再打开Chrome,会看到Chrome地址栏会有如下的提示,并且安装的扩展程序也消失不见了。不要着急,这是因为Chrome的用户数据目录发生了变化,只要重新安装UiBot的Chrome扩展程序,即可自动化操作。

                                                                  Chrome关闭安全设置后打开显示

经过以上设置,Chrome即可支持跨域访问。

 

3.SAP客户端程序

SAP客户端程序需要在设置中打开脚本支持,才能正常选取。我们以SAP 710客户端为例:

  1. 打开SAP客户端程序,进入登录主界面;
  2. 输入rz11事务码并进入相应界面;

                           SAP输入事务码

  1. 在事务界面输入sapgui/user_scripting,并点击display

                                                        rz11事务界面

  1. 查看Current Value当前值选项,如果为TRUE则已经开打选项,不需要做任何改动;如果为FALSE则需要点击Change Value改变此处为TRUE;

                                             sapgui设置界面

  1. 点击设置按钮,选择Options项;

                                                      SAP客户端设置选项

  1. 切换到Scripting选项卡,勾选“Enable Scripting”选项,并取消勾选“Notify When a Script Attaches to Running Man GUI”和“Notify When a Script Opens a Connection”选项。

                          SAP客户端Scripting选项卡设置

设置完成后,即可象普通的Windows软件一样,用UiBot对SAP客户端进行界面元素的获取和操作。除了前文中介绍的“鼠标点击”、“键盘输入”等操作之外,我们来看一个新的例子,用UiBot自动设置单选框的内容:

在“界面元素”类的命令下,找到“设置元素勾选”命令,拖动插入到组装区。按下“查找目标”,可以看到UiBot的界面元素选择遮罩可以准确的遮住SAP客户端中每个单选框的位置。选中我们关注的单选框,并在命令属性栏的“是否勾选”选择“是”即可。如图所示:

SAP客户端Scripting选项卡设置

运行此流程,即可看到SAP客户端的单选框被UiBot自动设置为“Display inbound call”一项。

 

4.JAVA程序

UiBot支持Swing、AWT、JNPL、Applet等多种Java应用程序。除Swing以外,其他Java程序都需要安装Java扩展程序。

可以按照如下步骤去安装Java扩展程序:

  1. 打开UiBot Creator,随便选择一个流程。在菜单中选择“帮助”->“安装Java扩展”;
  2. 安装成功之后,UiBot Creator将会有对应的安装成功提示出现。需要注意的是,如果需要操作的Java程序是以管理员权限进行安装,那么同样需要以管理员权限启动UiBot Creator,才能顺利安装Java扩展程序。

安装后,即可象普通的Windows软件一样,用UiBot对Java程序进行界面元素的获取和操作。

 

5.进阶:网页目标

                                                               网页目标:百度主页的二维码

 wnd信息标明了这个网页所在的浏览器窗口,html信息才是网页上的界面元素的关键信息。

  • html:代表这是一个网页界面元素;
  • url:对应浏览器地址栏中显示的URL,不参与元素特征匹配。仅在“绑定外部浏览器”命令中(在“浏览器”类命令中可以找到)用到,用于选择想要绑定的浏览器活动标签页;
  • title:与url类似,对应浏览器标签页的标题,不参与元素特征匹配,也仅在“绑定外部浏览器”命令中使用;
  • tagName:html标签类型(div、a、input等);
  • attrMap:对界面元素详细的html描述;
  • index:一般起辅助作用,说明在满足特征条件情况下,元素出现的顺序。UiBot的index是从数字1开始的,当index没有填写或取0时,则会选择第一个出现的元素。

 

 

实例:获取产品月销量

 

具体步骤:

  1. 从UiBot Creator的命令区选择“获取元素文本”命令,如下图:

                                                     获取元素文本命令

 

  1. 在“获取元素文本”命令上点击“查找目标”按钮,并选择销量数字,如Intel i5 8500页面的“98”,如下图:

                                               选中需要获取的文本

 

  1. 用“输出调试信息”命令查看抓取到的值(当然,也可以用于其他用途,如转换成数字、保存到Excel表格等,本文暂不赘述其他用途),如下图:

                              查看抓取的内容

看起来,好像工作得很好,毫无问题的获得了Intel i5 8500的月销量:98。但是,如果我们在其他商品上再去运行这个流程(使用Chrome浏览器,只需切换页面的标签即可,UiBot始终会在激活的标签工作),就会发现出问题了。

                                          在其他商品上运行流程

可以看到,在等待一定时间之后,UiBot最终因为没有找到目标而抛出了异常。那么,问题到底出在什么地方?我们应该如何做,才能让UiBot顺利找到目标呢?

 

点击“获取元素文本”命令,查看命令的属性,并具体打开“目标”属性进行查看,如下图:

细心的读者可能已经发现了:原来"aaname"这条特征已经被固定在“98”了。这显然是不合理的:我们本来就是为了获取销量,如果把销量的数值98也加到特征里面,那是毫无意义的!因为销量一旦发生变化,特征就无法匹配了,造成“漏选”的问题。怎么办呢?我们可以很自然的想到:取消aaname特征的勾选状态,或把aaname的特征采用"*"进行通配,即可跳过这条造成“漏选”的特征。如下图:

                                          修改“aaname”的特征为通配符

请注意,这里不必纠结上面图片框里显示的98,那只是一张参考图,在实际查找目标的时候不会起到任何作用。也不必纠结titleurl这两条特征,因为前文已经提到,这两条特征也不会参与到查找目标的过程中。

修改完成之后,再次运行这个流程块,看看是否能正确获取其他商品的月销量。如下图:

                                    修改“aaname”特征之后的运行

奇怪的事情发生了,之前的异常确实没有出现,并且获取到了内容。但是并不是我们想要的“77”,而是“月销量”几个字,这是怎么回事呢?

我们观察一下页面上的内容,发现修改“aaname”之后,虽然不会发生“漏选”,但由于文字“月销量”的特征和“77”完全一致,造成了“错选”。仔细查看即可发现,“月销量”文字和“77”的tagName、attrMap等特征完全一样,好比是一个户口本里的同一家人,已经无法区分了。怎么办呢?可以使用"index"特征来定位他们的不同。上文提到,UiBot的index是从数字1开始的,当index没有填写或取0时,则匹配第一个。从页面上看,“月销量”这个元素在销量数字的前面,如果它是第一个,那么销量数字就应该是第二个,因此,我们猜测,当的index取2的时候,就可以找到销量数字了。不妨填上试一下。

                                                     修改“index”特征的值

现在验证一下。在UiBot Creator工具栏上,点击“运行”按钮,直接运行当前的流程块。可以看到,在其他商品的页面上,也可以正确的拿到了其月销量数据了。

实际操作中,多多尝试和总结经验。

 

 

四、无目标命令

1.为什么没有目标?

UiBot所在的系统和目标不在统一系统中,无法操作目标界面元素。

虚拟机和远程桌面,如:Citrix、VMWare、Hyper-V、VirtualBox、远程桌面(RDP)、各种安卓模拟器(如靠谱助手)等

解决办法:可以把UiBot和流程涉及到的软件,都安装在虚拟机里,或者远程计算机里。

 

 基于DirectUI的软件:元素是被画出来的,UiBot无法找到。

 

 游戏:元素是画出来的,界面变化快,时效性要求高,RPA对游戏效果不好。游戏推荐按键精灵。

 

2.无目标命令

                               有目标和无目标的命令

 

最重要的是“模拟移动”:设置坐标位置 - 模拟移动 - 模拟点击 - 输入文本 

Windows坐标理解为第4象限,坐标x:200, y:300,x轴是距离屏幕左边的水平方向的距离,y轴是距离屏幕上面的垂直方向的距离。

                    Windows的屏幕坐标系

坐标保存在BotScript语言的字典中,字典可以存放多个值,变量名为pnt,则使用pnt["x"]pnt["y"]即可得到坐标的x和y两个值。

固定坐标情况很少,一般都会有变化的,一般推荐使用其他命令根据某种特征,先找到界面元素的坐标,然后把坐标当做变量穿给无目标命令。

在UiBot中,无目标命令的最佳拍档,是图像命令。

 

3.图像命令

UiBot Creator里面列出的“图像”类命令

“查找图像”命令:指定一个图像文件,格式png(无损压缩,推荐)、bmp、jpg等,扫描查找是否在指定区域,没有则发生异常。

                         使用“查找图像”命令并指定图像和查找范围

 

                  “查找图像”命令的属性

“激活窗口”:把窗口放到最前面显示,防止被其他窗口遮挡,一般都默认是。

                                                  用“输出调试信息”查看结果

结果:

{ "x" : 116, "y" : 235 }

 

objPoint["x"] 和 objPoint["y"] 即可得到其中的x和y值

                                             用“输出调试信息”查看结果

 

“点击图像”:“查找图像”、“模拟移动”、“模拟点击”三条命令的组合

 

4.OCR命令

                        很难直接获取微信中的聊天文字

 

UiBot采用百度云OCR,使用条件:

1.联网

2.向百度付费:免费通用文字识别每天5000次,证照等识别每天500次,超过了需要购买百度服务。

3.注册百度账号:需要自己注册百度云账号 及 百度云OCR服务的账号(一般称为Access Key和Secret Key),申请方法很简单,请点击这里查看我们的在线教程。

                         UiBot的OCR命令

红框里的命令类似于“图像”类中的“点击图像”、“鼠标移动到图像上”,“查找图像”命令,只不过不需要传入图像了,只需要在属性中标明要找的文字即可。

蓝框里的命令和绿框里的命令类似,只不过前者需要提供一个图像文件,后者需要提供一个窗口、以及窗口中的一个区域。

                                    选择OCR目标

 

                                 完成一条OCR命令

 

下面,再测试一下“图像特殊OCR识别”命令。所谓“特殊”,是指我们要测试的是某种特定的图像,如身份证、火车票等。假设我们在D:\1.png文件中保存了如下的图像:

                                要进行特殊OCR的图像

 

                                         特殊OCR的属性设置

 

5.注意事项

无目标的命令,特别是它们所依赖的图像、OCR等命令,有以下的缺点:

  • 速度慢
  • 怕遮挡
  • 依赖图像文件
  • OCR需联网

 

图像、OCR命令技巧:

截图尽量小  

区域尽量小

尽量保持分辨率和缩放比列一致

如,Windows 10操作系统分辨率和缩放比例:

使用图片时用绝对路径:

推荐把图片文件放res文件夹下,用@res"1.png"表示路径,@可以自动获取前缀路径。

 

 

五、语言参考 

1.概述

UiBot是用来做RPA的编程语言,UB语言简单易用。

 

2.基本结构

UB语言是纯文本格式,UTF-8编码。

 

执行一个流程块的时候,从第一行开始执行,遇到函数定义暂时跳过,然后继续从函数结束后的一行开始执行。

 

 推荐一行只写一个语句。如果一定要写多个语句,则用冒号分隔符(:)进行分隔。

 

 需要折行,可以在任意语句中出现的逗号(,)或二元运算符(“二元运算符”的概念请参考这里)之后直接折行,一定要在其他地方折行,则用反斜杠(\)作为折行符号。例如:

Dim a= \
1

 

 注释:

单行注释://

 多行注释:

 /*

语句1

语句2

*/

 

UB语言中所有关键字、变量名、函数名均不区分大小写。

 

3.变量、常量和数据类型

  1.数据类型:整数、浮点、布尔、字符串、函数、复合型和空值。

十进制或者十六进制的方式表示,其中十六进制需加前缀 &H 或 &h

常规方式或者科学计数法表示。如 0.01 或者 1E-2 或者 1e-2 均代表同一个浮点数。

    布尔型:True 或 False不区分大小写)

    字符串:一对双引号(") 或 一对单引号(')包含,\t 代表制表符,用 \n 代表换行,用 \' 代表单引号,用 \" 代表双引号,用 \

                   字符串中间可以直接换行,无需增加任何其他符号,换行符也会作为字符串的一部分。

   

   用前后各三个单引号(''')来表示一个长字符串。在长字符串中,可以直接写回车符、单引号和双引号,无需用 \n\' 或者 \"

  

   函数型的值只能是已经定义好的函数

   复合型:数组、字典等

   空值型: Null,不区分大小写

a = 1           // a是整数型变量
a = &HFF        // a还是整数型变量
a = True        // a是布尔型变量。作为动态类型语言,a的类型可以随时变化 
a = FALSE       // a是布尔型变量,注意True和False都不区分大小写
a = 'UiBot'     // a是字符串型变量
a = "UiBot
RPA"            // a是字符串型变量,字符串中可以换行
a = null        // a是空值型变量,可以写为Null、NULL或null(不区分大小写)

 

 

2.变量和常量

变量定义:

Dim 变量名

 

定义变量并赋初值:

Dim 变量名=值

定义多个变量:

Dim 变量名1 = 值1, 变量名2
Dim 变量名1 = 值1, 变量名2 = 值2

 

 

标识符:有命名的东西(例如:变量、常量、函数等)

标识符以英文字母或_开头,可以包含数字、UTF-8编码中的其他语言字符(如汉字),变量名不区分大小写。

UB语言变量必须定义(除了For语句中的循环变量、Try语句中的异常变量、函数参数等)。

 

局部变量:函数内定义和使用

全局变量:函数外任意位置定义,全局使用。

 

3.复合类型

数组:

[值1, 值2, 值3 ]

字典:

{ “名字1”:值1, “名字2”:值2, “名字3”:值3 }

 

名字只能是字符串,值可以是任意类型

 

索引使用方括号[],多维数组或字典中的数组:

变量名[索引1][索引2]

 

Dim 变量 = [486, 557, 256]                      // 变量可以用中文命名,初值是一个数组
a = 变量[1]                                     // 此时a被赋值为557
变量 = {"key1":486, "key2":557, "key3":256}     // 变量的类型改为一个字典
a = 变量["key1"]                                // 此时a被赋值为486
变量["key4"] = [235, 668]                       // 往字典中增加一个新值,可以是一个数组
//此时,字典中的内容为 {"key1":486, "key2":557, "key3":256, "key4":[235, 668]}
a = 变量["key4"][0]                             // 此时a被赋值为235

 注:数组索引只能是整数,0开始。字典索引只能是字符串类型。

 

4.运算符和表达式

 

uibot 嵌入java uibot creator教程,uibot 嵌入java uibot creator教程_流程图_12,第12张

 表达式:变量、常量和值用运算符和圆括号 ( )

Not

 - :一元运算符,也可以用作二元运算符

 其他都是二元运算符

注:=:出现在括号()内表示判断,单独语句表示赋值。

 

 表达式常用于赋值语句,可以给某个变量赋值,其形式为:

变量名 = 表达式

 

 

数组、字典是引用类型,引用传递。

引用类型:
a = [486, 557, 256]     // a是一个数组
b = a                   // b是a的“别名”
b[1] = 558              // 改变b里面的值,a里面的值也会跟着改变
c = a[1]                // 此时c的值是558,而不是原来的557

变整数类型:
a = 557                 // 此时a被赋值为557(变为整数型)
b = a                   // 此时b里面的值也是557,但和a分别保存
b = 558                 // b里面的值发生改变,a的值不改变
c = a                   // 此时c的值仍然是原来的557,因为a不是字典、数组

 

 

5.逻辑语句

(1).条件分支语句

If 条件
    语句块1
End If
If 条件
    语句块1
Else
    语句块2
End If
If 条件1
    语句块1
ElseIf 条件2
    语句块2
Else
    语句块3
End If

 

示例:

// Time.Hour() 可以取得当前时间中的小时数
// TracePrint() 可以把指定的内容输出到UiBot的输出栏中

If Time.Hour() > 18             // 取得当前时间中的小时数
    TracePrint("下班时间")      // 如果大于18,则执行这里的语句
Else
    TracePrint("上班时间")      // 如果不满足前面的条件,则执行这里的语句
End If

 

 

(2).选择分支语句

根据一定的条件,选择多个分支中的一个。先计算Select Case后面的表达式,然后判断是否有某个Case分支和这个表达式的值是一致的。如果没有一致的Case分支,则执行Case Else(如果有)后面的语句块。

Select Case 表达式
    Case 表达式1, 表达式2
        语句块1
    Case 表达式3, 表达式4
        语句块2
    Case Else
        语句块3
End Select

 

示例:

Select Case Time.Month()            // 取得当前时间中的月份
    Case 1,3,5,7,8,10,12            // 如果是1、3、5、7、8、10、12月
        DayOfMonth = 31             // 当月有31天
    Case 4,6,9,11                   // 如果是4、6、9、11月
        DayOfMonth = 30             // 当月有30天
    Case Else                       // 如果是其他(也就是2月)
        DayOfMonth = 28             // 当月有28天(不考虑闰年的情况)
End Select
TracePrint(DayOfMonth)

 

 

(3).条件循环语句

在UB语言中,使用Do…Loop语句来实现条件循环,即满足一定条件时,循环执行某一语句块。Do…Loop语句有以下五种不同的形式,用法较为灵活:

  1. 前置条件成立则循环:先判断条件条件成立则循环执行语句块,否则自动退出循环。
Do While 条件
    语句块
Loop
  1. 前置条件不成立则循环:和前一条相反,条件成立则退出循环,否则循环执行语句块。
Do Until 条件   //Until:到...为止
    语句块
Loop

 

  1. 后置条件成立则循环:先执行语句块,再判断条件条件成立则继续循环执行语句块,否则自动退出循环。
Do
    语句块
Loop While 条件

 

  1. 后置条件不成立则循环:先执行语句块,再判断条件条件成立则自动退出循环,否则继续循环执行语句块。
Do 
    语句块
Loop Until 条件

 

  1. 无限循环:该循环语句本身不进行任何条件的判断,需要在语句块中自行做判断,如果语句块中没有跳出循环的语句,则会无限的执行该循环
Do
    语句块
Loop

 

示例:

Do Until Time.Hour() > 18              // 判断当前时间中的小时数,只要不大于18就循环
    TracePrint("还没有到下班时间")      // 每次循环,都会执行这里的语句
    Delay(1000)                        // 每判断一次,休息一秒钟
Loop
TracePrint("下班时间到啦")              // 如果大于18,则跳出循环,执行这里的语句

 

 

(4).计次循环语句

计次循环语句主要用于执行一定次数的循环,其基本形式为:

For 循环变量 = 起始值 To 结束值 Step 步长
    语句块
Next

 

起始值结束值步长都只允许是整数型或者浮点数型;步长可以省略,默认值为1。变量从起始值开始,每循环一次自动增加步长,直到大于结束值,循环才会结束。

 

在计次循环语句中,循环变量可以不用Dim语句定义,直接使用,但在循环结束后就不能再使用了。

Dim count = 0               // 定义变量count
For i=1 To 100              // 每次循环,变量i都会加1。这里变量i不需要定义
    count = count + i
Next
TracePrint(count)           // 这里会显示1+2+3+…+100的结果,即5050

 

 

(5).遍历循环语句

遍历循环语句可以用于处理数组、字典中的每一个元素。遍历循环语句有以下两种形式:

For Each 循环变量 In 数组或字典
    语句块
Next

 

在这种形式的循环语句中,会自动遍历数组、字典中的每一个值,并将其置入循环变量中,直到遍历完成为止。

或者:

在这种形式的循环语句中,会自动遍历数组、字典中的每一个索引和值,并将其分别置入循环变量1、循环变量2中,直到遍历完成为止。

 

和计次循环语句类似,在遍历循环语句中,循环变量可以不用Dim语句定义,直接使用,但在循环结束后就不能再使用了。

例如:

Dim days = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31] // 定义数组型变量days
Dim count = 0   
For Each i In days             // 每次循环,变量i的值分别为days中的每个值 
    count = count + i          // 把数组中的每个值依次加起来
Next
TracePrint(count)              // 这里会显示一年中每个月的天数的累加和,即365

 

 

(6).跳出语句

Break:只能出现在条件循环、计次循环或遍历循环等循环语句的内部语句块中,其含义是立即跳出当前循环。

Continue:只能出现在条件循环、计次循环或遍历循环等循环语句的内部语句块中,其含义是立即结束当前循环,并开始下一次循环。

Exit:自动结束整个流程

例如:

Dim days = { '一月':31, '二月':28, '三月':31, 
             '四月':30, '五月':31, '六月':30, 
             '七月':31, '八月':31, '九月':30, 
             '十月':31, '十一月':30, '十二月':31 }  // 定义字典型变量days

For Each i,j In days            // 每次循环,变量i, j分别为days中每个名字和值
    If j Mod 2 = 0              // 如果j是偶数
           Continue             // 结束本次循环,开始下一次循环
    End If
    TracePrint(i)               // 把days中的名字(其值不是偶数)显示出来
Next

 

 

6.函数

函数的定义和调用没有先后关系,可以先出现调用,再出现定义。但函数必须定义在全局空间中,也就是说,函数定义不能出现在其他函数定义、分支语句、循环语句下面的语句块中。

  • 无参数的函数
Function 函数名( )
    语句块
End Function
  • 有参数的函数
Function 函数名(参数定义1, 参数定义2)
    语句块
End Function

在函数定义中,要退出函数并返回,采用以下写法:

Return 返回值

 

Function Add(x, y=1)        // 定义了两个参数的函数,第二个参数有默认值
    Return x + y            // 返回值为x+y的值
End Function

 

调用函数的格式如下:

返回 = 函数名(表达式1, 表达式2)

或者

函数名(表达式1,表达式2)

 

按照第一种格式调用,可以指定一个变量作为返回,当函数调用完成后,函数的返回值会自动赋值给这里的返回变量,调用者可以通过返回值,了解到函数调用的情况。此时,必须在被调用的函数名后面加圆括号。而当按照第二种格式调用时,调用者不需要返回值,则可以省略圆括号,使语句更符合自然语言习惯。

 

当调用时,相当于对函数中的参数进行了一次赋值运算,用表达式的值对其赋值。与赋值运算的规则相同,当表达式为一个独立的(没有使用任何运算符计算)数组、字典时,赋值操作只赋值其引用,也就是说,只是为变量增加一个“别名”。

 

调用函数时,传入的表达式的数量可以少于参数的数量,如果某个参数没有传入值,或者传入值为Null,则采用其默认值,如果连默认值也没有,则其值自动为Null

a = Add(100)            // 调用Add函数,第二个参数取默认值1,所以a的值是101
b = Add(100, 200)       // 调用Add函数,指定了两个参数,所以b的值是300
Add 100, 200            // 调用Add函数,不关心返回值,所以可以不写括号

 

当函数定义完成后,其名称可以作为一个函数类型的常量使用,也可以把函数名称赋值给某个变量,用这个变量也可以调用这个函数。

例如,对于上面定义的函数Add,可以按照如下的方式使用:

Dim Plus = Add
TracePrint Plus(100, 200)   
// 相当于先调用了Add函数,再用其返回值调用了TracePrint函数,结果是300

 

 

7.其他

(1)多模块

UB语言支持多模块,可以用其他语言实现扩展模块,并在当前流程块中使用。目前支持以下几种类型的模块:1)UB语言的流程块;2)Python语言的模块;3)C/C++语言的模块;4).Net的模块;5)Lua语言的模块。不同的模块有不同的扩展名,去掉扩展名以后,剩下的文件名就是模块的名字。比如某个Python语言的模块,文件名为Rest.py,则其模块名为Rest。

在UB语言中,采用以下方式导入一个模块:

Import 模块名

注意这里的模块名的书写规则和变量名一致,不需要采用双引号,也不需要加扩展名。如Import Rest。UiBot在编译和运行时会自动按照Lua语言模块、C语言模块、.Net语言模块、Python语言模块、UB语言流程块的先后顺序,依次加上相应的扩展名进行查找。在Windows中,由于文件名不区分大小写,所以Import语句后面的模块名也可以不区分大小写。在其他操作系统中,需要注意模块名的大小写要和文件一致。

每个导入的模块,都会被放置在一个与模块名同名的“命名空间”中,可以通过下面这种方式来调用导入模块中的函数:

命名空间.函数名

对于Python、Lua语言的模块,只会保留其中的全局变量定义和函数定义,其他内容都会被忽略。对于C语言的模块和.Net模块,只能调用其中定义的函数。

 

如果要导入一个UB语言的流程块,则需要导入和被导入的流程块文件在同一个目录下。

导入UB语言的流程块之后,既可以调用被导入的流程块中定义的函数,又可以直接以流程块的名字作为函数名,直接运行这个流程块中的所有命令。

ABC()

 

例如,有一个流程块 ABC.task。在其他流程块中Import之后,直接采用下面的格式即可直接调用ABC.task(相当于运行了ABC.task这个流程块):

ABC.test()

 

 

(2)异常

作为动态类型语言,有很多错误在编译时难以检查,只能在运行时报错。而且,由于UiBot不强调运行速度,而更强调运行的稳定性,也会在运行时加入比较多的检查。当出错的时候,比较合适的报错手段是抛出异常。 比如,对于有目标命令(“有目标命令”的概念可以参考这里),在运行的时候,如果到了超时时间都不能找到目标,就会自动抛出一个异常。

除了自动抛出的异常之外,在流程块中,还可以采用Throw语句抛出一个异常:

Throw 字符串

 

在抛出异常时,可以把异常相关信息以字符串的形式一起抛出,也可以省略这个字符串。

如果在流程块中没有对异常进行处理,当出现异常时,整个流程都会终止执行,并且把异常相关信息显示出来。如下图所示:

                                          流程运行的时候出现异常

 

如果不希望流程在发生异常的时候终止,可以采用以下语句对异常进行处理:

Try
    语句块
Catch 变量名
    语句块
Else
    语句块
End Try

 

如果在Try后面的语句块中发生了异常,会跳到Catch后面的语句块中执行。如果在Try语句块中没有发生异常,且定义了Else语句块(当然,也可以省略Else语句块),则会跳到Else语句块中执行。

Catch语句后面的变量名可以省略。如果不省略,可以不用Dim语句提前定义,当发生异常时,这个变量的值是一个字典,其中包含“File”、“Line”和“Message”三个字段,分别代表发生异常的文件名、发生异常的行号、异常包含的信息。

 

六、编写源代码

1.基本规则

UiBot的源代码视图遵循以下规则:

  • 用一个源代码文件来表示一个流程块,源代码文件的扩展名默认是.task
  • 用函数调用来表示一条命令
  • 用函数调用时传入的参数,来表示命令的属性
  • Dim语句来定义变量

 

从图中不难看出,“启动IE浏览器”的命令在源代码视图中实际上是对函数WebBrowser.Create的调用;启动IE浏览器时设置的各项属性,都是函数调用中的变量,如"about:blank"等;命令中使用到的变量,需要用Dim语言定义。

                                    可视化视图和对应的源代码视图

 

UiBot支持的命令非常丰富,在源代码视图中,这些命令都使用函数来表示。所以,UiBot实际上在UB语言的基础上,内置了一个很大的函数库。

其中,最常用的一部分函数是没有命名空间的,如Delay函数;

其他函数都是包含一个命名空间的,如前面例子中的WebBrowser.Create函数,其命名空间是WebBrowser。对于有命名空间的函数,大部分都是通过UB语言中的多模块机制,利用一个模块中实现的,所以在使用前需要先用Import语言导入相应的模块,例如WebBrowser.Create函数,在使用前需要写Import WebBrowser

当然,还有几个基础功能,其命名空间是会自动Import的,就不需要我们再做一次Import了,包括MathLogJson等。

 

UiBot支持的全部命令,其文档可以参考这里。在本文中,我们仅列出目前版本中已支持的主要命名空间及其功能概述,供读者参考。如对其中某个命名空间的功能有兴趣,再查阅文档不迟。注意,如前文所述,UB语言中的各种名字、关键字都不区分大小写,所以下表中列出的各个命名空间,都可以按全大写、全小写或各种大小写混合的方案进行书写。

uibot 嵌入java uibot creator教程,uibot 嵌入java uibot creator教程_流程图_13,第13张

 

比如,我们对Mouse下面的功能感兴趣,一种方法是查阅文档,看看这个命名空间下面有哪些函数,每个函数有哪些参数。另外,如果您的手已经放在键盘上了,还有另一种更快捷的方法,如下所述:

  1. 在UiBot Creator的源代码视图中,随便找一个空行,然后键入

Mouse

  1. (其实都不需要完整输入,只需要输入首字母

m

  1. ,即可自动联想到相关的关键词,按上下箭头选择,并按回车确认即可)
  2. 键入一个

.

  1. 符号,此时,会自动列出

Mouse

  1. 命名空间下的所有函数
  2. 继续按上下箭头选择,每个选中的函数,都会出现其功能的简要说明,按回车确认要用的函数
  3. 再键入一个左括号

(

  1. ,此时,会自动列出这个函数的参数,并显示第一个参数的说明
  2. 此后,每输入一个参数,按逗号进行参数分隔后,会自动切换到后续参数的说明

上述过程大致如下图所示:

 

2.有命令目标

    

                                  “点击目标”操作的源代码视图

 

第一行,以 #第一行之后的内容其实是一个函数调用,调用的函数是Mouse.Action,这个函数包含5个参数。但实际上,只有第一个参数是必须的,后面的参数都可以省略。我们不妨把可以省略的内容都去掉,只剩下下图所示的内容:

                     “点击目标”操作的源代码视图(简化后)

不难看出,函数只剩下了一个参数,这个参数是一个字典类型,代表了要点击的目标。当然,即便是这样简化,这个字典类型里面的内容也是很难手写出来的。怎么办呢?请注意,在源代码视图的上方,有“元素”、“图像”、“窗口”、“区域”四个按钮,分别还有对应的热键Alt+1、Alt+2、Alt+3、Alt+4(如下图)。由于我们需要用一个界面元素来作为命令的目标,所以,这里点击“元素”按钮。

                 

 

 

 

源代码视图上方的快捷按钮点击后,UiBot Creator的界面暂时消失,出现了“目标选择器”,也就是红边蓝底的半透明遮罩。这个“目标选择器”的用法,和可视化视图中选取目标的方法一模一样,只需要把鼠标移动到目标上,待遮罩恰好遮住目标的时候,单击鼠标左键即可。如果您对“目标选择器”的操作还不熟悉,请回头复习前文中目标选取这部分内容。

                     

                               目标编辑器的界面

选择目标之后,会弹出UiBot Creator的“目标编辑器”对话框,如下图所示。我们在前文中已经学习过如何使用目标编辑器来修改目标的特征,以避免造成目标的“错选”或“漏选”。这里的使用方法仍然与前文一致,仅有一点点细微的差别:右下角的按钮变成了“复制到剪贴板”。按下这个按钮,UiBot Creator会把目标的各个特征重新组合成一个字典类型的值,并把这个值以文本的形式复制到操作系统的剪贴板中。之后,只需要回到源代码视图,把剪贴板里的这段文本粘贴到函数调用Mouse.Action中作为参数,即可完成这条命令的编写。

不妨把这段文本粘贴到记事本里,可以看到,其内容就是描述目标的字典类型的值:

{"wnd":[{"app":"explorer","cls":"Shell_TrayWnd"},{"cls":"Start","title":"开始"}]}

 

在UiBot中书写一条Mouse.Action()函数调用,并把上述内容粘贴到圆括号里面,即可完成这条命令:

Mouse.Action({"wnd":[{"app":"explorer","cls":"Shell_TrayWnd"},{"cls":"Start","title":"开始"}]})

 

举一反三,我们试试做一点儿更多的操作。比如,把这个开始菜单按钮的图像,保存到一个图像文件里面去。用UiElement.ScreenShot函数可以完成这个任务。这个函数有两个必选的参数,第一个参数仍然是指定界面元素作为目标,第二个参数是要保存的图像文件的路径。也就是说,第一个参数和前面Mouse.Action的参数是完全一样的,把刚才复制到剪贴板的内容直接粘贴到这里就行;第二个参数写一个文件路径即可,比如"C:\temp\1.png"。这里有两个值得注意的细节问题:

  • 由于需要写文件,所以请注意,需要写到有权限的路径下。比如,UiBot默认不是以管理员账号启动的,所以诸如

"C:\"

  • 这样的路径就是不具有写权限的,但

"C:\temp"

  • 具有写权限。
  • 我们使用了字符串来表示文件路径,按照前文中UiBot的规定,字符串中要用转义字符

\

  • 来表示一个反斜杠

\

  • ,所以路径需要写为

"C:\temp\1.png"

  • 的格式。

保存并运行,即可看到开始菜单按钮的图像被存为一个文件。

回过头看看这段源代码,不难发现,“开始菜单按钮”这个目标被重复使用了两次,不好看。我们稍微改造一下,成为下面的样子:

Dim StartButton = {"wnd":[{"app":"explorer","cls":"Shell_TrayWnd"},{"cls":"Start","title":"开始"}]}
Mouse.Action(StartButton)
UiElement.ScreenShot(StartButton, "C:\temp\1.png")

这样看起来就清晰多了。

 

附录A 编程基础知识>>

 

===================================================

个人总结:

 

准备:

1.chrome浏览器安装插件,用于获取元素。

2.关闭chrome安全设置,右击浏览器图标-属性-目标,在目标后添加(双引号后面): --disable-web-security --user-data-dir=D:\temp

3.允许excle宏命令:文件-选项-信任中心-设置-宏设置-启用所有宏,信任VBA工程

 

细节:

1.获取网页元素时,不可以同时打开多个网页,防止后面的网页对获取元素干扰。

2.catch错误参数:errorDic  

    文件:errorDic["File"]  

    行号:errorDic["Line"]  

    错误信息:errorDic["Message"]  

3.打开浏览器或文件时,最好执行下:界面 - 窗口 - 更改窗口显示状态

   防止广告弹窗的影响,可以将窗口设置为置顶,合适时及时取消置顶。

4.引入其他流程块:

   Import uibot37688ddf4

   dim configDic =  uibot37688ddf4.GetCofigDic()

5.插件扩展:

   .Net:将dll文件放入creator安装目录下的extend文件下的DotNet文件下

             dll文件制作:vs新建类库项目 - 类库名和类名保持一致,再加一个接口类文件Inteface,接口类文件中只写方法名,类文件去实现接口。

             uibot里面调用直接先import dll的文件名,然后调用:Utility.Test()

    python:.py文件放入python文件夹下

6.配置:

   用uibot命令去写INI文件第1个节点和键值(第一个自己写没有)

 




https://www.xamrdz.com/web/2qd1924699.html

相关文章: