把Excel中的需求转入Jama Connect，条目数量对得上，字段内容却未必正确。优先级进入了状态栏、描述少了一段，或者部分选项变成空白，都需要逐项核对。导入向导负责建立源列与目标字段的对应关系，校验则要同时检查原表、映射设置和导入后的需求，不能只看导入成功提示。

　　一、Jama Connect如何导入需求并映射字段

　　以下介绍Excel导入方式。新增需求与更新已有需求使用不同选项，准备文件时就应分清，避免把修订操作做成重复新增。

　　1、整理表头和需求数据

　　每个工作表放一种条目类型，每行对应一条需求。保留清楚的名称和描述，并给原有需求编号安排独立列，后续核对会方便一些。

　　①在Excel中整理【名称】、【描述】、【原需求编号】及其他业务字段，删除数据区域内重复插入的表头。

　　②检查【名称】列，补齐空白名称；将不同条目类型分别放入独立【工作表】。

　　③对照Jama Connect中的【选项列表】，统一状态、优先级等列的取值，保存文件。

　　2、选择位置并建立字段对应关系

　　①在项目树中选中目标【Set】或【Folder】，执行【Import】，在【Choose File】中选择Excel文件。

　　②核对【Destination】，点击【Next】，在【Excel Options】中选择工作表并填写表头行号。

　　③在【Field Mapping】中，为每个目标字段选择对应的源列，完成【Name】和其他必填字段的映射。

　　④新增导入时保持【Round trip/Update Options】未选中，点击【Next】。

　　映射应按字段含义逐项检查。例如原需求编号可以进入预先配置的来源编号字段，不应当作系统生成的条目ID使用。两个字段名称相近时，也要核对目标条目类型和字段用途。

　　3、通过预览检查后提交

　　预览适合检查名称、描述和选项是否落入预期位置。建议用少量具有代表性的数据试导入，包含长描述、不同优先级和空选填字段。

　　①在【Additional options】中核对层级处理方式，点击【Next】进入预览。

　　②对照原表检查【Name】、【Description】及其他映射结果，发现异常时返回修改。

　　③确认后点击【Submit】，核对【Final Import Summary】中的数量，再打开导入条目检查内容。

　　二、Jama Connect导入后字段值错位如何校验

　　遇到异常时，应保留原始文件和本次映射记录。整列内容互换、某些值为空和内容跟错需求，往往需要沿不同方向排查。

　　1、检查工作表与表头行

　　①重新打开【Import】向导，选择本次使用的文件，在【Excel Options】中核对工作表和表头行号。

　　②查看【Field Mapping】下拉框中的源列名称，对照Excel表头检查。

　　③若列名显示为说明文字或某条需求内容，修正【表头行号】，重新选择各字段的源列。

　　表头不一定在第一行。往返导出的文件默认通常使用第二行作为表头，不能沿用普通表格的行号。原表插入说明行后，旧映射也应重新核验。

　　2、区分列映射错误与原表行错位

　　如果整列状态都变成优先级，通常应检查列映射；如果只有几条需求的内容相互串行，还要查看原表是否在编辑时被打乱。

　　①按【原需求编号】找到异常记录，对照该行的【名称】、【描述】和其他字段。

　　②检查Excel是否曾仅对单列执行排序，核对相邻记录是否也出现对应关系错误。

　　③在【Field Mapping】中逐项核对异常字段，特别检查模板调整后新增、删除或改名的列。

　　3、核对字段类型和选项值

　　①打开异常需求的编辑界面，查看目标【状态】或【优先级】字段的可选值。

　　②对照源表对应单元格，检查拼写、空格及取值是否与【选项列表】一致。

　　③对日期和数值字段，检查源单元格的【实际内容】与【单元格格式】，修正后进行小批量验证。

　　选项列表中的值不匹配时，导入后可能显示为空，这与内容进入另一列不同。日期也不能只看Excel显示出来的样式，文本日期应按导入要求准备，避免把格式转换问题误判为字段错位。

　　4、从条目详情复查实际保存内容

　　①在项目树中打开异常【需求条目】，逐项检查字段值，核对条目类型和所在位置。

　　②用【原需求编号】匹配原表记录，抽查首尾条目、异常条目及包含长描述的条目。

　　列表列顺序与Excel列顺序不同，本身不代表数据错位。校验应围绕字段名称和需求身份进行。名称相同的条目，也不能只凭列表中的相邻位置配对。

　　三、Jama Connect怎样修正异常并避免重复导入

　　查清原因后，再决定修改已有条目还是重新导入。已有关系和评审记录的需求，修正时应尽量保留其身份。

　　1、用往返文件更新已有需求

　　①修正前保存相关需求的【基线】，选中待更新条目，点击【Export】→【View all export options】。

　　②选择【Excel Export for Roundtrip】，点击【Run】，在导出文件中修正目标字段，保留隐藏的识别信息。

　　③重新导入文件，启用【Update Items】，检查【Conflict Resolution】并重新核对字段映射。

　　往返更新需要使用Jama Connect生成的文件。普通Excel里补上一列编号，不能替代这套识别信息。选择Excel wins会影响冲突处理，应核对导出后线上是否又有人修改了需求。

　　2、检查修正范围并保存可复用映射

　　映射可以复用，但只适用于相应项目和匹配的表格结构。模板变化后，不能省略预览检查。

　　①提交修正前，在【预览】中核对更新对象、目标字段和内容，确认没有新增重复需求。

　　②完成后检查【导入汇总】，抽查更新条目，并保存对应【字段映射】和模板版本说明。

　　③检查长【描述字段】是否完整，核对原文与往返文件中的内容。

　　总结

　　需求导入完成后的校验，值得同时关注条目身份、字段含义和内容完整性。把来源编号保留下来，后续修订就有稳定的核对依据。字段映射模板也应随表格结构一起维护，不能只靠操作人员记忆。希望这些方法能帮助大家减少导入后的返工，如有相关需求，欢迎联系咨询。