Orchestrator 用户指南

适用平台：

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

在 Studio 中管理队列

向队列中添加项目

在“队列”页面中，创建一个队列。
在 Studio 中，创建一个自动化项目，例如，它从 Excel 电子表格收集某些图表并将其存储在变量中。
从“活动”面板中，将“添加队列项目”活动拖动到“设计器”面板。
在“属性”面板的“队列名称”字段中，键入在步骤 1 中创建的队列的名称，并用引号括起。

注意：队列名称不区分大小写。例如，“Test_QuEuE”和“test_queue”相同。
从“优先级”列表中，选择“低”、“正常”或“高”，具体取决于此活动添加的项目的重要性以及希望处理这些项目的速度。
（可选）在参考字段中，输入用作一个或一组队列项目的标识符的字符串或字符串变量。（该引用可用于将您的事务链接到自动化项目中使用的其他应用程序。此外，此功能使您可以根据提供的自定义引用在 Orchestrator 中搜索特定事务。）

注意：引用与 Orchestrator 或机器人的版本 2016.2 或更低版本不兼容。
（可选）在“截止日期”字段中，添加一个日期，表示队列项目可能在该日期之前得到处理。
（可选）在“延期”字段中，添加一个日期，表示只能在该日期之后处理队列项目。
在“项目信息”字段旁边，选择“浏览 ”按钮。此时将显示“项目信息”窗口，您可以为创建的每个队列项目添加数据。

图 1. “项目信息”窗口

