- 公共部门发行说明
- 入门指南
- 访问和权限
- 通知
- 与 Insights 交互
- Action Center 的集成
- 故障排除
![](https://docs.uipath.com/_next/static/media/grid.05ebd128.png?w=3840&%3Bq=100)
自定义变量
Insights 始终通过 Insights 数据模型中可用的预定义字段来提取数据,但管理员还可以配置从机器人日志和队列中提取的自定义变量,以用于计算特定 KPI 或构建更专业的仪表板。
- 要包括流程的自定义变量,必须首先确保通过 Studio 中的
UiPath.System.Activities.AddLogFields
活动将其添加到自动化中的日志,然后必须选择要提取的变量。 - 要包括队列的自定义变量,必须首先确保通过 Studio 中的活动将其添加到工作流中,然后选择要提取的变量。
- 对特定数据使用
UiPath.System.Activities.AddQueueItem
活动; - 对输出数据和分析数据使用
UiPath.System.Activities.SetTransactionStatus
活动。
- 对特定数据使用
- 禁用自定义变量可能会破坏引用变量的现有仪表板。
要配置自定义变量,管理员必须执行以下步骤:
- 打开任意 Insights 页面右上角的三点菜单,然后选择“配置自定义变量”。系统随即会打开配置页面,其中列出可提取的所有自定义字段。
-
单击配置页面顶部的相应选项卡,决定是否要为流程或队列配置自定义变量。
- 在“提取”列中,选择构建仪表板时要使用的自定义变量。
-
在“类型”列中,选择自定义变量的类型。您可以选择“字符串”、“数字”或“日期时间”。
重要提示:- 字段不得超过 40 个字符,并且此数字之后的任何字符都将被剪切。 要添加超过 40 个字符,请更改
Insights.Etl.Json.MaxStringLen
标志。 您可以在 Orchestrator 网页配置中添加此标志,并根据项目需求设置值。 例如:
<add key="Insights.Etl.Json.MaxStringLen" value="60" />
- 回填百分比显示从所有流程或队列中提取自定义变量的进度。您需要刷新页面以查看最新的回填百分比。所需时间视数据大小而定。自定义变量值将从最新数据回填到最旧数据。保存配置后,你很快即可使用该字段,而无需等到 100% 回填。
- 您最多可以从 500 个流程或队列中提取变量,最多可以从每个流程或队列中提取 200 个变量。
- 如果您将自定义变量的“类型”配置为“数字”,请确保其不包含
,
或其他非数字字符,例如$
,因为这些字符不受支持。对于包含特殊字符的数字,请选择类型“字符串”。 - 每次更改自定义变量配置都将导致该特定流程进行全新的回填。回填的时间取决于 Insights 数据库中为该特定流程存储的日志数量。
- 字段不得超过 40 个字符,并且此数字之后的任何字符都将被剪切。 要添加超过 40 个字符,请更改
-
保存配置。针对特定流程提取的所有变量应显示在名为*“流程 - 流程名称”的探索中,而针对特定队列提取的所有变量应显示在名为*“队列 - 队列名称”的探索中。
重要事项:您最多可以从 500 个流程或队列中提取变量,最多可以从每个流程或队列中提取 200 个变量。已配置的自定义变量数
硬件规模
流程数量
每个流程的机器人日志数量
提取的预估时间
Resolution settings
大规模
1
1,000,000
5 分钟
Resolution settings
大规模
1
40,000,000
120 分钟
要编辑现有配置,管理员必须采取以下步骤:
- 打开任意 Insights 页面右上角的三点菜单,然后选择“配置自定义变量”。系统随即会打开配置页面,其中列出可提取的所有自定义字段。
- 单击配置页面顶部的相应选项卡,决定是否要为流程或队列配置自定义变量。
- 要删除以前选择的变量,请取消选中“提取”复选框。
- 要更改变量的类型,请从下拉列表中选择所需的新类型。
- 请务必保存配置。
- 对曾使用已修改或已删除变量的现有仪表板执行以下检查:
- 如果删除了变量,请务必从已创建或修改的公式,从筛选器或可视化图表中删除对变量的任何引用;
- 如果更改了变量类型,请确保新类型仍可正确应用;
本节提供了在仪表板中使用自定义变量的示例。
请采取以下步骤配置自定义变量:
- 选择要提取的“ProcessCount”变量,然后选择“字符串”类型。
-
启用“Argument1_Email”变量,选择“字符串”类型,然后单击“保存”。
- 返回“仪表板”,创建一个新的仪表板,并添加一个新的图块。
-
选择“*流程 - 自定义日志 2”探索,然后选择“自定义日志 2”视图,以在图块中使用此流程中已配置的自定义变量。
自定义变量在某些特定情况下可能具有空值,如以下部分中所述。
如果您在可视化中使用标准数据模型中的字段,该字段与流程特定的自定义变量字段配对,并且流程在机器人日志中不包含自定义变量,则与该流程关联的所有字段的值为空。
有两种方法可以消除此场景中的空值:
- 选项 1:将自定义变量添加为筛选器,并将条件设置为“非空”,以从可视化中删除空值。
- 选项 2:为确实包含自定义变量的流程名称设置筛选器。但是请注意,如果您采用这种方法,则可能会遇到下面的第二种场景。
如果流程生成的所有日志中都不包含自定义变量,则不包含该自定义变量值的日志将显示该变量的值为空,如下图所示。
以下示例说明了此特定情况。
-
前往“配置自定义变量”。您可以看到“Birthday2”自定义变量字段出现在“自定义日志 2”流程中。
- 打开新的或现有的仪表板,并添加一个图块。
- 前往“自定义日志 2”探索。选择作业视图下的“流程名称”字段和“自定义变量”字段。在本例中,自定义变量字段为“CustomLogs2.Birthday2”。
-
单击“运行”。您看到的结果应与以下屏幕截图所示的结果相似。
要消除空值,请将自定义变量字段添加为筛选器。最后,将条件设置为“非空”,以便从可视化中删除空值。