RPA Developer Advanced-Robotic Enterprise Framework Deep Dive机器人企业框架深入挖掘Walkthrough – UiDemo

Posted 2020-12-18 blossomhong

课程目标：

1、解释如何构建ReFramework模板; 

2、解释ReFramework模板是如何工作的;

3、使用ReFramework来自动化您自己的流程。

---

 

一、课程里面涉及的系统

     ACME System 1 ：https://acme-test.uipath.com/login

     可以先去注册一个，需要注意的地方：

• 确保你使用的电子邮件地址与你在学院注册时使用的相同。
• 第一次成功登录时需要执行的第一步是访问User Options部分并单击Reset Test Data按钮。为您的用户帐户生成一组完整的测试数据。它包括供应商，发票，报告，客户，支票，帐户等。
• 所有用户都需要在课程开始前安装UiPath Studio(试用版或社区版)。

 

 

•  我注册了下，貌似不行。。。 
• 多试几次刷新下页面，然后底下就会出现选择验证码，然后就能注册成功了。进入页面 按提示操作，先初始化数据。 User Options -> Reset Test Data

然后就可以跟着课程的步骤实现。

 

---

 

二、练习项目

业务场景：

  有一个叫‘UiDemo’的程序，需要实现自动化流程。需要将Excel中的数据，输入到UiDemo中。这个不难，需要一个Read Range读取Excel中的数据范围，存入DataTable，然后遍历DataTable中的每一行，写入到UiDemo程序中。然而，这里的挑战是由于有很多的数据要写入，需要多个机器人同一时间工作，根据解决方案架构师和业务分析，需要将流程分配给多达5个机器人。

这个练习的项目涉及到的东西还挺多的。我一步一步的实现。官网课程也有文档。写的不够详细。我爸自己实现的过程，遇到的问题都记录下。分享学习。回头我也把我的项目上传到GitHub.

1、准备

先到官网下载课程需要的资料。https://academy.uipath.com/learningpath-viewer/1992/1/150802/16

下载Excel和UiDemo.exe文件。还有操作说明文档PDF。

我用的是 UiPath2020.6版本

然后需要先登入Ochestrator，查看机器人是否配置好。

本地打开Assistant，连接成功

 

发现云上的Ochestrator不太稳定，经常掉线。导致流程跑起来的时候 中间会报错，中断。

2、创建REF项目

• 项目名称 UiPath_REFrameWork_UiDemo
• 项目描述：Demonstrating the REFramework with UiDemo

           创建好了文件的目录是这样的：

            

 

 

          解压后将Transactions.xlsx放到DataInput中，如果是老版本的studio 就放到Data目录下就行。

3、创建Dispatcher – UploadQueue.Xaml

点击顶部菜单New，选择Sequence。这是做好的样子。

         

 

 

 

•  添加Read Range 课程里选择的是WorkBook下的ReadRange。Excel下的也能用，用法不太一样。

         

        选择Transactions.xlsx，然后读取Sheet1的内容，Range默认为空，获取全部的数据。这里需要创建一个DataTable类型的数据，来存储Excel中的内容。

 

 

         

 

•  然后添加一个For Each Row 遍历DataTable。在Body中添加一个 Add Queue Item

           需要编辑的属性：ItemInformatica，需要将DataTable中的三列数据插入到Queue中。

                                        QueueName，定义队列名称，需要和Orchestrator上的队列名称一致。

     

 

• Orchestrator上新建队列Queue，名称要和上一步中写的一样。其他的选项都默认就行。

         

 

        

 

        这样就可以了。运行一下。然后看Orchestrator，监控菜单下，就可以看到，将Excel中的数据上传到队列中。有日志数据。

                        

 

 

 4、修改配置文件Config.xlsx

在Data目录中，需要修改Settings页中

