- 入门指南
- 设置和配置
- 自动化项目
- 依赖项
- 工作流类型
- 控制流程
- 文件比较
- 自动化最佳实践
- 源代码控件集成
- 调试
- 日志记录
- 诊断工具
- 工作流分析器
- 变量
- 参数
- 导入的命名空间
- 编码自动化
- 基于触发器的 Attended 自动化
- 对象存储库
- ScreenScrapeJavaSupport 工具
- 扩展程序
- Studio 测试
- 故障排除
变量类型
在 Studio 中使用变量类型，包括字符串、通用值、数据表，以及其他受支持的类型，用于存储和处理数据。
文本变量
文本或字符串变量是一种只能存储字符串的变量类型。 这些类型的变量可用于存储任何信息，例如员工名称、用户名或任何其他字符串。
UiPath 中的所有字符串必须放在引号之间。
使用文本变量的示例
为了举例说明如何使用文本变量，我们将创建一个项目，它可询问用户的姓名，然后存储，并在“输出”面板中只显示姓名的第一个字母。
-
创建一个序列。
-
创建两个简单字符串变量：
FullName和FirstLetter。 -
向“设计器”面板中添加输入对话框活动。
-
在“输入标签”字段中，输入“请输入您的全名”。
-
在“对话框标题”字段中输入“您叫什么名字？”。
-
在“输入的值”字段中，添加
FullName变量。此变量存储用户在收到“输入对话框”活动提示时写入的任何内容。 -
在“输入对话框”下添加“赋值活动”。
-
在“属性”面板的“至”字段中，添加
FirstLetter变量。 -
在“值”字段中，键入
FullName.Substring(0,1)。将为FirstLetter变量赋值FullName.Substring(0,1)表达式创建的新值。备注：此字段使用
Substring()函数从用户在“输入对话框”中添加的字符串中查找第一个字符。 -
在“赋值”活动下添加“写入行”活动。
-
在“属性”面板的“文本”字段中，输入
FirstLetter变量。这意味着“输出”面板将显示用户在“输入对话框”中所写内容的第一个字母。该项目应如以下屏幕截图所示。 -
按 F5。系统将显示“您叫什么名字?”窗口。
-
在文本字段中输入您的姓名，然后选择“确定” 。在UiPath Studio 的输出面板中，请注意，系统会显示您姓名的第一个字母。
True 或 False 变量
true 或 false 变量（也称为布尔值变量）是一种变量类型，它只有两个可能的值：true 或 false。这些变量使您能够做出决策，从而更好地控制流程。
使用 True 或 False 变量的示例
为了举例说明如何处理 True 或 False变量，我们将创建一个自动化，它可询问用户的姓名和性别，并在另一个窗口中显示结果。
-
创建新的流程并添加流程图。
-
创建两个字符串变量：
Name和Gender。第一个用于存储用户的姓名，第二个用于存储用户的性别。 -
创建一个布尔值变量
Male。此变量将用于验证用户是否为男性。 -
将“输入对话框”活动添加到“设计器”面板，并将其连接到“开始”节点。
-
在“属性”面板的“标签”字段中，键入“您叫什么名字?”。
-
添加标题，然后在“结果”字段中，添加
Name变量。 -
添加另一个“输入对话框”活动，然后将其连接到上一个“输入对话框”活动。
-
在“属性”面板的“标签”字段中，键入“您的性别是?”。
-
添加标题，然后在“结果”字段中，添加
Gender变量。 -
将“流决策”活动添加到“设计器”面板，并将其连接到第二个输入对话框。
-
在“属性”面板的“条件”字段中，键入
Gender= “Male” 或Gender= “male”。此活动检查用户是男性还是女性。 -
添加两个“赋值”活动。
-
将一个活动连接到流程决策活动的 True 分支。
-
在“属性”面板的“至”字段中，输入
Male变量。 -
在“值”字段中，键入“True”当满足
Gender= “Male”或Gender= “male”条件时，会为Male变量赋值“True”。 -
将第二个“赋值”活动连接到“流程决策”的“False”分支。
-
在“属性”面板的“至”字段中，输入
Male变量。 -
在“值”字段中，键入“False”。当不满足
Gender= “Male”或Gender= “male”条件时，会为Male变量赋值“False”。 -
添加一个新的“流程决策”，并将先前添加的“赋值”活动连接到它。
-
在“属性”面板的“条件”字段中，键入
Male= True。 -
添加“消息框”活动，并将其连接到“流决策”的“真实”分支。
-
在“属性”面板的“文本”字段中，键入
Name+ “是” +Gender+ “。”。如果Male为 true，则此消息显示用户的姓名和性别。 -
添加另一个“消息框”活动并将其连接到“流程决策”的“False”分支。
-
在“属性”面板的“文本”字段中，键入
Name+ “是” +Gender+ “。”。如果Male为 false，则此消息显示用户的姓名和性别。最终的项目应如以下屏幕截图所示。 -
按 F5。系统将执行自动化。注意，最终的“消息框”按预期显示消息。
数字变量
数字变量也称为整数或 Int32，用于存储数字信息。它们可用于执行等式或比较，传递重要数据等。
使用数字变量的示例
为了举例说明如何处理数字变量，我们将创建一个自动化，它可询问用户出生的年份，并在窗口中显示年龄。
-
创建一个新序列。
-
创建两个 Int32 变量：
BirthYear和Age。第一个变量存储用户的出生年份，第二个变量存储用户的年龄。 -
将“输入对话框”活动添加到序列中。
-
在“对话框标题”和“输入标签”字段中，输入适当的标题和标签。
-
在“输入的值”字段中，添加
BirthYear变量。 -
在“输入对话框”下添加“赋值”活动。
-
在“属性”面板的“至”字段中，添加
Age变量。 -
在“值”字段中，输入
2022 – BirthYear。这样会将减后的值（2022 减去用户出生年份）赋值给Age变量。 -
在“赋值”活动下添加“消息框”活动。
-
在“属性”面板的“文本”字段中，键入“恭喜!您是“ +
Age.ToString+ “。”。:::note The `.ToString` method converts the integer stored in the `Age` variable to a string and displays it as such. ::::::note The `.ToString` method converts the integer stored in the `Age` variable to a string and displays it as such. :::项目的最终呈现应如以下屏幕截图所示。
-
按 F5。系统将执行自动化。注意，“消息框”应当显示您的年龄。
数组变量
数组变量是一种用于存储同一类型的多个值的变量。
UiPath Studio 支持的数组类型与支持的变量类型一样多。这意味着您可以创建由数字、一个字符串、一个布尔值等组成的一个数组。
使用数组变量的示例
为了举例说明如何使用数组变量，我们将创建一个自动化项目，以询问用户的姓名和年龄，将信息存储在数组中，然后将其写入 .txt 文件。
-
创建一个新序列。
-
创建三个字符串变量
FirstName、LastName和Age，用于存储从用户收集的信息。 -
创建名为
NameAge的字符串变量数组。 -
向“设计器”面板中添加输入对话框活动。
-
Fill in the Dialog Title and Input Label fields to ask for the user’s first name.
-
In the Value entered field, type the
FirstNamevariable. This variable stores the first name of the user. -
在上一个“输入对话框”活动下添加另一个“输入对话框”活动。
-
填写“对话框标题”和“输入标签”字段，以询问用户的姓氏。
-
In the Value entered field, type the
LastNamevariable. This variable is going to store the last name of the user. -
在上一个“输入对话框”活动下添加另一个“输入对话框”活动。
-
Fill in the Dialog Title and Input Label fields to ask for the user’s age.
-
在“输入的值”字段中，输入
Age变量。此变量将存储用户的年龄。:::note We use a string variable and not an integer to store the age, so that we do not have to convert it later on, when we add it to the string array variable. ::::::note We use a string variable and not an integer to store the age, so that we do not have to convert it later on, when we add it to the string array variable. ::: -
在最后一个输入对话框下添加“赋值”活动。
-
在“属性”面板中，在“至”字段中键入
NameAge变量。 -
在“值”字段中，键入 {
FirstName,LastName,Age}。此“赋值”活动用于将初始字符串变量中的所有值存储在NameAge中。 -
在“赋值”活动下添加一个“写入文本文件”活动。
-
在“属性”面板的“文件名”字段中，键入要写入到的文件路径，并加上引号，例如
"%HOMEPATH%\Desktop\array_variable.txt"。:::note If the file does not exist at the provided path, it is created. ::::::note If the file does not exist at the provided path, it is created. ::: -
在“文本”字段中，键入
NameAge(0)+ “ ” +NameAge(1)+ “ ” +NameAge(2)+ “ ”。:::note By adding the index number of the array items you can access their values and write them, in this example, to a text file. ::::::note By adding the index number of the array items you can access their values and write them, in this example, to a text file. :::项目的最终呈现应如以下屏幕截图所示。
-
按 Ctrl + F5 以运行项目。
-
导航到步骤 17 中提供的文件，然后打开该文件。系统将显示一个“记事本”窗口，其中包含您在步骤 20 中添加的信息。
日期和时间变量
日期和时间变量是一种变量类型，用于存储有关任何日期和时间的信息。 这种类型的变量可以在“浏览并选择 .Net 类型”窗口中的System.DateTime“系统命名空间”下找到。 有关更多信息，请参阅“浏览 .Net 变量类型”。
例如，它们可以用于将日期附加到发票中，或者附加到您可能正在处理并且对时间敏感的任何其他文档中。
使用日期和时间变量的示例
为了举例说明如何使用日期和时间变量，我们将构建一个自动化，它获取当前日期和时间，减去特定的一段时间并将结果写入 Microsoft Excel 电子表格。
-
创建一个新序列。
-
创建两个日期时间变量：
Today和LastTime。 -
创建一个名为“
Span”的时间跨度变量，并在“默认值”字段中键入1.02:10:04。备注：构成
Span变量的默认值使用 day.hh:mm:ss 格式。 -
将“赋值”活动添加到“设计器”面板。
-
在“属性”面板的“至”字段中，添加
Today变量。 -
在“值”字段中，键入
Now。如此，您便可获得项目执行的日期和时间，其格式分别为dd/MM/yyyy和hh:mm:ss。 -
在上一个活动下添加另一个“赋值”活动。
-
在“属性”面板的“至”字段中，添加
LastTime变量。 -
在“值”字段中，键入
Today.Subtract(Span)。这将从当前日期中减去Span变量的默认值，该日期存储在Today变量中。 -
在最后一个“赋值”活动下添加“Excel 流程作用域”活动。 此活动可打开或重用 Excel 流程，加载 Excel 项目设置，并将其应用于关联的 Excel 文件。
-
在 Excel 流程作用域活动中添加“使用 Excel 文件”活动。
:::note Use the [Manage Packages](https://docs.uipath.com/studio/standalone/2024.10/user-guide/managing-activities-packages#managing-packages) feature to download the Excel activities, if you do not already have them installed. ::::::note Use the [Manage Packages](https://docs.uipath.com/zh-CN/studio/standalone/2024.10/user-guide/managing-activities-packages#managing-packages) feature to download the Excel activities, if you do not already have them installed. ::: -
在“Workbook 路径”字段中，在引号之间输入要写入的 Excel 文件的路径。在我们的示例中为
"%HOMEPATH%\Desktop\urgent_invoice.xlsx"。:::note If the file does not exist at the provided path, it is going to be created. ::::::note If the file does not exist at the provided path, it is going to be created. ::: -
在“使用 Excel 文件”活动中添加“写入单元格”活动。
-
在“写入内容”字段中，输入
LastTime.ToString。这会将LastTime变量的值转换为字符串，并将其写入先前给出的坐标。 -
在“写入位置”字段的右侧，选择加号
>“Excel”> “在 Excel 中指明”。 -
在 Excel 文件中，指定要写入内容的单元格（在本例中为“E3”）。指定单元格后选择“确认” 。
项目的最终呈现应如以下屏幕截图所示：
17. 按 F5。系统将执行自动化。18. 导航到 Excel 文件，然后打开您添加日期的单元格。请注意，时间和日期信息显示在您指向的单元格中。
数据表变量
“数据表”变量表示一种类型的变量，可以存储大量信息，并充当数据库或包含行和列的简单电子表格。它们位于“浏览并选择 .Net 类型”窗口中“System.Data 命名空间”下方 (System.Data.DataTable)。有关更多信息，请参阅浏览 .Net 变量类型。
这些变量可用于将特定数据从一个数据库迁移到另一个数据库，从网站提取信息并将其以本地方式存储在电子表格和许多其他文件中。
使用数据表变量的示例
为了举例说明如何使用“数据表”变量，我们将创建一个自动化，它仅从 Excel 电子表格中的多个列中读取两个列，然后将这两个列传输到另一个已经包含其他信息的电子表格中。
初始文件是人员、事务、日期和产品的数据库。在该示例中，我们将提取它们的名称和订单日期，并将其附加到已经包含类似信息的 Excel 电子表格中。
-
创建一个新序列。
-
添加“Excel 流程作用域”活动。此活动可打开或重用 Excel 流程，加载 Excel 项目设置，并将其应用于关联的 Excel 文件。
-
向序列中添加“使用 Excel 文件”活动。大多数与 Excel 相关的活动都需要此活动。
备注：如果您的 UiPath 版本中没有安装 Excel 活动，请使用“管理包”功能来获得这些活动。
-
创建两个数据表变量：
dt_NamesList和dt_DateInfo。这两个变量将用于存储初始 Excel 电子表格中的信息。 -
在“属性”面板的“Workbook 路径”字段中，输入要使用的初始 Excel 文件的路径，并在两边加引号。
-
添加两个“读取范围”活动，并将它们一个放在“使用 Excel 文件”活动下。 这些用于从初始电子表格中获取信息。
-
选择第一个“读取范围”活动。在“范围”字段右侧，选择“加号”
> Excel >在 Excel 中指定。 -
在 Excel 文件中，指定用于告诉 UiPath Studio 从何处提取信息的坐标（在本例中为“G7:G37”）。选择范围后选择“确认” 。
-
在“保存到”字段中，输入第一个数据表变量的名称
dt_NamesList。此变量存储 G7 和 G37 行之间的所有可用信息。 -
（可选）将“显示名称”字段中的值更改为“读取名称”，这样您就可以很容易将此活动与第二个活动区分开。
-
选择第二个“读取范围”活动。在“范围”字段右侧，选择“加号”
> Excel >在 Excel 中指定。 -
在 Excel 文件中，指定包含要提取的订单日期的坐标（在本例中为“C7:C37”）。选择范围后选择“确认” 。
-
在“保存到”字段中，指定
dt_DateInfo变量。此变量保留我们需要的所有日期信息。 -
向序列中添加第二个“使用 Excel 文件”活动。
-
在“属性”面板的“Workbook 路径”字段中，输入要用于存储在先前步骤中收集的所有信息的 Excel 文件的路径。
-
将“将数据表写入 Excel”活动添加到“设计器”面板的第二个“使用 Excel 文件”下。 此活动用于将存储的信息写入另一个 Excel 文件。
:::note The file used with the **Write Range** activity has to be closed when you run the project. If it is not closed, an error is displayed and the automation execution stops. ::::::note The file used with the **Write Range** activity has to be closed when you run the project. If it is not closed, an error is displayed and the automation execution stops. ::: -
在“写入内容”字段中，输入
dt_NamesList变量。 -
选择“目标”字段右侧的加号
>“Excel”>“在 Excel 中指定”。 -
在第二个 Excel 文件中，选择要添加初始文件信息的起始单元格（在本例中为“B7”）。选择“确认”。
-
添加另一个“将数据表写入 Excel”活动，并将其放在第一个活动下面。
-
在“写入内容”字段中，输入
dt_DateInfo变量。 -
选择“目标”字段右侧的加号
>“Excel”>“在 Excel 中指定”。 -
选择起始单元格（在本例中为“A7”）。选择“确认”。
-
按 F5。系统将执行您的自动化。
-
打开最终的 Excel 文件。请注意，复制的信息可用，并且已正确更新。