studio
2023.4
false
UiPath logo, featuring letters U and I in white

Studio 用户指南

上次更新日期 2024年12月17日

变量类型

文本变量

文本或字符串变量是一种只能存储字符串的变量类型。这些类型的变量可用于存储任何信息,如员工姓名、用户名或任何其他字符串。

注意:UiPath 中的所有字符串必须放在引号之间。

使用文本变量的示例

为了举例说明如何使用文本变量,我们将创建一个项目,它可询问用户的姓名,然后存储,并在“输出”面板中只显示姓名的第一个字母。

  1. 创建一个序列。
  2. 创建两个简单字符串变量:FullNameFirstLetter


  3. 设计器面板中添加输入对话框活动。
  4. 在“输入标签”字段中,输入“请输入您的全名”。
  5. 在“对话框标题”字段中输入“您叫什么名字?”。
  6. 在“输入的值”字段中,添加 FullName 变量。此变量存储用户在收到“输入对话框”活动提示时写入的任何内容。
  7. 输入对话框活动下添加赋值活动。
  8. 属性面板的字段中,添加 FirstLetter 变量。
  9. 字段中,键入 FullName.Substring(0,1)。将为 FirstLetter 变量赋值由 FullName.Substring(0,1) 表达式创建的新值。
    注意:此字段使用 Substring() 函数从用户在“输入对话框”中添加的字符串中查找第一个字符。
  10. “赋值”活动下添加“写入行”活动。
  11. 属性面板的文本字段中,输入 FirstLetter 变量。这意味着“输出”面板将显示用户在“输入对话框”中所写内容的第一个字母。该项目应如以下屏幕截图所示。


  12. 按 F5。系统将显示“您叫什么名字?”窗口。
  13. 在文本字段中输入您的姓名,然后单击“确定”。在 UiPath Studio输出面板中,请注意,系统会显示您姓名的第一个字母。


True 或 False 变量

true 或 false 变量(也称为布尔值变量)是一种变量类型,它只有两个可能的值:true 或 false。这些变量使您能够做出决策,从而更好地控制流程。

使用 True 或 False 变量的示例

为了举例说明如何处理 True 或 False变量,我们将创建一个自动化,它可询问用户的姓名和性别,并在另一个窗口中显示结果。

  1. 创建新的流程并添加流程图
  2. 创建两个字符串变量:NameGender。第一个用于存储用户的姓名,第二个用于存储用户的性别。
  3. 创建一个布尔值变量 Male。此变量将用于验证用户是否为男性。


  4. 设计器面板中添加输入对话框活动,并将其连接到开始节点。
  5. 属性面板的标签字段中,键入“您叫什么名字?”。
  6. 添加标题,然后在结果字段中,添加 Name 变量。
  7. 添加另一个“输入对话框”活动,然后将其连接到上一个“输入对话框”活动。
  8. 属性面板的标签字段中,键入“您的性别是?”。
  9. 添加标题,然后在结果字段中,添加 Gender 变量。
  10. 设计器面板中添加流程决策活动,并将其连接到第二个输入对话框
  11. 属性面板的条件字段中,键入 Gender = "Male" 或 Gender = "male"。此活动检查用户是男性还是女性。
  12. 添加两个“赋值”活动。
  13. 将一个活动连接到流程决策活动的 True 分支。
  14. 属性面板的字段中,输入 Male 变量。
  15. 字段中,键入 True。当满足 Gender = "Male" 或 Gender = "male" 条件时,会为 Male 变量赋值 True
  16. 将第二个赋值活动连接到流程决策False 分支。
  17. 属性面板的“至”字段中,输入 Male 变量。
  18. 字段中,键入 False。当不满足 Gender = "Male" 或 Gender = "male" 条件时,会为 Male 变量赋值“False”
  19. 添加一个新的流程决策,并将先前添加的赋值活动连接到它。
  20. 属性面板的条件字段中,键入 Male = True。
  21. 添加消息框活动,并将其连接到流程决策True 分支。
  22. 属性面板的文本字段中,键入 Name + “是” + Gender + “。”。如果 Male 为 true,则此消息显示用户的姓名和性别。
  23. 添加另一个消息框活动并将其连接到流程决策False 分支。
  24. 属性面板的文本字段中,键入 Name + “是” + Gender + “。”。如果 Male 为 false,则此消息显示用户的姓名和性别。最终的项目应如以下屏幕截图所示。


  25. 按 F5。系统将执行自动化。请注意,最终的消息框将按预期显示消息。


数字变量

数字变量也称为整数或 Int32,用于存储数字信息。它们可用于执行等式或比较,传递重要数据等。

使用数字变量的示例

