【UiPath2022+C＃】UiPath变量和参数

UiPath变量和参数

环境

UiPath Studio Community 2022.4.3

Windows

C#

概述

本课程介绍两种独立的构造，在任何软件开发流程中，这两种构造都是最基本的要素：

• 变量和参数，或者说是如何在各种活动和工作流之间收集、存储、处理和传递数据；
• 控制流程，或者说是如何在整个流程中执行活动、指令和函数的调用。

学完本课程后，您将能够：

• 区分 UiPath 中最常用的变量和参数类型；
• 创建自动化项目所需要的变量，并根据规范配置项目属性；
• 利用控制流程的概念构建可靠而高效的自动化项目；
• 区分 UiPath 中最常用的控制流程语句（If 语句、循环和切换），并根据规范进行配置。

变量

变量是一种容器，可以存储同一数据类型的多个数据条目（值）。例如，emailAddress 可以是一个存储“[email protected]”值的变量。通过外部输入、数据操作或将数据从一个活动传递到另一个活动，您可以更改变量的值。

通过变量的属性可以对变量进行配置。您可以在“变量”面板中设置变量的属性。UiPath 中的主要属性包括：

名称

变量名要尽可能一目了然，便于其他开发者阅读您的自动化项目代码，从而节省时间。

变量类型

定义变量中可以存储哪些类型的数据。在 UiPath 中，创建变量时就会声明变量的数据类型，不过，某些特定类型更通用，可用于存储不同类型的数据。下面详细介绍了变量的数据类型。

默认值

变量一般有初始值，在整个开发流程中，变量值会不断发生更改。如果在创建变量时未分配初始值，通常会有分配值的默认规则。

作用域

工作流中可以使用变量的"范围。有些变量可能是全局变量，还有一些变量可能是局部变量。实际自动化场景中可能会使用很多变量。如非必需，将过多变量设置为全局变量可能导致出现效率问题，还可能会造成混淆。

在 UiPath 中，开发者不必处理某些其他属性（如生命周期或内存位置），其他编程语言则不然。

创建变量

在 UiPath 中有 3 种方法可以创建变量：

• 从“变量”面板创建 – 打开“变量”面板，选择“创建新变量”选项，然后根据需要填写相应的字段。如果需要，请在“设计器”面板中或需要的“属性”字段中提供变量的名称。
  

• 从“设计器”面板创建 – 拖动具有可见变量字段的活动（即“分配”），然后按 Ctrl+K。为变量命名，然后在“变量”面板中检查其属性。
  

  或者
  

• 从“属性”面板创建 – 在活动的“属性”面板中，将光标放在需要输入变量的字段中（即“输出”），然后按 Ctrl+K。为变量命名，然后在“变量”面板中检查其属性。
  

删除变量

要删除变量，请在“变量”面板中，右键单击该变量并选择“删除”，或者选择该变量并按“删除”键。

要删除在“变量”面板中定义但未在当前文件中任何位置使用的所有变量，请在 Studio 功能区中，选择“删除未使用项”>“变量”，然后在系统提示确认时选择“是”。这也将删除未使用但在注释中提及的变量。

步骤

• 首先，我们创建了一个序列项目，然后创建了类型为字符串且作用于为全局的变量 username。
• 我们使用了输入对话框活动，并在活动的结果属性字段中输入了变量 (username ) 的名称。该活动会将用户输入存储在 username 变量中。
• 我们定义了一个新的字符串变量（名为 status），并使用分配活动为其填入了值“已登录”。
• 我们使用了日志消息活动，并且在输出面板中使用表达式 username + status 打印了 2 个变量的值。

创建流程

创建变量

创建输出

效果

文档

管理变量
变量类型

补充

• 使用一目了然且一致的命名约定 - 最常用的命名约定之一是驼峰拼写法（词组中间每个单词的首字母均大写）

• 确保正确定义作用域每个变量的作用域 - 请记住，不能将定义了有限作用域的变量作为全局变量使用。同时，在实际自动化场景中，务必在定义变量时将其作用域限定在使用范围内。如非必需，将过多变量设置为全局变量可能导致出现效率问题，还可能会造成混淆。

• 请写好注释和活动的命名

参数

在 UiPath 中，变量的作用域不能超出定义的变量所在的工作流范围。由于业务自动化项目一般不止包含一个工作流，因此必须使用参数。

参数与变量十分相似 – 可以动态存储数据，具有相同的数据类型，并且支持相同的方法。区别在于参数是在工作流之间传递数据，因此它们具有附加属性 – 即数据传递方向，包括输入、输出以及输入/输出。

创建参数

参数名称应采用大写的驼峰式命名法，并用前缀来指明参数方向，如 in_DefaultTimeout、in_FileName、out_TextResult 和 io_RetryNumber。

在 UiPath 中有 4 种方法可以创建参数：

• 通过活动主体

  1. 将“活动”面板中的一个活动拖动到“设计器”面板。右键单击某字段，并从上下文菜单中选择“创建输入参数”或“创建输出参数”。或者，您也可按 Ctrl+M 或 Ctrl+Shift+M。系统随即会显示“设置参数”字段。

  2. 填写名称，然后按 Enter 键。系统随即会创建此参数并将其显示在相应字段中。在“参数”面板中检查其方向和类型。
     

     或者
     

• 从表达式

  1. 选择表达式的一部分，然后按住 Ctrl + M 或 Ctrl + Shift + M。显示“设置参数”字段。

  2. 填写名称，然后按 Enter 键。系统即会创建此参数。在“参数”面板中检查参数的类型和方向。

  

• 通过属性面板

  1. 在任意活动的“属性”面板中，右键单击可编辑字段，然后从上下文菜单中选择“创建输入参数”或“创建输出参数”。或者，您也可按 Ctrl+M 或 Ctrl+Shift+M。系统随即会显示“设置参数”字段。

  2. 填写名称，然后按 Enter 键。系统随即会创建此参数并将其显示在相应字段中。在“参数”面板中检查其方向和类型。

  

• 通过参数面板

  1. 在“设计器”面板中，单击“参数”。
  2. 单击“创建参数”行，并填写名称。系统随即会创建新参数。
     

使用参数

1. 创建一个新序列。

2. 在“参数”面板中，创建参数 out_StoreValue。

3. 从“方向”列表中，选择“输出”，请勿将“参数类型”从“字符串”改为其他值。

4. 向“设计器”面板中添加将“赋值”活动。

5. 在“属性”面板的“目标”字段中，添加 out_StoreValue 参数。

6. 在“值”字段中输入字符串，例如“如何使用参数？”。
   第一种自动化应如以下屏幕截图所示。

   

7. 创建一个新序列。

8. 创建一个字符串变量 FinalValue。

9. 向“设计器”面板中添加“调用工作流文件”活动。

10. 在活动中，单击“浏览(…)”按钮并浏览之前创建的序列。

11. 单击“导入参数”。系统将显示“调用的工作流的参数”窗口。注意，第一个序列的参数显示在这里。

12. 在“值”字段中，添加 FinalValue 变量，然后单击“确定”。参数即已导入，而且其中的值将通过 FinalValue 变量存储在当前项目中。

13. 在“调用工作流文件”下添加“消息框”活动。

14. 例如，在“属性”面板的“文本”字段中，键入 FinalValue +“这要如何操作？”。
    第二种自动化应如以下屏幕截图所示。

15. 在第二个序列中按 F6。系统将正确执行自动化，消息框将显示所需的文本。

文档

管理参数
使用参数