我们已经公开了 Studio 中您已熟悉的 In 和 Out 参数,以无缝集成您使用的工具(例如各种 DCM 或 BPM)。这意味着您创建的任何流程现在都可以通过 Orchestrator API 或接口接收输入参数,并向前面提到的所有流程返回输出。最后,这有助于将流程链接到一起。此可扩展性可帮助您更好地将 UiPath 集成到公司的生态系统中。
重要
只有在 Studio 中标记为“主要”的
.xaml
的 In、Out 和 In/Out 参数才会公开给其他应用。
参数保存在项目的project.json
中。
在设计时,在 Studio 中,通过配置项目以接受输入或输出参数(带有或不带有默认值)的方式,使您可以在其他第三方应用程序或 Orchestrator 中使用它们。如果您事先在 Studio 项目中添加了相应的参数,则只能使用 Orchestrator 和其他第三方应用程序中的输入和输出参数。如果在 Studio 中未添加任何参数,则会显示以下消息:“没有为此版本定义输入参数。”
项目的 In、Out 或 In/Out 参数在发布到 Orchestrator 时将成为输入和输出参数。请注意,对于 In/Out 参数,系统将在 Orchestrator 中创建并显示两个不同的参数,即输入和输出参数,并使用相同的名称。
提供参数值
可以使用 Studio、Orchestrator 或 Orchestrator API,仅向输入参数提供值,如下所示:
Studio
As default values, when creating the arguments. A short example can be found here. A default value provided for an argument in Studio can be overwritten in Orchestrator, both at process or job level.
重要
在任何级别,为 Studio 中的输入参数提供的默认值都不会显示在 Orchestrator 中。
Orchestrator
- At process level - in the Arguments tab of the View Process window, as explained here.
- At job level - in the Arguments tab of the Start Job window, as explained here.
- At schedule level - in the Arguments tab of the Add Schedule window, as explained here.
备注:
更新包时,只要新的包版本与参数的定义无关,系统就会保留为 Orchestrator 中流程级别的输入参数提供的值。
如果您为 Orchestrator 中的输入参数提供值,请注意,必须以 JSON 格式提供这些值。以下是如何执行此操作的一些示例:
- String - 必须提供不带引号的值,例如
string
; - Int32 - 提供任何整数值,例如
11
; - Boolean - 显示两个单选按钮,让您选择 True 或 False;
- Double - 提供浮点值,例如
3.5
; - DateTime - 以有效 JSON 的形式提供值,例如
"2012-04-23T18:25:43.511Z"
; - Array - 以有效 JSON 的形式提供值,例如
[1, 1, 2, 3, 5, 8]
或["firstString", "secondString"]
。
重要
可以使用任何类型的 In 参数,但请记住,只有基元由 Orchestrator 验证。
Orchestrator API
- At package level - to the
/odata/Processes/UiPath.Server.Configuration.OData.SetArguments(key='key')
endpoint; - At process level - as a PATCH request to the
/odata/Releases(Id)
endpoint; - At job level - as a POST request to the
/odata/Jobs/UiPath.Server.Configuration.OData.StartJobs
endpoint; - At schedule level - as a POST request to the
/odata/ProcessSchedules
endpoint.
备注:
对于 API 调用,整个输入参数的 JSON 表示不得超过 10,000 个字符,包括参数名称、所有转义字符、空格、括号和参数值。
显示参数值
输入参数的值标记如下:
- 无值 - 在流程,作业,计划或包级别(在 Studio 中)没有为参数提供值。
- “继承自包”- 如果在 Studio 中默认提供该值。此消息显示在特定包的“参数”窗口,以及“查看流程”、“开始作业”和“添加计划”窗口中。
- “继承自流程”- 如果在流程级别(在“查看流程”窗口中)提供该值。此消息显示在“开始作业”和“添加计划”窗口中。值本身显示在“查看流程”窗口中。

如果存在输入或输出参数值,则这些值将显示在“作业详细信息”窗口中。在以下情况下,输入值将显示在上述窗口中:
- 它们是在流程级别添加的;
- 它们是在作业级别添加的。
You can also view input and output arguments at the package level, in the Package Versions window. For more information, see the Managing Packages.
重要
在 v2018.3 之前创建并发布到 Orchestrator 的工作流必须使用 v2018.3(或更高版本)机器人重新上传,以便可以显示
Main.xaml
文件的 In 和 Out 参数。
参数权限
The following permissions are required in relation to input and output arguments in Orchestrator:
- 在包级别 - 对包的“查看”权限;
- 在流程级别 - 对流程的“查看”和“编辑”流程;
- 在作业级别 - 对作业的“创建”权限;
- 在触发器级别 - 创建和/或编辑计划。
大约一年前更新