为了举例说明如何处理数字变量,我们将创建一个自动化,它可询问用户出生的年份,并在窗口中显示年龄。

  1. 创建一个新序列。
  2. 创建两个 Int32 变量:BirthYearAge。第一个变量存储用户的出生年份,第二个变量存储用户的年龄。
  3. “输入对话框”活动添加到序列中。
  4. 在“对话框标题”和“输入标签”字段中,输入适当的标题和标签。
  5. 在“输入的值”字段中,添加 BirthYear 变量。
  6. 输入对话框下添加赋值活动。
  7. 属性面板的字段中,添加 Age 变量。
  8. 在“值”字段中,键入 2022 – BirthYear。这样会将减后的值(2022 减去用户出生年份)赋值给 Age 变量。
  9. 赋值活动下添加消息框活动。
  10. 属性面板的文本字段中,键入“恭喜!您是 " + Age.ToString + “。”。
    注意:.ToString 方法将 Age 变量中存储的整数转换为字符串,并将其显示为字符串。

项目的最终呈现应如以下屏幕截图所示。



11. 按 F5。系统将执行自动化。请注意,消息框将按预期显示您的年龄。



数组变量

数组变量是一种用于存储同一类型的多个值的变量。

UiPath Studio 支持的数组类型与支持的变量类型一样多。这意味着您可以创建由数字、一个字符串、一个布尔值等组成的一个数组。

使用数组变量的示例

为了举例说明如何使用数组变量,我们将创建一个自动化项目,以询问用户的姓名和年龄,将信息存储在数组中,然后将其写入 .txt 文件。
  1. 创建一个新序列。
  2. 创建三个字符串变量 FirstNameLastNameAge,用于存储从用户收集的信息。
  3. 创建名为 NameAge 的字符串变量数组。


  4. 设计器面板中添加输入对话框活动。
  5. 填写“对话框标题”和“输入标签”字段,以询问用户的名字。
  6. 在“输入的值”字段中,输入 FirstName 变量。此变量存储用户的名字。
  7. 在上一个“输入对话框”活动下添加另一个“输入对话框”活动。
  8. 填写“对话框标题”和“输入标签”字段,以询问用户的姓氏。
  9. 在“输入的值”字段中,输入 LastName 变量。此变量将存储用户的姓氏。
  10. 在上一个“输入对话框”活动下添加另一个“输入对话框”活动。
  11. 填写“对话框标题”和“输入标签”字段,以询问用户的年龄。
  12. 在“输入的值”字段中,输入 Age 变量。此变量将存储用户的年龄。
    注意:我们使用一个字符串变量(而不是整数)来存储年龄,这样以后当我们将年龄添加到字符串数组变量时,我们就不必转换。
  13. 在最后一个输入对话框下添加赋值活动。
  14. “属性”面板中,在“至”字段中键入 NameAge 变量。
  15. “值”字段中,键入 {FirstName,LastName,Age}。此“赋值”活动用于将初始字符串变量中的所有值存储在 NameAge 中。
  16. 赋值活动下添加一个写入文本文件活动。
  17. 属性面板的文件名字段中,键入要写入到的文件路径,并加上引号,例如 "%HOMEPATH%\Desktop\array_variable.txt"
    注意:如果提供的路径中不存在该文件,则系统将创建该文件。
  18. 文本字段中,键入 NameAge(0) + “ ” + NameAge(1) + “ ” +NameAge(2) + “ ”。
    注意:通过添加数组项的索引号,您可以访问它们的值并可以将它们写入到文本文件(限本示例)。

    项目的最终呈现应如以下屏幕截图所示。



  19. 按 Ctrl + F5 以运行项目。
  20. 导航到步骤 17 中提供的文件,然后双击该文件。系统将显示一个“记事本”窗口,其中包含您在步骤 20 中添加的信息。


日期和时间变量

日期和时间变量是一种用于存储有关任何日期和时间的信息的变量。 此类变量位于“ 浏览并选择 .Net 类型 ”窗口的系统命名空间 System.DateTime下。 有关更多信息,请参阅 浏览 .Net 变量类型

例如,它们可以用于将日期附加到发票中,或者附加到您可能正在处理并且对时间敏感的任何其他文档中。

使用日期和时间变量的示例

为了举例说明如何使用日期和时间变量,我们将构建一个自动化,它获取当前日期和时间,减去特定的一段时间并将结果写入 Microsoft Excel 电子表格。

  1. 创建一个新序列。
  2. 创建两个日期时间变量:TodayLastTime
  3. 创建一个名为 Span 的时间跨度变量,并在默认值字段中键入 1.02:10:04
    注意:构成 Span 变量的默认值使用 day.hh:mm:ss 格式。
  4. 向“设计器”面板中添加将“赋值”活动。
  5. 属性面板的字段中,添加 Today 变量。
  6. 字段中,键入 Now。您可借此获得项目执行的日期和时间,格式为 dd/MM/yyyyhh:mm:ss
  7. 在上一个活动下添加另一个“赋值”活动。
  8. 属性面板的字段中,添加 LastTime 变量。
  9. 在“值”字段中,键入 Today.Subtract(Span)。这将从 Span 变量中存储的当前日期和时间减去 Today 变量的默认值。
  10. 在最后一个“分配”活动下添加“Excel 流程作用域”活动。此活动可打开或重用 Excel 流程,加载 Excel 项目设置,并将其应用于关联的 Excel 文件。
  11. 在“Excel 流程作用域”活动中添加“使用 Excel 文件”活动。
    注意: 如果尚未安装 Excel 活动,请使用 管理包 功能下载这些活动。
  12. 在“Workbook 路径”字段中,在引号之间输入要写入的 Excel 文件的路径。在我们的示例中为 "%HOMEPATH%\Desktop\urgent_invoice.xlsx"
    注意:如果提供的路径中不存在该文件,则系统将创建文件。
  13. 在“使用 Excel 文件”活动中添加“写入单元格”活动。
  14. 在“写入内容”字段中,输入 LastTime.ToString。这会将 LastTime 变量的值转换为字符串,并将其写入先前给出的坐标。
  15. 在“写入位置”字段的右侧,选择加号 docs image >“Excel”> “在 Excel 中指明”
  16. 在 Excel 文件中,指定要写入内容的单元格(在本例中为“E3”)。指定单元格后,单击“确认”

    项目的最终呈现应如以下屏幕截图所示:



  17. 按 F5。系统将执行自动化。
  18. 导航到您的 Excel 文件,双击添加了日期的单元格。请注意,时间和日期信息显示在您指向的单元格中。


