需求从Excel迁移到Jama Connect时,文件能够上传并不代表导入结果一定正确。工作项类型、表头、字段类型和选项值只要有一处不一致,就可能出现字段为空、内容错位或重复创建。处理“Jama Connect怎么批量导入需求Jama Connect导入需求后字段映射错误如何调整”时,应先整理源数据,再通过小批量预览确认映射。
一、Jama Connect怎么批量导入需求
批量导入主要分为新建需求和更新已有需求两种情况。新数据使用单向导入,已有数据批量修改则应使用Excel往返更新,两种方式不能混用。
1、整理需求导入表
每张工作表应只放一种工作项类型,第一行设置清晰表头。名称字段必须有对应列,状态、优先级等选择列表值还要与系统中的可用选项完全一致,否则导入后可能显示为空。CSV可以导入字段数据,但不能按缩进或颜色建立层级。
①将需求名称、描述、状态、优先级、负责人、原始编号分别放入独立列。
②删除合并单元格、重复表头、整列空白和隐藏的无效数据。
③把系统需求、软件需求、接口需求分别放入不同工作表。
④检查状态、优先级等选择值,统一大小写、空格和名称。
⑤需要保留旧系统编号时,在Jama Connect中准备对应的自定义字段。
⑥日期字段统一整理为系统可识别的格式,再保存为Excel文件。
2、执行批量导入
正式导入前先准备三至五条测试数据,确认目标位置、需求类型、层级和字段映射。直接导入完整文件,一旦映射错误,后续清理成本会明显增加。
①在资源树中选中用于接收需求的集合或文件夹。
②选择【Import】,上传准备好的Excel或CSV文件。
③确认目标位置,并选择本次需要导入的工作表。
④设置表头所在行,检查系统是否正确识别每一列名称。
⑤在字段映射页面,将Excel列对应到名称、描述、状态、优先级和自定义字段。
⑥为没有来源列但必须填写的字段设置默认值。
⑦需要建立父子层级时,选择与源文件一致的缩进或颜色识别方式。
⑧检查预览中的数量、字段内容和层级,确认无误后提交导入。
单向导入主要用于创建新工作项,文件会被导入到当前选中的资源树位置。Jama Connect的数据导入向导支持Excel文件,并要求名称及管理员设置的必填字段完成映射。
3、批量更新已有需求
已经存在于Jama Connect中的需求不能继续用普通导入文件直接覆盖。更新时要从系统导出往返模板,保留其中用于识别原记录的隐藏列,再把修改后的文件导回系统。
①筛选需要修改的需求,选择【Export】→【View all export options】。
②运行【Excel Export for Roundtrip】,下载系统生成的文件。
③保留隐藏识别列,不要修改已有需求的ID和Global ID。
④只调整需要更新的字段;新增需求时,将ID相关字段留空。
⑤重新进入导入向导,上传修改后的往返文件。
⑥勾选【Update Items】,再根据需要选择冲突处理方式。
⑦检查预览中的更新数量和新增数量,确认后提交。
二、Jama Connect导入需求后字段映射错误如何调整
字段映射错误通常表现为内容进入错误字段、选择列表为空、日期异常、描述被截断,或者原有需求被重复创建。调整前先确认错误涉及哪些记录,再决定删除重导、批量编辑还是往返更新。
1、核对映射和字段类型
①从错误数据中抽取三至五条需求,记录源列、目标字段和实际结果。
②重新打开导入向导,检查工作表和表头行是否选择正确。
③核对名称、描述、状态、优先级、负责人和原始编号的映射关系。
④进入需求类型配置,确认目标字段是文本、富文本、日期、用户还是选择列表。
⑤修正源文件中的无效选项、日期格式、账号名称和前后空格。
⑥删除错误的已保存映射,重新建立并命名后做小批量测试。
选择列表值无法与系统选项精确匹配时,导入后的字段可能为空;字段类型不同,也会造成日期、用户和富文本内容异常。
2、修正已经导入的错误数据
刚导入且尚未参与评审、关联和版本管理的数据,可以删除后重新导入。已经产生关系或历史记录的数据,更适合批量编辑或通过往返文件修正,避免删除后丢失追踪信息。
①筛选本次导入的数据,核对创建时间、导入位置和原始编号。
②确认没有评审、关系或其他业务记录后,再删除错误批次并重新导入。
③只需要统一修改选择列表、标签或普通字段时,选中记录后使用【Batch edit】。
④需要修改富文本或多个不同字段时,导出往返文件后统一修正。
⑤重新导入时启用更新已有工作项,避免再次创建重复需求。
⑥修正完成后抽查名称、描述、状态、负责人和层级关系。
批量编辑可用于同时修改部分字段和标签,但富文本等场景更适合采用Excel往返方式。
三、怎样减少需求批量导入后的返工
导入稳定性主要取决于模板是否统一、测试是否充分,以及是否保留原始标识。正式迁移前建立固定模板,比每次临时匹配字段更可靠。
1、建立导入验证流程
①为不同需求类型分别建立Excel模板,并固定表头和字段顺序。
②在模板中增加数据验证,限制状态、优先级等字段只能填写有效选项。
③每次先导入少量数据,检查字段、层级和目标位置。
④完整导入后对比源文件行数、系统新增数量和失败数量。
⑤按名称、原始编号和状态抽查关键需求,确认不存在错位和重复。
⑥批量更新前建立基线或导出备份,保留可恢复的数据版本。
总结
“Jama Connect怎么批量导入需求Jama Connect导入需求后字段映射错误如何调整”的重点,是区分新建导入与已有数据更新。导入前应统一工作项类型、表头、字段类型和选项值,导入时先做小批量预览,出现错误后再根据数据使用状态选择删除重导、批量编辑或往返更新。希望本文对大家开展需求迁移和字段调整有所帮助,如需进一步了解,可联系咨询。