订阅

UiPath Insights

UiPath Insights 指南

自定义变量

Insights always ingests data via the pre-defined fields available in the Insights data model, but Admins can also configure custom variables extracted from robot logs and queues to use for calculating specific KPIs or building more specialized dashboards.

👍

在开始之前

要包括流程的自定义变量,您必须首先确保通过 Studio 中的 UiPath.Core.Activities.AddLogFields 活动将其添加到自动化中的日志,然后必须选择要提取的变量。


要包括队列的自定义变量,必须首先确保通过 Studio 中的活动将其添加到工作流中,然后选择要提取的变量。

  • 对特定数据使用 UiPath.Core.Activities.AddQueueItem 活动;
  • 对输出数据和分析数据使用 UiPath.Core.Activities.SetTransactionStatus 活动。

 

配置自定义变量

要配置自定义变量,管理员必须执行以下步骤:

  1. 打开任意 Insights 页面右上角的三点菜单,然后选择“配置自定义变量”。系统随即会打开配置页面,其中列出可提取的所有自定义字段。

  2. 单击配置页面顶部的相应选项卡,决定是否要为流程或队列配置自定义变量。

25102510
  1. 在“提取”列中,选择构建仪表板时要使用的自定义变量。

  2. 在“类型”列中,选择自定义变量的类型。您可以选择“字符串”、“数字”或“日期时间”。

🚧

重要

  • 回填百分比显示从所有流程或队列中提取自定义变量的进度。您需要刷新页面以查看最新的回填百分比。所需时间视数据大小而定。自定义变量值将从最新数据回填到最旧数据。保存配置后,你很快即可使用该字段,而无需等到 100% 回填。

  • 您最多可以从 500 个流程或队列中提取变量,最多可以从每个流程或队列中提取 200 个变量。

  • 如果您将自定义变量的“类型”配置为“数字”,请确保其不包含 , 或其他非数字字符,例如 $,因为这些字符不受支持。对于包含特殊字符的数字,请选择类型“字符串”。

  • 每次更改自定义变量配置都将导致该特定流程进行全新的回填。回填的时间取决于 Insights 数据库中为该特定流程存储的日志数量。

  1. 保存配置。针对特定流程提取的所有变量应显示在名为“*流程 - 流程名称”的探索中,而针对特定队列提取的所有变量应显示在名为“*队列 - 队列名称”的探索中。

🚧

重要

您最多可以从 500 个流程或队列中提取变量,最多可以从每个流程或队列中提取 200 个变量。

Number of Custom Variables ConfiguredHardware ScaleNumber of ProcessesNumber of Robot Logs per ProcessApproximate Time for Extraction
30Large Scale11,000,0005 minutes
30Large scale140,000,000120 minutes

 

编辑现有配置

要编辑现有配置,管理员必须采取以下步骤:

  1. 打开任意 Insights 页面右上角的三点菜单,然后选择“配置自定义变量”。系统随即会打开配置页面,其中列出可提取的所有自定义字段。

  2. 单击配置页面顶部的相应选项卡,决定是否要为流程或队列配置自定义变量。

  3. 要删除以前选择的变量,请取消选中“提取”复选框。

  4. 要更改变量的类型,请从下拉列表中选择所需的新类型。

  5. 请务必保存配置。

  6. 对曾使用已修改或已删除变量的现有仪表板执行以下检查:
    a. 如果删除了变量,请务必从已创建或修改的公式,从筛选器或可视化图表中删除对变量的任何引用;
    b. 如果更改了变量类型,请确保新类型仍可正确应用;

 

配置示例

本节提供了在仪表板中使用自定义变量的示例。

820820

请采取以下步骤配置自定义变量:

  1. 选择要提取的 ProcessCount 变量,然后选择“字符串”类型。

  2. 启用“Argument1_Email”变量,选择“字符串”类型,然后单击“保存”。

10591059
  1. 返回“仪表板”,创建一个新的仪表板,并添加一个新的图块。

  2. 选择“*流程 - 自定义日志 2”探索,然后选择“自定义日志 2”视图,以在图块中使用此流程中已配置的自定义变量。

333333

 

自定义变量为空值的情况

自定义变量在某些特定情况下可能具有空值,如以下部分中所述。

场景 1

如果您在可视化中使用标准数据模型中的字段,该字段与流程特定的自定义变量字段配对,并且流程在机器人日志中不包含自定义变量,则与该流程关联的所有字段的值为空。

24462446

 

There are two ways to eliminate the null values for this scenario:
Option 1: Add the custom variable as a filter, and set the condition to is not null to remove the null values from the visualization.

931931

Option 2: Set a filter for the process name that does include the custom variable. Note, however, that if you adopt this approach, you may run into the second scenario below.

24432443

 

场景 2

如果流程生成的所有日志中都不包含自定义变量,则不包含该自定义变量值的日志将显示该变量的值为空,如下图所示。

24432443

以下示例说明了此特定情况。

  1. 前往“配置自定义变量”。您可以看到“Birthday2”自定义变量字段出现在“自定义日志 2”流程中。
23192319
  1. 打开新的或现有的仪表板,并添加一个图块。
  2. 前往“自定义日志 2”探索。选择作业视图下的“流程名称”字段和“自定义变量”字段。在本例中,自定义变量字段为“CustomLogs2.Birthday2”。
  3. 单击“运行”。您看到的结果应与以下屏幕截图所示的结果相似。
24582458

 

To eliminate the null values, add the custom variable field as a filter. Lastly, set the condition to is not null, so that you can remove the null values from the visualization.

15841584

 

📘

备注:

当您查看自定义字段的原始数据时,这两种情况都会发生。当您对自定义变量应用函数(SUM、AVERAGE 等)时,您将排除空值。

 

故障排除和限制

See our Troubleshooting section for information about troubleshooting and limitations.

约一个月前更新


自定义变量


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

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