Skip to main content
Maintain 支持三种导入活动的方法：
  • CSV 上传：使用用户界面（仅限APM模式）导入活动。
  • Cognite Toolkit：使用 Cognite Toolkit 数据建模（APM 和 IDM/CDM 模式）提取活动。
  • 转换：使用 CDF 转换（APM 和 IDM/CDM 模式）从 RAW 表或其他来源转换数据。

​
通过CSV上传导入（APM模式）

模式可用性：仅限APM模式。IDM/CDM模式不支持在用户界面中进行CSV导入。
通过 CSV 导入的活动可以像在 Maintain 中创建的活动一样进行可视化和修改。
1

下载CSV文件模板

导入的CSV文件需要符合您项目特定的模板。要下载 maintain-import-template.csv：
  1. 导航至 活动 并选择 添加活动。
  2. 选择 导入活动。
  3. 选择 下载模板。
2

填写CSV文件模板

CSV模板将仅包含一行值，表示您可以为导入活动提供的可能值。这一行被称为标题行，在填充模板时不应被删除。
虽然不能删除标题行，但您可以删除标题中的特定值或更改值的顺序。例如，如果某个字段在特定场景下不相关，您可以将其从标题和后续行中删除。这将导致所有导入的活动中该字段留空。
要导入单个活动，请在模板中添加新行，并输入用逗号分隔的适当值。新行中的每个值应包含您希望在模板中提供的相应标题行上填充的值。 例如，如果您的模板包含以下标题行：title,status,department，请创建一个包含额外行的 CSV 文件：
导入时，您将创建一个标题为”搭建脚手架”，状态为”完成”，部门为”吊装”的活动。

​
格式化日期字段

Maintain 中的某些活动字段代表日期，必须具有特定格式才能正确导入。日期字段可以通过 CSV 模板中 startTime (DD/MM/YYYY) 形式的特殊标题值来识别。在此示例中，startTime 是字段名称，而 DD/MM/YYYY 是 CSV 文件后续行中需要使用的日期格式。 例如，导入以下文件将导致创建的活动中 startTime 被设置为 2023 年 12 月 10 日。

​
格式化布尔字段

Maintain 中的某些活动字段代表布尔值，例如 true 或 false。布尔字段可以通过 CSV 模板中 isActive (true/false) 形式的特殊标题值来识别。这些字段仅有两个有效值，true 或 false。 例如，导入以下文件将导致创建的活动中 isActive 被设置为 false。

​
格式化包含逗号的值

由于 CSV 格式使用逗号分隔值，因此当活动字段也需要包含逗号时请务必小心。Maintain 根据 RFC 4180 标准 处理 CSV 文件，该标准要求包含逗号的值必须用双引号括起来。 例如，导入以下文件将导致创建的活动中 city 被设置为 Boston, MA。

​
未设置的值

您可以在非必填的活动字段中留空，以表示特定活动的缺失或不相关值。 例如，导入以下文件将导致创建的活动中 state 被设置为 New York，但 city 字段将没有值。

​
将活动连接到资产

Maintain 支持将活动链接到 CDF 资产，这用于在 3D 模型、文档、PSN 等中对活动进行情境化。为了让 Maintain 在 CDF 中创建到资产的适当链接，您必须在导入模板中提供 CDF 资产的外部 ID。 如果您的项目中包含资产情境化，模板中将有一个特殊的 assetExternalId 字段，您需要使用该活动资产的外部 ID 来填充它。 例如，当导入以下文件并假设存在一个外部 ID 为 NY_BUILDING_23 的 CDF 资产时，该活动在被摄入到 Maintain 时将与此资产进行情境化。
如果提供的外部ID未导出，用户在导入时将看到错误。
最终用户可能不知道与活动链接的资产的外部ID。如果需要向最终用户提供可能资产及其外部 ID 的列表，我们建议使用 CDF 的 asset API 或其他数据提取器来检索此数据。
3

导入已填写的CSV文件

一旦您填充了 CSV 模板，即可将其导入 Maintain：
  1. 导航至 活动 > 添加活动。
  2. 选择 导入活动。
  3. 选择 点击选择要导入的 CSV 文件 字段。
  4. 从您的计算机中选择并上传填充好的 CSV 文件。
  5. 通过检查 文件检查器 部分来验证您是否已导入文件。应显示一条绿色消息，指示要导入的行数以及是否有任何警告或错误。
  6. 如果没有错误，选择 导入 以开始导入过程。
  7. 导入成功后，您将看到一条绿色成功消息以及 显示活动 按钮。
  8. 可选。选择 显示活动 以导航至导入的活动，并检查它们是否符合 CSV 文件中的内容。

​
通过 Cognite Toolkit 导入

模式可用性：APM 和 IDM/CDM 模式。这是程序化活动摄取的推荐方法。
使用 Cognite Toolkit 通过 CDF 的数据建模功能来提取活动。此方法适用于两种部署模式，并提供版本控制和可重复的部署。

​
先决条件

在通过 Cognite Toolkit 导入活动之前，请确保您已：
  • 在您的数据模型空间中配置了自定义活动视图（或使用来自 cdf_idm 的标准 CogniteMaintenanceOrder 视图）
  • 在 viewMappings 下 Maintain 配置中映射的活动视图
  • 访问 Cognite Toolkit

​
配置活动视图映射

在您的 Maintain 配置中，验证 viewMappings 部分是否指向您的活动视图：
如果您创建了自定义活动视图（例如 APM_Activity 或 ExtendedActivity），请更新映射以指向您的自定义视图：
了解有关 扩展数据模型 和 配置视图映射 的更多信息。

​
使用 Cognite Toolkit 提取活动

使用 Cognite Toolkit 作为在 IDM 模式下提取活动的推荐方法。
1

创建活动数据结构

如果您还没有，请为您的活动创建容器、视图和节点 YAML 文件。遵循标准数据建模结构：
  • APM_Activity.Container.yaml - 定义容器架构
  • APM_Activity.View.yaml - 定义视图属性和关系
  • apmActivities.Node.yaml - 包含您的活动实例 有关详细示例和模板，请参阅 Cognite Toolkit 文档。
2

配置字段映射

确保您的活动节点包含 Maintain 所需的字段：
根据您的 字段配置 设置，在 Maintain 中包含其他字段。
3

部署活动

使用 Cognite Toolkit 部署您的活动数据：
如果您需要替换现有活动，请使用 --drop-data 标志：
了解更多关于 Cognite Toolkit 部署标志 的信息。
4

在 Maintain 中验证

1.登录 Maintain。 2.导航至 活动。 3.验证您导入的活动是否显示正确的数据。

​
使用转换导入活动

模式可用性：APM 和 IDM/CDM 模式。这是批量数据的推荐方法。
或者，您可以使用 CDF 转换 将数据从原始表或其他来源转换为活动节点。

​
故障排除

如果在导入后遇到活动问题，请查看表格以获取原因和解决方案。
最后修改于 2026年9月8日