Studio 用户指南

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

管理参数

参数用于将一个项目中的数据传递到另一个项目。在全局意义上，它们类似于变量，因为它们动态地存储和传递数据。变量在活动之间传递数据，而参数在自动化之间传递数据。因此，您可借助这些参数反复重用某些项目。

Studio 支持众多参数类型，这些参数类型均与变量类型一致。因此，您可以创建泛型值、字符串、布尔值、对象、数组或数据表参数，还可以浏览 .NET 类型，正如创建变量时一样。

此外，参数有特定方向（输入、输出、输入/输出、属性），这些方向告知应用程序其中存储的信息应前往何处。

重要提示：

如果“变量”和“参数”的名称相同，则变量始终默认为，并在运行时使用。
将复杂的输入参数（例如，类型为 System.Data.DataTable）传递给非隔离的“调用工作流文件”活动就像传递引用一样，这意味着对调用的工作流中的对象进行的任何更改都会更改主工作流中的对象。内置参数类型（例如布尔值）始终作为值传递。

请注意，如果您使用 In 值创建 In/Out 参数并在“调用工作流”活动中使用该参数，然后再将值更改为 Out，您可能会注意到在执行项目时会导致系统抛出错误。这是因为调用工作流活动没有通过引用返回值。在项目中使用“全局处理程序”来访问参数在调用的工作流中对应的确切值。

最后，由于这些参数已在 Orchestrator 中公开，您还可将其集成到公司的其他工具中。这意味着您创建的任何流程现在都可以通过 Orchestrator API 或接口接收输入参数，并向前面提到的所有流程返回输出。有关更多信息，请参见此处。

参数名称应采用大写的驼峰式命名法，并用前缀来指明参数方向，如 in_DefaultTimeout、in_FileName、out_TextResult 和 io_RetryNumber。如需更多详细信息，您可以查阅我们的工作流设计命名约定建议。

打开数据管理器，然后选择“新建”>“新建参数”。
系统将在“参数”下添加一个默认名称为 argument 的新项目。
配置已创建的参数：
- 单击参数名称以编辑其名称。
- 使用参数左侧的箭头展开参数，并设置“方向”、“数据类型”、是否为“必需”，还可选择设置“默认值”。

在数据管理器中，您还可以通过右键单击“参数”节点，然后选择“批量创建参数”来批量创建参数。系统将显示一个新窗口，您可以在其中添加和配置多个参数。

从“活动”面板中，将活动拖动到“设计器”面板。右键单击某字段，并从上下文菜单中选择“创建输入参数”或“创建输出参数”。或者，您也可按 Ctrl+M 或 Ctrl+Shift+M。系统将显示“设置变量”字段。
填写名称，然后按 Enter 键。系统随即会创建此参数并将其显示在相应字段中。在“参数”面板中检查其方向和类型。

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

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

在任意活动的“属性”面板中，右键单击可编辑字段，然后从上下文菜单中选择“创建输入参数”或“创建输出参数”。或者，您也可按 Ctrl+M 或 Ctrl+Shift+M。或者，您也可按 Ctrl+M 或 Ctrl+Shift+M。系统将显示“设置变量”字段。
填写名称，然后按 Enter 键。系统随即会创建此参数并将其显示在相应字段中。在“参数”面板中检查其方向和类型。

系统将根据所选属性自动生成参数类型。