数据表变量

“数据表”变量表示一种类型的变量,可以存储大量信息,并充当数据库或包含行和列的简单电子表格。它们位于“浏览并选择 .Net 类型”窗口中“System.Data 命名空间”下方 (System.Data.DataTable)。有关更多信息,请参阅浏览 .Net 变量类型

这些变量可用于将特定数据从一个数据库迁移到另一个数据库,从网站提取信息并将其以本地方式存储在电子表格和许多其他文件中。

使用数据表变量的示例

为了举例说明如何使用“数据表”变量,我们将创建一个自动化,它仅从 Excel 电子表格中的多个列中读取两个列,然后将这两个列传输到另一个已经包含其他信息的电子表格中。

初始文件是人员、事务、日期和产品的数据库。在该示例中,我们将提取它们的名称和订单日期,并将其附加到已经包含类似信息的 Excel 电子表格中。

  1. 创建一个新序列。
  2. 添加“Excel 流程作用域”活动。此活动可打开或重用 Excel 流程,加载 Excel 项目设置,并将其应用于关联的 Excel 文件。
  3. 向序列中添加“使用 Excel 文件”活动。大多数与 Excel 相关的活动都需要此活动。
    注意:如果您的 UiPath 版本中没有安装 Excel 活动,请使用管理包功能来获得这些活动。
  4. 创建两个数据表变量:dt_NamesListdt_DateInfo。这两个变量将用于存储初始 Excel 电子表格中的信息。
  5. 在“属性”面板的“Workbook 路径”字段中,输入要使用的初始 Excel 文件的路径,并在两边加引号。
  6. 添加两个“读取范围”活动,并在“使用 Excel 文件”活动中将这两个活动上下放置。这些活动用于从初始电子表格中获取信息。
  7. 选择第一个“读取范围”活动。选择“范围”字段右侧的加号 docs image >“Excel”>“在 Excel 中指定”
  8. 在 Excel 文件中,指定用于告诉 UiPath Studio 从何处提取信息的坐标(在本例中为“G7:G37”)。选择范围后,单击“确认”
  9. 在“保存位置”字段中,输入第一个数据表变量的名称 dt_NamesList。此变量存储 G7 和 G37 行之间的所有可用信息。
  10. 可选)将“显示名称”字段中的值更改为“读取名称”,这样您就可以很容易将此活动与第二个活动区分开。
  11. 选择第二个“读取范围”活动。选择“范围”字段右侧的加号 docs image >“Excel”>“在 Excel 中指定”
  12. 在 Excel 文件中,指定包含要提取的订单日期的坐标(在本例中为“C7:C37”)。选择范围后,单击“确认”
  13. 在“保存位置”字段中,指定 dt_DateInfo 变量。此变量保留我们需要的所有日期信息。
  14. 向序列中添加第二个“使用 Excel 文件”活动。
  15. 在“属性”面板的“Workbook 路径”字段中,输入要用于存储在先前步骤中收集的所有信息的 Excel 文件的路径。
  16. 将“将数据表写入 Excel”活动添加到“设计器”面板的第二个“使用 Excel 文件”下。此活动用于将存储的信息写入另一个 Excel 文件。
    注意:运行项目时,必须关闭与写入范围活动一起使用的文件。如果未关闭,则系统会显示错误并停止自动化执行。
  17. 在“写入内容”字段中,输入 dt_NamesList 变量。
  18. 选择“目标”字段右侧的加号 docs image >“Excel”>“在 Excel 中指定”
  19. 在第二个 Excel 文件中,选择要添加初始文件信息的起始单元格(在本例中为“B7”)。单击“确认”
  20. 添加另一个“将数据表写入 Excel”活动,并将其放在第一个活动下面。
  21. 在“写入内容”字段中,输入 dt_DateInfo 变量。
  22. 选择“目标”字段右侧的加号 docs image >“Excel”>“在 Excel 中指定”
  23. 选择起始单元格(在本例中为“A7”)。单击“确认”


  24. 按 F5。系统将执行您的自动化。
  25. 双击最终的 Excel 文件。请注意,复制的信息是可用的,并且正确更新。


此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。