把原来写在Excel、Word或者其他管理工具里的需求搬到Jama Connect的时候，不能简单地把文件往里一丢就觉得完成了。在正式开始导入之前，有几件事得先理清楚，比如需求的类型怎么划分、字段的名字要对齐、需求的层级关系是什么，还有那些从固定列表里选的枚举值，都得提前确认好，不然导进去以后很容易乱掉。Jama Connect里面数据的组织方式是以工作项作为基本单位的，需求、测试用例、文件夹这些东西，虽然外表看起来都待在项目里，但其实是不同的对象类型，不能一概而论。根据官方帮助资料里的说明，数据导入向导（Data Import Wizard）能够处理的文件类型包括doc、docx、xls、xlsx和csv等，而且它会根据你选的文件格式，自动显示出相关的导入选项，所以不用自己从头猜配置。

　　一、在Jama Connect里面怎样导入需求

　　如果是一口气要把成批的需求导进去，用Excel来整理数据会更顺手一些，因为它的结构本身就适合放这种一行一条记录、一列一个字段的表格；而Word呢，更适合那些需要保留标题层级和富文本样式的场合，比如一大段需求描述里带了各种加粗、颜色标记之类的。下面主要围绕Excel导入的方式来展开，这些操作步骤后面再碰到时也更容易重复使用，不用每次都重新摸索。

　　1、提前把Excel文件格式整理好

　　一个工作表里面只放一种需求类型，比如系统需求、软件需求还有接口需求，这三种不要挤在同一张Sheet里面，一定要分开来放，否则导入时类型就会串掉。表格的第一行要写上字段的名称，从第二行开始，每一行都对应着一条独立的需求，这样结构才是清晰的；官方帮助里也明确要求了一个工作表只能导入一种工作项类型（Item Type），如果一张表里塞了好几种，导入的时候就容易失败或者错位。

　　2、选好导入到的目标位置

　　进到对应的项目里面，在左边那一栏资源管理器树状结构的Explorer Tree中，先点中打算用来存放这些需求的Set或者Folder，让它变成选中状态，然后再去点击【Import】这个按钮；这样系统就知道，这批新导进去的需求，全都应该出现在当前选中的这个文件夹下面。跟着向导走下去，在文件这一步点击【Choose File】把刚才准备好的Excel文件选中，再去看一眼Destination显示的路径是不是自己想要的，这一步确认清楚了后面就不会出现需求跑错地方的情况。

　　3、把层级关系设置对

　　如果需求之间存在父子层级，比如一级需求下面挂着二级需求，二级需求可能又细分出子需求，那在Additional options那个页面里，就需要告诉系统你打算用什么方式来标记这些层级，常见的方式有靠缩进空格数来识别，或者靠给单元格标上不同的背景颜色来区分。在开始正式导入大批量数据之前，最好先拿一小段数据试跑一次，亲眼确认一级、二级还有子需求的关系没有乱套，然后再把全部内容都导进去，这样就能避免大量数据出错之后再来回返工。

　　二、Jama Connect里需求字段怎么完成映射

　　字段映射这个环节，直接决定了Excel表格里每一列的内容，最后会落到Jama Connect中的哪个属性上去；如果映射这一步把关系搭错了，需求虽然看起来都能顺顺利利地导进系统里面，但它的状态、优先级还有负责人这些信息，很可能就整个张冠李戴了，那批数据基本上就得重新来过。

　　1、首先把Name和必填字段映射好

　　在出现的【Choose Field Mappings for Import】这个页面里，要给Excel的每一列选好它对应的那个Jama Connect字段，其中Name这一项是被要求一定要映射的，不然没法往下走；另外，管理员给当前这个需求类型定义的必填字段，也一样得给它挂上对应的Excel列，因为系统在导入时会检查这些必填项是不是都有内容；至于那些不是必填的字段，暂时没有数据的话可以先空着，映射时不去管它也不要紧。

　　2、枚举值必须写得跟平台里完全一致

