Studio 用户指南

上次更新日期 2025年10月24日

管理变量

在 Studio 中，变量用于存储多种类型的数据。变量的另一个关键之处在于它们的值可以改变以实现多种目的，例如控制循环主体的执行次数。

备注：

变量需要用不同的名称创建，即使在不同的范围中使用也不能名称相同。如果两个变量共享相同名称，但位于不同作用域中，则内部作用域中的变量优先。您可以查看我们的工作流设计命名约定建议。
变量名称必须以字母或下划线 _ 开头。
使用某些关键字（例如“替换”）来命名变量可能会导致意外错误。

从 Studio 的角度来看，变量的名称是其唯一 ID，它定义了变量的显示和使用方式。如果更改或删除，Studio 将无法根据加载的活动解释 .xaml 文件。必须在所有字符串两边加引号。

重要提示：如果“变量”和“参数”的名称相同，则变量始终默认为，并在运行时使用。

您可以通过多种方式管理变量。为了从最佳体验和灵活性中受益，我们建议使用数据管理器。

变量类型

存储在变量中的数据称为值，它可以是多种类型。创建变量时，可选择以下选项：

布尔值 - 此类型只有两个可能的值：true 或 false。这些变量使您能够做出决策，从而更好地控制工作流。
Int32 - 此类型用于存储数字信息。它的一些用途是执行等式，比较和传递重要数据。
字符串 - 存储文本信息。此类变量可用于存储任何基于文本的信息，例如员工姓名、用户名或任何其他字符串。
对象 - 可用于存储不同类型的数据。在变量中存储的数据类型需要比较灵活时，可以使用这种类型的变量。请确保对象变量中使用的数据类型与使用此变量的活动兼容。
System.Data.DataTable - 此类型可存储大量信息，并可充当数据库或包含行和列的简单电子表格。可用于将特定数据从一个数据库迁移到另一个数据库，从网站提取信息并将其以本地方式存储在电子表格，还可用于其他用途。
[T] 数组 - 用于存储同一类型的多个值。
使用 JSON 模式创建类型 - 用于使用 JSON 模式生成新类型，以便更轻松地与 API、复杂对象或智能体交互。选择此选项后，会打开一个窗口，您可以在其中为类型命名，然后写入或粘贴 JSON 模式。
浏览类型 - 让您可以探索更多与您的任务相关的类型。

注意：将项目中使用的语言定义的类型变量用作静态变量会导致 Windows 和跨平台项目中出现编译错误。

变量范围

作用域属性为变量提供了定义良好的上下文，可以在其中使用变量。作用域可以设置为全局（在整个项目中可用）、当前工作流文件或工作流文件中的任何容器活动。

您只能从 Data Manager 创建全局变量。

备注：

全局变量未序列化，因此与长时间运行的持久性活动不兼容。
库项目中不支持全局变量。
在 C# 项目中，在活动中使用全局变量或全局常量需要遵循以下格式：GlobalVariablesNamespace.GlobalVariables.YOUR_GLOBAL_VARIABLE_NAME。在 VB 项目中，您可以直接按名称引用全局变量或全局常量。

创建变量

从 Data Manager

打开数据管理器。
Navigate to the Variables panel.
Select the Create variable line. A new argument is created.
配置变量的名称、数据类型、作用域和默认值。

以此方式创建的变量的默认类型为“字符串”。

通过活动主体

从“活动”面板中，将活动拖动到“设计器”面板。右键单击字段并从上下文菜单中选择“创建变量”，然后按 Ctrl+K，或从字段右侧的加号菜单中选择“创建变量”。系统将显示“设置变量”字段。
填写名称，然后按 Enter 键。变量已创建并在字段中可见。在“数据管理器”中检查变量的作用域和类型。

从表达式

另外，可以通过活动输入字段或“表达式编辑器”直接使用表达式创建变量：

选择表达式的一部分，然后按 Ctrl+K。系统将显示“设置变量”字段。
填写名称，然后按 Enter 键。系统即会创建此变量。在“数据管理器”中检查变量的作用域和类型。

以此方式创建的变量将根据活动自动接收相关类型。例如，如果在“写入范围”活动的 Data Table 字段中创建变量，则变量类型设置为 DataTable。如果在“写入行”活动的 Text 字段中创建变量，则变量类型设置为 String。

此类变量的作用域为其所属的最小容器。系统将根据所选属性自动生成变量类型。

通过属性面板

在任何活动的“属性”面板中，右键单击字段并从上下文菜单中选择“创建变量”，然后按 Ctrl+K，或从字段右侧的加号菜单中选择“创建变量”。系统将显示“设置变量”字段。
填写名称，然后按 Enter 键。变量已创建并在字段中可见。在“数据管理器”中检查变量的作用域和类型。

以此方式创建的变量的作用域为其所属的最小容器。系统将根据所选属性自动生成类型。

从活动输出中自动生成的变量（仅适用于 Windows 和跨平台项目）

如果启用了“自动生成活动输出”设计设置，Studio 会自动为生成输出的活动的每个“输出”字段填充变量。然后，您可以通过选择输入字段右侧的“+” 菜单，然后单击“使用变量”，在其他活动中使用生成的变量。

如果您更喜欢手动创建输出变量，可以在输出字段中执行此操作。这会将生成的变量替换为您创建的变量。如果在手动创建变量后选择“清除值”选项，则系统会还原默认生成的变量。

The generated variable is available in the Variables panel in the Data Manager (if the variable is used in another activity). As with any other variable, you can change the generated variable’s name, data type, scope, and default value.

所生成变量的作用域取决于活动在工作流中的位置（例如，如果活动位于主序列或“遍历循环”活动中，则作用域会有所不同）。如果您复制、剪切或粘贴活动，则系统会更新生成的变量范围。重命名活动不会影响生成的变量。但是，删除活动则会造成以下结果：

如果变量未使用，则清除变量的值。
如果使用变量，并且在使用变量作为输入的活动中显示警告，则删除变量。

删除变量

You can remove variables from the Data Manager:

打开数据管理器。
Navigate to the Variables panel.
右键单击变量，然后选择“删除变量”。或者，将其选中，然后按 Delete 键。

删除未使用的变量

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

注意：如果删除或升级某个包可能导致变量或参数未定义，那么系统将在其位置添加一个“未知类型”，以便能够在 Studio 中打开和编辑该包。

浏览 .Net 变量类型

要搜索“变量类型”列表中默认情况下未显示的变量类型，请执行以下操作：

在“数据管理器”中，从变量的“数据类型”下拉列表中，选择“浏览类型”。您还可以从“变量”面板的“变量类型”下拉列表中访问该菜单。系统将显示“浏览并选择 .Net 类型”窗口。
在“类型名称”字段中，为要查找的变量键入关键字，如 Excel。注意，结果部分已经更新，显示包含您的关键字的所有 .Net 变量类型。
选择一个，然后单击“确定”。系统将使用所选类型创建一个新变量并将其显示在“变量”面板中。

注意：从“浏览并选择 .Net 类型”窗口选择一种变量类型之后，该变量将显示在“变量”面板中的“变量类型”下拉列表中。