向 Insights 添加自定义数据

重要提示：

• For deployments exceeding 75 processes and/or queues with custom data added per tenant, you must either add your desired process and queue tables to an allowlist or Enable Table Grouping.
• A configurable alert is displayed warning you when you are approaching this limit.
• Table grouping may also need to be enabled based upon the total number of such tables across all tenants. Review the Hardware and Software Requirements for additional details.
• 流程表和队列表中的列数限制为 40。

Insights 工作流设计

重要提示：

Unique case-insensitive names must be used for all custom variables (i.e. do not use successfulTransaction and SuccessfulTransaction). If your variables are not unique, you must set Insights to be case insensitive.

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

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

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

• Add Log Fields - all added log fields are ingested as a custom table in Insights. See [here] (doc:adding-custom-data-to-insights#logs) for more details.
• Add Queue Item - all data added via the ItemInformation property are ingested as a custom table in Insights. See here for more details.
• Set Transaction Status - all data added via the Analytics and Output properties are ingested as a custom table in Insights. See here for more details.

For complete details about all data ingested by Insights, see the Insights Data Model page.

备注：

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

Where previously you would use the RemoveLogFields activity at the end of any individual sequence to remove logs not needed in the rest of the workflow, removing all custom logs as such results in the process and data not being ingested into the Insights database.

日志

有两种方法可以利用日志将数据发送到 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 代表。