• OrchestratorQueueName为上面设置的队列名称
• 然后添加一个UiDemoCredential的值为UiDemoCreDential_REFramework

          

 

          UiDemoCreDential_REFramework需要在Orchestrator中的Asset中先配置好。注意类型type要选择Credential。这个是管理UiDemo.exe登入的账号和密码。为了安全考虑，选择这种方式。studio有提供可以读取Windows的凭证，存在Windows的凭证，然后去获取也行。

    Asset name就是UiDemoCreDential_REFramework，然后指定一个默认值，然后可以选择机器人，可能每台机器人登入的账号和密码不一样，都可以设置。 

        

 

修改Asset页,新增一个UiDemoPath，用来指定UiDemo.exe的存放位置。

然后这个UiDemoPath，一样需要在Orchestrator的Assets中设置好。类型是Text。

 

 

     

 

 

 

 5、创建UiDemo_Login.xaml

在项目目录下新建个文件夹UiDemo subfolder，存放UiDemo_Login.xaml。

建好的流程如图：

 

• 创建参数和变量

Arguments:in_Credential

 

 

 两个变量Username和Password:类型为SecureString

•  先放一个Invoke Workflow File 执行"FrameworkGetAppCredentials.xaml"，这个主要是获取Orchestrator平台上前面设好的用户名和密码。

GetAppCredentials.xaml是框架里面写好的，需要传这几个参数；就是上面定义的参数和变量名称。

 

 

• 完成输入账号密码，并登入UiDemo

这一步需要先打开UiDemo.exe界面，在Main流程中，一开始初始化会先启动UiDemo.exe。

所以我们先打开，需要实现输入登入功能。

添加一个Attach Window，需要先录制到窗口，

Username：Type into 抓取Username输入框，Text属性输入定义的变量Username+回车键

Password：Type Secure Text，在Input的Secure Text输入Password变量名称

Login ：Click

 

 

 

 然后就创建完成！

6、修改InitAllApplications.xaml

 

 

我们需要在InitAllApplications.xaml启动UiDemo.exe

添加一个

 

将selector选择器 选中UiDemo.exe窗口,然后修改FileName值:in_Config("UiDemoPath").ToString

这个值就是初始化的时候 框架里面自带的功能去去掉Config中表格的数据。这边直接这么用就可以了。

 

在添加一个Sequece，添加Invoke workflow file 

传入参数值：in_Config("UiDemoCredential").ToString

 

 

 

 保存！

7、退出程序，杀进程

CloseAllApplications 、KillAllProcesses.

 

 

 

    

 

 

 8、最重要的Process.xaml

主要的业务流程在Process。xaml中实现。

 

 

• 创建这几个变量

 

 

• 添加一个Sequence，对变量赋值   

CashIn=in_TransactionItem.SpecificContent("CashIn").ToString

OnUsCheck=in_TransactionItem.SpecificContent("OnUsCheck").ToString

NotOnUsCheck=in_TransactionItem.SpecificContent("NotOnUsCheck").ToString

 

 

 

• 添加个FlowDecision，条件：Double.TryParse(CashIn, dbl_CashIn) AND Double.TryParse(OnUsCheck, dbl_OnUsCheck) AND Double.TryParse(NotOnUsCheck,dbl_NotOnUsCheck)将字符串类型转为double类型。判断是否有值。

        

没有值得，抛出异常，Throw，异常信息：new BusinessRuleException("Input Data Invalid")

 

有值，继续判断  dbl_CashIn是否大于1000.超过1000则抛出异常：new BusinessRuleException("too large")

 

 小于，就进入UiDemo录入数据。

• 我是用录制的功能，比较方便。Desktop。主要是三个输入框然后一个按钮。

 

 

 

 到这里整个REF框架实现完毕。

然后可以运行，看有什么报错。

9、异常报错信息

 这个可能是Orchestrator链接断开了。经常不稳定。

 

 

 这篇就先写到这里，有问题可以留言，有什么不对的地方也欢迎提出来。一起讨论。