向 Insights 添加自定义数据

重要提示：

• 如果部署中包含超过 75 个为每个租户添加了自定义数据的流程和/或队列，您必须将所需的流程和队列表添加到允许列表或启用表格分组。
• 接近此限制时，系统将显示可配置的警示作为警告。
• 根据所有租户中此类表格的总数，也可能需要启用表格分组。有关其他详细信息，请参见硬件要求和软件要求。
• 流程表和队列表中的列数限制为 40。

Insights 工作流设计

重要事项：所有自定义变量都必须使用唯一的不区分大小写的名称（即，不要同时使用 successfulTransaction 和 SuccessfulTransaction）。如果变量不是唯一的，则必须将 Insights 设置为区分大小写。

在设计用于 Insights 中的消耗和分析的自动化工作流时，需要考虑迄今为止使用的最佳实践方法的变化。

您无需“标记”单个项目和/或数据点，以确保它们可用于在 Insights 中进行分析。 对于具有自定义字段的所有流程和/或队列，系统会使用这些可用字段自动生成自定义表格。

以下活动可用于设计自动化工作流以捕获所需数据：

• 添加日志字段 - 添加的所有日志字段在 Insights 中作为自定义表格提取。有关更多详细信息，请参阅 [此处] (doc:adding-custom-data-to-insights#logs)。
• 添加队列项目 - 通过 ItemInformation 属性添加的所有数据在 Insights 中作为自定义表格提取。有关更多详细信息，请参阅此处。
• 设置事务状态 - 通过 Analytics 和 Output 属性添加的所有数据在 Insights 中作为自定义表格提取。有关更多详细信息，请参阅此处。

有关 Insights 提取的所有数据的完整详细信息，请参阅 Insights 数据模型页面。

备注：

对于要在 Insights 中分析的工作流，建议在每个工作流结束时记录所有需要的数据。

以前可以在任何单个序列结束时使用“删除日志字段”活动来删除其余工作流中不需要的日志，从而删除所有自定义日志，这样会导致流程和数据不会提取到 Insights 数据库中。

日志

有两种方法可以利用日志将数据发送到 Insights：

• “日志消息”- 用于添加自定义字符串消息，在工作流出现错误时以日志事件的形式将该消息发送到 Insights。
• “添加日志字段”- 用于将自定义变量添加到默认的 Insights 仪表板。

当 Insights 检测到日志消息包含通过“添加日志字段”活动添加的自定义日志字段时，将在 Insights 中创建一个新表格，其中包含这些自定义字段和标题 "Process-<your process name>”。这些自定义字段通过自定义 JSON 解析器从原始消息中提取，并以 RawMessage_CustomFieldName 格式添加到表格中。

自定义字段支持以下数据类型：Integer、String、Boolean、Double 和 Float。

注意：自定义表格不会联接到 OOTB 数据架构，因此除非创建了关系，否则无法使用交叉表微件。如需进行此类自定义，请联系 UiPath 代表。

对于成功的流程，Insights 仅接收最后一个日志事件。如果使用“删除日志字段”活动，Insights 将无法捕获自定义字段，因为工作流将在流程完成之前删除自定义字段。

这也意味着利用日志捕获每个事务的数据的事务流程不会将每个事务日志的数据发送到 Insights。如果您使用的是遍历事务的流程，并希望存储每个事务的自定义数据，则应遵循 UiPath 最佳实践并使用队列。“队列”支持将每个队列项目的自定义变量发送到 Insights。

队列

每个队列项目都有三个部分，您可以在其中存储自定义变量。通过“添加队列项目”活动创建队列项目后，名为 ItemInformation 的字段将变为可用。在该字段中，您可以存储任何所需的自定义变量。所有队列数据支持的数据类型与自定义日志相同：Integer、String、Boolean、Double 和 Float。

要在队列项目完成处理后向其添加自定义变量，请利用“设置事务状态”活动。它包含两个可用于存储变量的输入：Analytics 和 Output。

如果 Insights 在队列中检测到自定义字段，则会在名为 Queue-"your queue name” 的数据模型中创建一个自定义表格。这些字段将通过它们存储到的输入进行标识：

• 存储在 Analytics 中的变量将名为“AnalyticsData_<yourfieldname>”。
• 存储在 Output 中的变量将名为“Output_<yourfieldname>”。
• 存储在 ItemInformation 中的变量将名为“SpecificData_<yourfieldname>”。

注意：队列自定义表格不会联接到 OOTB 数据架构，因此除非创建了关系，否则无法使用交叉表微件。如需进行此类自定义，请联系 UiPath 代表。