订阅

UiPath Orchestrator

UiPath Orchestrator 指南

关于输入和输出参数

我们已经公开了 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

📘

备注:

对于 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:

  • 在包级别 - 对包的“查看”权限;
  • 在流程级别 - 对流程的“查看”和“编辑”流程;
  • 在作业级别 - 对作业的“创建”权限;
  • 在触发器级别 - 创建和/或编辑计划。

大约一年前更新


关于输入和输出参数


建议的编辑仅限用于 API 参考页面

您只能建议对 Markdown 正文内容进行编辑,而不能建议对 API 规范进行编辑。