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

课程目标：

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放到\Data\Input中，如果是老版本的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 执行"Framework\GetAppCredentials.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变量名称

然后就创建完成！

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类型。判断是否有值。