跳至主要内容

从 CSV 文件导入活动

你可以通过上传一个包含活动数据的 CSV 格式文本文件，从外部源将多个活动导入到 Maintain 中，并将该文件引入活动中。这些活动可以像在 Maintain 中创建的活动一样进行可视化和修改。

下载 CSV 文件模板​

导入的 CSV 文件需要符合你的项目特定模板。要下载 maintain-import-template.csv：

  1. 导航到活动并选择添加活动。
  2. 选择导入活动。
  3. 选择下载模板。

填充 CSV 文件模板​

CSV 模板将仅包含一行值，这些值表示可针对导入的活动提供的可能值。此行称为标题行，在填充模板时不应删除。

提示

虽然不得删除标题行，但你可以从标题中删除特定值或更改值的顺序。例如，如果某个字段在特定场景中与导入无关，则可以将其从标题和后续行中删除。这将导致该字段在所有导入的活动中留空。

要导入单个活动，请在模板中添加新行，然后输入用逗号分隔的相应值。新行中的每个值应包含你希望在模板中提供的相应标题行中填充的值。

例如，如果模板包含以下标题行：title,status,department，请创建一个包含附加行的 CSV 文件：

title,status,department
Erect scaffolding,Done,Rigging

导入后将创建一个标题为“Erect scaffolding”、状态为“Done”且部门为“Rigging”的活动。

设置日期字段的格式​

在 Maintain 中，某些活动字段代表日期，必须采用特定格式才能正确导入。在 CSV 模板中，可以通过 startTime (DD/MM/YYYY) 格式的特殊标题值来识别日期字段。在此示例中，startTime 是字段的名称，而 DD/MM/YYYY 是需要在 CSV 文件的后续行中使用的日期格式。

例如，导入以下文件后将创建活动，其中 startTime 设置为 2023 年 12 月 10 日。

title,startTime (DD/MM/YYYY)
Erect scaffolding,10/12/2023

设置布尔值字段的格式​

在 Maintain 中，某些活动字段代表布尔值，例如 true 或 false。在 CSV 模板中，可以通过 isActive (true/false) 格式的特殊标题值来识别日期字段。这些字段只有两个有效值，true 或 false。

例如，导入以下文件后将创建活动，其中 isActive 设置为 false。

title,isActive (true/false)
Erect scaffolding,false

设置包含逗号的值的格式​

由于 CSV 格式使用逗号分隔值，因此当活动字段中也需要包含逗号时需格外注意。Maintain 根据 RFC 4180 标准处理 CSV 文件，该标准要求包含逗号的值需用双引号括起来。

例如，导入以下文件后将创建活动，其中 city 设置为 Boston, MA。

title,city
Erect scaffolding,"Boston, MA"

未设置值​

对于非必需活动字段，你可以将该字段留空，以表示特定活动缺少相关值或值不相关。

例如，导入以下文件后将创建活动，其中 state 设置为 New York，但 city 字段中没有值。

title,city,state
Erect scaffolding,New York

将活动与资产关联​

Maintain 支持将活动链接到 CDF 资产，这可用于在 3D 模型、文档、PSN 等场景中为活动提供上下文信息。为了让 Maintain 在 CDF 中创建与资产的相应链接，你必须在导入模板中提供 CDF 资产的外部 ID。

如果你的项目中具有资产上下文信息，则模板中将有一个特殊的 assetExternalId 字段，你需要使用该活动关联资产的外部 ID 来填充此字段。

例如，当导入以下文件时，假设存在外部 ID 为 NY_BUILDING_23 的 CDF 资产，则在引入 Maintain 时该活动将与此资产建立上下文关联。

title,assetExternalId
Erect scaffolding,NY_BUILDING_23

如果提供的外部 ID 未导出，用户将在导入过程中看到错误。

提示

最终用户可能不知道与该活动关联的资产的外部 ID。如果需要向最终用户提供可能的资产及其外部 ID 列表，我们建议使用 CDF 的资产 API 或其他数据提取器来检索这些数据。

导入已填充的 CSV 文件​

填充 CSV 模板后，可以将其导入到 Maintain 中：

  1. 导航到活动 > 添加活动。
  2. 选择导入活动。
  3. 选择单击以选择要导入的 CSV 文件字段。
  4. 从你的计算机选择并上传填充的 CSV 文件。
  5. 检查文件检查器部分，验证你是否导入了该文件。绿色消息应显示要导入的行数以及是否有任何警告或错误。
  6. 如果没有错误，请选择导入以开始导入过程。
  7. 导入成功后，将显示表示成功的绿色消息以及显示活动按钮。
  8. 可选。选择显示活动以导航至导入的活动，并根据 CSV 文件检查它们是否正确。
上次更新 于