1
下载 CSV 文件模板
导入的 CSV 文件需要符合你的项目特定模板。要下载 maintain-import-template.csv:1.导航到活动并选择添加活动。
1.选择导入活动。
1.选择下载模板。
2
填充 CSV 文件模板
CSV 模板将仅包含一行值,这些值表示可针对导入的活动提供的可能值。此行称为标题行,在填充模板时不应删除。要导入单个活动,请在模板中添加新行,然后输入用逗号分隔的相应值。新行中的每个值应包含你希望在模板中提供的相应标题行中填充的值。例如,如果模板包含以下标题行:导入后将创建一个标题为“Erect scaffolding”、状态为“Done”且部门为“Rigging”的活动。如果提供的外部 ID 未导出,用户将在导入过程中看到错误。
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 时该活动将与此资产建立上下文关联。3
导入已填充的 CSV 文件
填充 CSV 模板后,可以将其导入到 Maintain 中:1.导航到活动 > 添加活动。
2.选择导入活动。
3.选择单击以选择要导入的 CSV 文件字段。
4.从你的计算机选择并上传填充的 CSV 文件。
5.检查文件检查器部分,验证你是否导入了该文件。绿色消息应显示要导入的行数以及是否有任何警告或错误。
6.如果没有错误,请选择导入以开始导入过程。
7.导入成功后,将显示表示成功的绿色消息以及显示活动按钮。
8.可选。选择显示活动以导航至导入的活动,并根据 CSV 文件检查它们是否正确。