注意：在项目信息窗口中添加的字符串参数的值不能包含以下字符：[ 和 " "。
选择“创建参数”。系统将创建一个新的空白参数。
将参数的名称更改为更能说明您的需求的名称。
根据需求更改参数的类型。例如，如果要存储事务中的数值，请选择Int32。
在“值”字段中，输入要添加到队列项目中的值或用于存储特定值的变量。
选择“确定”。您的设置已保存。

注意：将这些类型的自动化项目放置在一个循环中。否则，系统只会在 Orchestrator 中创建并填充一个项目。

在 Studio 的项目信息窗口中添加的数据会显示在 Orchestrator 的项目详细信息窗口中的特定数据下。添加到队列的所有项目的状态都设置为新。

图 2. “项目详情”窗口

从队列获取项目并更改其状态

在 Orchestrator 中，假设您有一个填充了项目的队列。
在 Studio 中，从“活动”面板中将“获取事务项目”活动拖动到“设计器”面板。
在“属性”面板的“队列名称”字段中，键入从 Orchestrator 填充的队列的名称，并用引号括起。

注意：队列名称不区分大小写。例如，“New_QueUe”和“new_queue”相同。
创建一个队列项目变量。此变量根据优先级和截止日期存储队列中的第一个项目。置于循环中时，机器人会循环访问所有队列项目。队列项目通过此活动后，不会对其进行处理，并且该项目的状态将更改为正在进行。
在“事务项目”字段中，输入先前创建的队列项目变量。
从“活动”面板中，将“决策”活动拖动到“获取事务项目”活动下。
创建自动化要求。例如，将事务项目添加到 Excel 电子表格中，并发送包含这些信息的电子邮件。
在“属性”面板的“条件”字段中，键入可以更改项目状态的条件（例如，队列项目为空）。
从活动面板中，拖动设置事务状态活动并将其连接到决策活动的False分支。通过此活动的所有事务项目均不满足在步骤 7 中添加的条件。
在属性面板中，从状态下拉列表中选择成功。此状态将应用于通过该活动的所有队列项目。
在“事务项目”字段中，输入步骤 5 中使用的队列项目变量。
（可选）选择“分析”字段旁边的“浏览 ”按钮，然后在“分析”字段中输入您希望在“项目详情”窗口中显示的数据。
（可选）选择“输出”字段旁边的“浏览 ”按钮，然后在“输出”字段中输入您希望在“项目详情”窗口中显示的数据。

注意：仅当队列项目已成功处理时，才会显示此信息。
将另一个设置事务状态活动拖动到设计器面板中，并将其连接到决策活动的True分支。通过此活动的所有队列项目均满足在步骤 7 中添加的条件。
在属性面板的状态字段中，选择失败。此状态将应用于通过该活动的所有队列项目。
在“事务项目”字段中，输入步骤 5 中使用的队列项目变量。
从“错误类型”列表中，选择“业务”或“应用程序”，具体取决于您在“决策”活动中输入的条件。例如，空队列项目可能是应用程序异常，而小于标准值的事务值可能是业务异常。有关此选择的更多信息，请参见业务异常与应用程序异常一文。
在原因字段中，键入一个字符串，以解释触发异常的原因。执行项目后，此信息将显示在项目详细信息窗口中。
将两个设置事务状态活动连接到获取事务项目活动。这将创建一个循环，并使您能够循环访问所有队列项目。基本自动化项目应如以下屏幕截图所示。

图 3. 基本自动化项目

“设置事务状态”活动中的属性（左侧）与其在 Orchestrator 的“项目详细信息”窗口中的对应字段的映射。

图 4. “设置事务状态”活动

要从队列项目检索特定数据，可以使用 SpecificContent() 函数。在引号之间键入用于向队列添加信息的参数的名称，并用圆括号括起。

图 5. 表达式编辑器

例如，上面的屏幕截图显示了分配活动的值字段。它可用于检索归属于队列项目的值（显示在 Orchestrator 的项目详细信息窗口中的特定数据下），并将其分配给字符串变量，以便稍后处理。

在上面的屏幕截图中：

transItem - 是用于存储事务项目的队列项目变量。
.SpecificContent - 是从事务项目中检索信息的函数。
("transactionID") - 是在“项目信息”窗口中添加，以用数据填充队列项目的参数的名称。参数名称也显示在 Orchestrator“项目详细信息”窗口的“特定数据”中。
.ToString - 是用于将队列的 ID（最初是整数）转换为字符串的函数。

推迟事务项目

在 Orchestrator 中，假设您有一个填充了多个项目的队列。
在 Studio 中，假设您已有用于循环访问所有队列项目的“获取事务项目”活动。
从活动面板中，将决策活动拖动到工作流中。通过该活动，您可以制定业务决策，并根据该业务决策来推迟一些队列项目。例如，如果账单的价值大于 3000 美元，您可能要推迟付款。
从活动面板中，将延期事务项目活动拖动到决策的True分支。这意味着，所有满足决策活动中的条件的队列项目都会根据您的配置被推迟。
在“事务项目”字段中，输入“获取事务”活动中使用的“队列项目”变量。
在“延期”字段中，添加可开始处理此项目之前的日期。
在“截止日期”字段中，添加处理此项目的截止日期。

截止日期和延期属性为队列项目添加了新的优先级。例如，首先处理今天下午 7 点到期，并且具有中等优先级的队列项目，然后再处理没有到期日期但具有高优先级的另一个项目。

注意：修改队列项目的截止日期或推迟队列项目会将其状态更改为“新”。

添加自定义进度

在 Orchestrator 中，假设您有一个队列，其中填充了大量（数百万个）状态为“正在进行”的项目。
在 Studio 中，假设您已有用于循环访问所有队列项目并使用队列项目变量的“获取事务项目”活动。
从“活动”面板中将“设置事务进度”活动拖动到“设计器”面板。
在活动的“事务项目”属性中，输入队列项目变量。
在进度属性中，添加一个自定义字符串来描述此处达到的进度，例如“BeforeFirstDecision”。这样一来，您便知道该项目已从 Orchestrator 数据库中检索到。如果您的自动化项目在执行过程中在此时崩溃，则有一个项目具有此状态，并显示在进度列中。

注意：仅当有一个项目具有正在进行状态时，才会显示定义进度状态。

可以如上所述设置自动化项目的其余部分。

例如，以下工作流示例将每个项目的状态自动设置为“ 成功 ”或“ 失败 ”，具体取决于您设计 事务正文 序列的方式：

不执行任何操作、中断或继续- 结果显示成功
引发异常 - 结果为 失败（应用程序错误）
引发 BusinessRuleException - 结果为“ 失败”（业务错误）
设置事务状态 - 结果为您设置的状态
推迟事务项目 - 结果为 “新”
应停止 - 如果从 Orchestrator 停止工作流，则在当前事务完成后，工作流将存在循环。

工作流会自动对每个队列项目重复，并设置相应的事务状态。

如果出现中断或队列为空，则工作流将存在循环。

图 6.自动化项目