Polarion可以把Excel里的需求、测试用例、缺陷等数据导入项目，并转换成对应的Work Item。已有需求表迁移到Polarion时，比较容易出问题的是字段对应关系，比如Excel里的“需求名称”被写进Description，优先级导入到错误枚举项，或者自定义字段整列为空。处理这类问题时，先把Excel表头、Work Item类型和目标字段整理清楚，再在导入向导里逐列确认映射，能省掉导入后批量返工。

　　一、Polarion怎么导入Excel需求数据

　　Polarion的Excel导入可以把每一行数据创建成Work Item，也可以把内容放入Document。正式导入前，可以先拿几条需求做一轮测试，确认字段和数据格式没有问题后再导入整张表。

　　1、整理Excel需求表

　　①打开准备导入的Excel文件。

　　②把第一行整理成字段名称，例如【ID】【Title】【Description】【Type】【Priority】【Status】。

　　③每条需求单独占一行，不要在同一个单元格里混放多条需求。

　　④准备导入为Requirement时，可以增加【Type】列，并填写当前Polarion项目中已经配置的需求类型。

　　⑤自定义字段也单独建立一列，表头使用容易识别的名称。

　　⑥枚举字段里的值要和Polarion现有选项对应，例如优先级、状态、严重等级等。

　　⑦删除纯装饰用的空行、合并单元格和无关说明区域。

　　⑧保存为【.xlsx】文件。

　　如果原Excel里用了“需求名称”“需求正文”这类自定义表头，也可以保留，后面在导入向导中手工映射到Polarion字段。

　　2、进入Excel导入向导

　　①登录Polarion并进入目标项目。

　　②打开准备接收需求的项目范围。

　　③执行【Import】并选择Excel工作簿导入。

　　④选择准备导入的【.xlsx】文件。

　　⑤进入【Import Excel Workbook】向导。

　　⑥选择数据所在的Worksheet。

　　⑦确认表头所在行和实际数据起始位置。

　　⑧选择导入到项目Tracker，或者导入到对应Document。

　　⑨进入字段映射页面。

　　Excel中的需求可以创建成普通Work Item，也可以放进Document。后面还要继续按文档章节维护需求时，导入Document会比较方便；只做条目管理时，可以直接进入项目Tracker。

　　3、逐列设置字段映射

　　①在映射页面找到Excel的【需求名称】列。

　　②把它映射到Polarion的【Title】。

　　③将需求正文列映射到【Description】。

　　④把需求类型映射到【Type】。

　　⑤把优先级列映射到【Priority】。

　　⑥Excel中有负责人时，把对应列映射到【Assignee】。

　　⑦项目配置了自定义字段时，在目标字段下拉列表中选择对应的Custom Field。

　　⑧没有准备导入的列，可以设为忽略，不要随便映射到相近字段。

　　⑨检查预览结果，确认几条样例需求的标题、描述和枚举值都正常。

　　⑩确认后执行【Import】。

　　二、Polarion导入Excel后字段映射错误如何调整

　　字段映射错误后，先判断数据有没有已经写入正式项目。还停留在预览阶段时可以直接改映射；已经创建Work Item后，则要看是少量字段错误，还是整批导入关系都配错了。

　　1、导入前在预览中修正映射

　　①停留在【Import Excel Workbook】映射页面。

　　②找到显示异常的Excel列。

　　③检查该列当前对应的Polarion字段。

　　④标题跑到正文里时，把映射从【Description】改回【Title】。

　　⑤枚举值进入普通文本字段时，重新选择正确的枚举字段。

　　⑥自定义字段为空时，确认目标Custom Field已经在当前Work Item类型中配置。

　　⑦检查预览区域的几行数据。

　　⑧确认字段已经对齐后再执行导入。

　　预览阶段发现问题时不要继续点完成。字段一旦写入大量Work Item，再回头处理会多出不少修改工作。

　　2、检查Type和自定义字段是否对应

　　同一项目可能同时存在Requirement、Test Case、Defect等多种Work Item类型，不同类型可用的自定义字段也可能不同。

　　①进入【Administration】→【Work Items】。

　　②查看当前项目配置的Work Item类型。

　　③确认Excel中的【Type】值能对应到目标类型。

　　④打开对应类型的【Custom Fields】配置。

　　⑤核对准备导入字段的名称和字段ID。

　　⑥回到Excel导入向导重新设置字段映射。

　　⑦枚举字段再检查Excel里的值是否属于Polarion已经定义的选项。

　　⑧多值枚举字段要按当前导入规则整理多个值，避免整格内容被当成一个普通字符串。

　　如果Requirement类型没有配置某个自定义字段，即使Excel里有同名列，也不能只靠列名自动生成正确字段关系。

　　3、已经导入错误数据怎么处理

　　①先在Work Item列表中筛选本次导入产生的数据。

　　②打开几条记录确认具体错在哪些字段。

　　③只有一两个字段错位时，可以使用批量编辑把对应字段修正。

　　④如果Title、Description、Type等多列都发生大范围错位，先停止继续导入。

　　⑤保留原Excel文件，重新整理字段和值。

　　⑥在测试项目或测试Document中重新执行一轮导入。

　　⑦确认新映射正确后，再处理正式项目中的错误数据。

　　不要在同一批错误记录上反复重新导入普通Excel文件，否则可能继续生成新的Work Item，使后面的清理更麻烦。

　　三、Excel数据调整后怎么确认导入结果

　　字段映射改好以后，可以从Work Item本身、枚举字段和Round-trip三个位置检查。这样既能确认本次导入结果，也能避免后面再次从Excel回传时覆盖错字段。

　　1、抽查导入后的需求

　　①打开导入后的Work Item列表。

　　②检查【Title】是否和Excel需求名称一致。

　　③打开【Description】，核对正文内容。

　　④查看【Type】【Priority】【Status】等枚举字段。

　　⑤检查负责人和自定义字段。

　　⑥有父子需求关系时，再确认层级关系有没有按预期建立。

　　⑦随机抽查几条长文本和特殊字符较多的需求。

　　2、区分普通Excel导入和Excel Round-trip

　　①如果Excel是从Polarion通过【Microsoft Excel】格式导出的Round-trip文件，不要按普通新数据重新做一套映射。

　　②保留文件中的Polarion识别信息。

　　③只修改允许编辑的字段。

　　④回到Polarion使用Excel Round-trip重新导入。

　　⑤检查锁定字段有没有保持原值。

　　⑥文件里增加了新的Work Item时，要在项目范围执行重新导入。

　　Round-trip文件里已经带有Polarion用来识别现有Work Item的信息，适合修改后回传；普通Excel导入更适合把外部已有需求第一次迁进项目。

　　总结

　　Polarion导入Excel需求时，表头设计、Work Item类型和字段映射要保持一致，枚举字段和自定义字段还要和项目当前配置对应。发现字段错位后，预览阶段可以直接调整映射，已经写入项目的数据则应先判断影响范围，再决定批量修正还是重新整理导入文件。用少量需求做一次验证，也能减少大批量导入后的返工。如需进一步了解Polarion Excel需求导入、Work Item字段映射与数据迁移排查方法，欢迎联系咨询。