　　像优先级（Priority）、状态（Status）还有验证方法（Verification Method）这一类的字段，拿出来的值一般都是从系统里预设好的下拉列表（Pick List）中选的，所以Excel表格里面填进去的文字，必须跟Jama Connect里已经存在的选项完完全全一样，大小写、有没有多余的空格，以及拼写这几个地方都得逐一核对，哪怕多一个空格都可能被视为不相同。假如值对不上，导入的时候要么直接失败，要么导进去以后发现那个字段变成了空白，这就很可能漏掉重要信息。

　　3、日期字段要统一成一种格式

　　当Excel表格里包含了日期数据的时候，最好都按照系统要求的样式来统一，不要有的地方写“2025年3月1日”，有的地方又写成“3/1/2025”，再有的地方干脆只写一串数字，这样混在一起非常容易导致解析出错。官方帮助里给出的文本日期格式，是按照月、日、年、时、分、秒和时区偏移的顺序来的，编程里经常见到的那种格式，尽量不要再跟其他随意的写法混在一起使用，不然映射后的日期可能显示成乱码或者干脆识别不了。

　　4、把常用的映射方案保存起来方便复用

　　等到字段映射全都验证通过之后，可以顺手把当前的这一套Mapping方案保存下来，这种映射方案是按照项目来保存的，同一个项目里的其他同事也都能直接拿来用，不用再一条一条地重新选。以后如果还要往同一个项目里导入同类需求，就不需要从头再配置一遍映射关系了，直接从保存好的方案里调出来就行，这一点在经常维护需求的项目里能省下不少时间。

　　三、需求导入完成之后应该怎样进行检查

　　把数据全部导进去以后，不能只瞄一眼总的数量有没有少就算完事，还要去核对一下需求的层级结构是不是完整的、每个字段里的值有没有填错，以及将来如果要批量更新这些需求，应该用什么样的方式去做，才能避免下一轮操作时又重复创建出一大堆一模一样的需求来。

　　1、先看清楚预览的结果再正式提交

　　在导入向导最后正式提交之前，页面上会弹出一个预览界面（Preview），这个预览就是把导入后大概会变成什么样子先让你看一眼，所以一定要抓住这个机会，去抽查一下需求的名称对不对、描述内容有没有被截断、状态和优先级是不是预期的那些值，以及层级关系是不是还正常。等确认里面既没有错列、也没有空值或者乱码之后，再放心地去点击【Submit】完成这次导入，不要跳过预览这一步直接提交，因为有些问题在预览里就能很快看出来。

　　2、批量更新已有需求要走Round Trip流程

　　普通的Excel导入方式，更适合用来从零开始新增一大批需求，如果是一些已经存在于系统里的需求，现在想要批量地对它们做修改，就得换另一种方式，先从Jama Connect里面把【Excel Export for Roundtrip】这种专用的导出格式给下载下来，在导出的这份文件里进行修改，然后再重新用导入的功能把它传回去。系统会根据文件里一些隐藏的字段来识别哪些是原来就有的工作项，并且按照事先设定好的冲突规则来决定是覆盖还是跳过，这样就能批量更新而不会重复创建。

　　3、在做Round Trip操作之前先建一条基线

　　批量更新现有数据这件事，毕竟会直接改动很多已经存在的内容，所以在动手之前比较建议先建一条Baseline，也就是基线，万一中间的更新动作搞错了、把不该改的地方也给覆盖掉了，这条基线就可以作为回查和恢复的根据，不然改乱了之后再想手工一条条翻回去会非常费劲；官方帮助里也明确建议，在进行Round Trip导入之前要先把基线建好，这是防止误操作的一道很实用的保险。

　　总结

　　关于Jama Connect里面需求该怎么导入，以及导入时字段要如何映射，整个操作顺序可以大致概括成：先按照需求类型的不同，把Excel表格分Sheet整理清楚，再从Explorer Tree里进入【Import】，接着去完成文件的选择、字段的映射还有层级关系的设置这几个动作。在字段映射这一步，特别要留心Name和必填项有没有挂上、Pick List里枚举值的写法是不是完全对得上，以及日期字段的格式有没有统一。如果是新增需求，就直接用普通的导入流程来处理；如果是想批量更新那些已经存在的需求，就要走Round Trip的方式，并且一定要在操作之前把基线建好，这样整个过程既不会乱，出了偏差也有地方可以往回找。